CCC API v8.4.0.0

<back to all web services

GetPartnerServiceUserCountReport

The following routes are available for this service:
GET/api/partners/{PartnerGuid}/serviceusercountreportGets a Partners ServiceUserCount Report.
GetPartnerServiceUserCountReport Parameters:
NameParameterData TypeRequiredDescription
PartnerGuidpathGuidYesThe Guid of the Partner
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.
PageSizequeryStringNoThe 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/partners/{PartnerGuid}/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"
    }
  }
}