Skip to main content
GET
/
v1
/
credits
/
usage
Usage
curl --request GET \
  --url https://api.example.com/v1/credits/usage
Returns your API usage history with per-call cost breakdowns and a spend summary.

​
Authentication

Requires a valid API key via Authorization: Bearer YOUR_API_KEY.

​
Query Parameters

​
limit
number
default:"50"
Maximum number of usage events to return.
​
offset
number
default:"0"
Offset for pagination.
​
days
number
default:"30"
Number of days to look back.

​
Response

{
  "usage": [
    {
      "api": "apollo",
      "path": "/v1/people/match",
      "method": "POST",
      "timestamp": "2026-02-27T10:30:00Z",
      "cost": "$0.03",
      "status": "completed"
    },
    {
      "api": "hunter",
      "path": "/domain-search",
      "method": "POST",
      "timestamp": "2026-02-27T09:15:00Z",
      "cost": "$0.01",
      "status": "completed"
    }
  ],
  "totalSpent": "$0.04",
  "pagination": {
    "limit": 50,
    "offset": 0,
    "count": 2,
    "total": 2
  }
}

​
Response Fields

FieldTypeDescription
usagearrayList of API call events
usage[].apistringAPI slug
usage[].pathstringEndpoint path called
usage[].methodstringHTTP method
usage[].timestampstringISO 8601 timestamp
usage[].coststringCost in dollars
usage[].statusstringCall status (completed, failed, etc.)
totalSpentstringTotal spend in dollars
pagination.totalnumberTotal number of events in the time range

​
Example

# Last 7 days of usage
curl 'https://api.orth.sh/v1/credits/usage?days=7&limit=20' \
  -H 'Authorization: Bearer YOUR_API_KEY'