Skip to main content
GET
/
v1.4
/
Data
/
Usage
Usage Statistics
curl --request GET \
  --url https://dataapi.dncscrub.com/v1.4/Data/Usage \
  --header 'loginId: <loginid>'
[
  {
    "Status": "Y",
    "Request": 8038
  },
  {
    "Status": "L",
    "Request": 1242
  },
  {
    "Status": "U",
    "Request": 4389
  },
  {
    "Status": "YX",
    "Request": 2703
  },
  {
    "Status": "YP",
    "Request": 3696
  },
  {
    "Status": "N",
    "Request": 940
  },
  {
    "Status": "",
    "Request": 23
  },
  {
    "Status": "V",
    "Request": 3
  },
  {
    "Status": "YP*",
    "Request": 1
  }
]

​
Request

​
Headers

​
loginId
string
required
Your API Key (LoginId from your DNCScrub account)

​
Query Parameters

​
type
string
required
The type of usage to retrieve: verification or ResOrBusiness
​
startDate
string
required
Start date in YYYYMMDD format
​
endDate
string
required
End date in YYYYMMDD format

​
Output parameters

FieldDescription
StatusThe status or category of the usage record
RequestThe count of requests for this status

​
Status values

When type is verification, the Status field contains the verification category (CategoryPhoneMatch). When type is ResOrBusiness, the Status field contains the record type:
ValueDescription
RResidential
BBusiness
UUnknown. The record type was not able to be determined.

​
Example Request #1 (Verification)

curl --location --request GET \
  'https://dataapi.dncscrub.com/v1.4/Data/Usage
    ?startDate=20260101
    &endDate=20260131
    &type=verification' \
  --header 'loginId: YOUR_API_KEY'

​
Example Request #2 (ResOrBusiness)

curl --location --request GET \
  'https://dataapi.dncscrub.com/v1.4/Data/Usage
    ?startDate=20260101
    &endDate=20260131
    &type=ResOrBusiness' \
  --header 'loginId: YOUR_API_KEY'

[
  {
    "Status": "Y",
    "Request": 8038
  },
  {
    "Status": "L",
    "Request": 1242
  },
  {
    "Status": "U",
    "Request": 4389
  },
  {
    "Status": "YX",
    "Request": 2703
  },
  {
    "Status": "YP",
    "Request": 3696
  },
  {
    "Status": "N",
    "Request": 940
  },
  {
    "Status": "",
    "Request": 23
  },
  {
    "Status": "V",
    "Request": 3
  },
  {
    "Status": "YP*",
    "Request": 1
  }
]