Skip to main content
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 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.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")