Whitepages

Retrieve usage data for a specific time range

Retrieve API usage data for a specified date range. Returns daily usage statistics including request counts for each day within the specified time period. The response includes both individual daily usage data and total usage for the entire period. - The request count is total number of requests made including 2xx, 4xx and 5xx responses. It is not the same as billable requests which is not available right now as part of API. - Maximum date range allowed: 90 days - Dates are in UTC format - Current day data when requested will be updated during the day - Usage data is updated approximately every 30 minutes - Usage data is returned only from the first date of actual usage in the specified duration

GET
/v1/account/usage/

Query Parameters

start_date*string

Start date of the duration to get usage data for. Format: YYYY-MM-DD

Formatdate
Example"2025-09-12"
end_date*string

End date of the duration to get usage data for. Format: YYYY-MM-DD

Formatdate
Example"2025-09-12"

Header Parameters

X-Api-Key*string

API Key for Authentication

Example""

Response Body

application/json

application/json

application/json

application/json

application/json

curl -X GET "https://loading/v1/account/usage/?start_date=2025-09-12&end_date=2025-09-12" \  -H "X-Api-Key: "
{
  "time_range": {
    "start_date": "2019-08-24",
    "end_date": "2019-08-24"
  },
  "usage_data": [
    {
      "date": "2019-08-24",
      "request_count": 0
    }
  ],
  "total_requests_in_timeperiod": 0
}
{
  "error": {
    "code": 400,
    "message": "Bad Request",
    "long_message": "Invalid person ID format: 'sdf'. Person ID must start with 'P' followed by exactly 10 alphanumeric characters. Example: 'PABcd12345e' or 'P1234567890'.",
    "meta": null
  },
  "wp_trace_id": "3b0b537a60d84057817bb40563ca5c99"
}
{
  "message": "Forbidden"
}
{
  "error": {
    "code": 400,
    "message": "Short error message",
    "long_message": "The request was malformed",
    "meta": {
      "field": "email",
      "validation_error": "Invalid email format"
    }
  },
  "wp_trace_id": "550e8400-e29b-41d4-a716-446655440000"
}
{
  "error": {
    "code": 400,
    "message": "Short error message",
    "long_message": "The request was malformed",
    "meta": {
      "field": "email",
      "validation_error": "Invalid email format"
    }
  },
  "wp_trace_id": "550e8400-e29b-41d4-a716-446655440000"
}