Read tenant proxy traffic usage for the last 30 days

Returns measured proxy traffic and post-paid token debits for the authenticated tenant, grouped by the requested network type. A measurement-unavailable request is counted explicitly and is never represented as measured zero bytes. Provider and internal routing details are never part of this public response.

GET
/api/v1/data/usage

Returns measured proxy traffic and post-paid token debits for the authenticated tenant, grouped by the requested network type. A measurement-unavailable request is counted explicitly and is never represented as measured zero bytes. Provider and internal routing details are never part of this public response.

Authorization

headerX-API-Key<token>

Response Body

Tenant proxy traffic usage aggregate. Error body uses the documented PublicError DTO.

application/json
  1. response
period_start*string
Formatdate-time
period_end*string
Formatdate-time
period_days*integer
proxy_traffic*
curl -X GET 'https://api.runharvester.com/api/v1/data/usage' \  --header "X-API-Key: ${RUNHARVESTER_API_KEY:?Set your Data API key}"
{  "period_start": "2026-07-23T12:00:00.000Z",  "period_end": "2026-08-22T12:00:00.000Z",  "period_days": 30,  "proxy_traffic": {    "request_bytes": 1200,    "response_bytes": 58300,    "total_bytes": 59500,    "charged_tokens": 8,    "charged_jobs": 2,    "measurement_unavailable_jobs": 0,    "by_proxy_type": [      {        "proxy_type": "residential",        "request_bytes": 1200,        "response_bytes": 58300,        "total_bytes": 59500,        "charged_tokens": 8,        "charged_jobs": 2,        "measurement_unavailable_jobs": 0      }    ]  }}