Credits API
Usage
View your API usage history
GET
https://www.orthogonal.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
limitnumberdefault:
50Maximum number of usage events to return.
offsetnumberdefault:
0Offset for pagination.
daysnumberdefault:
30Number 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": "/v2/domain-search",
"method": "GET",
"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
| Field | Type | Description |
|---|---|---|
usage | array | List of API call events |
usage[].api | string | API slug |
usage[].path | string | Endpoint path called |
usage[].method | string | HTTP method |
usage[].timestamp | string | ISO 8601 timestamp |
usage[].cost | string | Cost in dollars |
usage[].status | string | Call status (completed, failed, etc.) |
totalSpent | string | Total spend in dollars |
pagination.total | number | Total number of events in the time range |
Example
# Last 7 days of usage
curl 'https://api.orthogonal.com/v1/credits/usage?days=7&limit=20' \
-H 'Authorization: Bearer YOUR_API_KEY'