Skip to main content
The Usage API lets you query your Sail usage from scripts, CLIs, or dashboards — the same data shown on the dashboard in app.sailresearch.com. It covers two families:
  • Billing & cost — spend, credit balance, burn rate, days remaining, spend breakdowns, per-model cost rankings, per-API-key usage, and token counters.
  • Operational activity & latency — request counts and time series, recent requests, task activity, and turn/trajectory latency distributions.

​
Base URL

https://api.sailresearch.com

​
Authentication

All requests require a Bearer API key in the Authorization header.
This is the same API key you use for the inference API at api.sailresearch.com. Create or manage keys from the Sail dashboard.
import requests

headers = {"Authorization": "Bearer YOUR_SAIL_API_KEY"}
params = {"bucket_size": "1h", "environment": "all"}
resp = requests.get(
    "https://api.sailresearch.com/v2/usage",
    headers=headers,
    params=params,
)
print(resp.json())

curl -s -H "Authorization: Bearer $SAIL_API_KEY" \
  "https://api.sailresearch.com/v2/usage?bucket_size=1h&environment=all" | jq

Endpoints

Full reference for every usage route — parameters, response shapes, error formats, and headers.
Usage data may have a slight delay and is not real-time. Billing-derived fields (spend, balance, per-API-key usage, token counters) are sourced from metered billing data and can lag the most recent minutes more than the operational activity and latency endpoints.
Monetary fields are fractional USD cents (floats), and token fields are raw token counts. See Endpoints for the exact units per field.