Usage
curl --request GET \
--url https://api.orthogonal.com/v1/credits/usage \
--header 'Authorization: Bearer <token>'const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.orthogonal.com/v1/credits/usage', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://api.orthogonal.com/v1/credits/usage"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)Credits API
Usage
View your API usage history
GET
/
v1
/
credits
/
usage
Usage
curl --request GET \
--url https://api.orthogonal.com/v1/credits/usage \
--header 'Authorization: Bearer <token>'const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.orthogonal.com/v1/credits/usage', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://api.orthogonal.com/v1/credits/usage"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)Returns your API usage history with per-call cost breakdowns and a spend summary.
Authentication
Requires a valid API key viaAuthorization: Bearer YOUR_API_KEY.
Query Parameters
number
default:"50"
Maximum number of usage events to return.
number
default:"0"
Offset for pagination.
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
| 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'
# Default: last 30 days
orth usage
# Last 7 days, 10 results
orth usage --days 7 --limit 10
const response = await fetch('https://api.orthogonal.com/v1/credits/usage?days=7', {
headers: {
'Authorization': `Bearer ${process.env.ORTHOGONAL_API_KEY}`
}
});
const { usage, totalSpent } = await response.json();
console.log(`Total spent: ${totalSpent}`);
console.log(`API calls: ${usage.length}`);
import requests
import os
response = requests.get(
'https://api.orthogonal.com/v1/credits/usage',
headers={'Authorization': f'Bearer {os.environ["ORTHOGONAL_API_KEY"]}'},
params={'days': 7, 'limit': 20}
)
data = response.json()
print(f"Spent {data['totalSpent']} across {data['pagination']['total']} calls")
⌘I