CCC API v8.4.0.0

<back to all web services

GetResellerServiceUserCountReport

The following routes are available for this service:
GET/api/resellers/{ResellerGuid}/serviceusercountreportGets a Resellers ServiceUserCount Report.
GetResellerServiceUserCountReport Parameters:
NameParameterData TypeRequiredDescription
ResellerGuidpathGuidYesThe Guid of the Reseller
StartPeriodqueryDateTimeYesThe start period of the Report. Only the Year/Month are currently used and any Day or Time values will be ignored.
EndPeriodqueryDateTimeNoThe end period of the Report. Only the Year/Month are currently used and any Day or Time values will be ignored. EndPeriod defaults to todays UTC date if left null.
PagequeryIntegerNoThe Page number being requested. Defaults to 1.
PageSizequeryIntegerNoThe Page Size returned by the operation. Defaults to 25.
GetServiceUserCountReportPagedResponse Parameters:
NameParameterData TypeRequiredDescription
StartPeriodbodyDateTimeNo
EndPeriodbodyDateTimeNo
TotalPeriodProUserCountsbodyPeriodStat[]No
TotalPeriodGuestUserCountsbodyPeriodStat[]No
PageSizebodyIntegerNo
TotalPagesbodyIntegerNo
TotalItemsbodyIntegerNo
CurrentPagebodyIntegerNo
ResultsbodyPeriodServiceUserCountRecord[]No
BaseResponse Parameters:
NameParameterData TypeRequiredDescription
ResponseStatusformResponseStatusNo
PeriodStat Parameters:
NameParameterData TypeRequiredDescription
sPeriodbodyDateTimeNo
TotalbodyIntegerNo
PercentageChangedbodyDoubleNo
PeriodServiceUserCountRecord Parameters:
NameParameterData TypeRequiredDescription
ServiceGuidbodyGuidNo
ServiceCodeformstringNo
ServiceStatusformServiceStatusNo

Allowable Values

  • Blocked
  • AccountCancelled
  • AccountSuspended
  • Provisioning
  • TrialExpired
  • TrialActive
  • DemoAccount
  • CertifiedSecure
CreatedOnbodyDateTimeNo
TrialEndDatebodyDateTimeNo
ReferenceIdformstringNo
CollectionNameformstringNo
ResellerNameformstringNo
CompanyNameformstringNo
CompanyCityformstringNo
CompanyPostalCodeformstringNo
PrimaryDomainformstringNo
ProUserStatsbodyPeriodStat[]No
GuestUserStatsbodyPeriodStat[]No

To override the Content-type in your clients, use the HTTP Accept Header, append the .json suffix or ?format=json

To embed the response in a jsonp callback, append ?callback=myCallback

HTTP + JSON

The following are sample HTTP requests and responses. The placeholders shown need to be replaced with actual values.

GET /api/resellers/{ResellerGuid}/serviceusercountreport HTTP/1.1 
Host: api.secure-messaging.com 
Accept: application/json
HTTP/1.1 200 OK
Content-Type: application/json
Content-Length: length

{
  "startPeriod": "0001-01-01T00:00:00Z",
  "endPeriod": "0001-01-01T00:00:00Z",
  "totalPeriodProUserCounts": [
    {
      "period": "0001-01-01",
      "total": 0,
      "pctChg": 0
    }
  ],
  "totalPeriodGuestUserCounts": [
    {
      "period": "0001-01-01",
      "total": 0,
      "pctChg": 0
    }
  ],
  "pageSize": 0,
  "totalPages": 0,
  "totalItems": 0,
  "currentPage": 0,
  "results": [
    {
      "serviceGuid": "00000000000000000000000000000000",
      "serviceCode": "String",
      "serviceStatus": "Blocked",
      "createdOn": "0001-01-01T00:00:00Z",
      "trialEndDate": "0001-01-01T00:00:00Z",
      "referenceId": "String",
      "collectionName": "String",
      "resellerName": "String",
      "companyName": "String",
      "companyCity": "String",
      "companyPostalCode": "String",
      "primaryDomain": "String",
      "proUserStats": [
        {
          "period": "0001-01-01",
          "total": 0,
          "pctChg": 0
        }
      ],
      "guestUserStats": [
        {
          "period": "0001-01-01",
          "total": 0,
          "pctChg": 0
        }
      ]
    }
  ],
  "responseStatus": {
    "errorCode": "String",
    "message": "String",
    "stackTrace": "String",
    "errors": [
      {
        "errorCode": "String",
        "fieldName": "String",
        "message": "String",
        "meta": {
          "String": "String"
        }
      }
    ],
    "meta": {
      "String": "String"
    }
  }
}