Usage

Usage endpoints return spend data tracked by the platform. All endpoints require authentication.

Get usage summary

GET /api/usage

Returns aggregated usage across all your keys.

Query parameters

Parameter	Type	Description
startDate	string	Start date (ISO 8601, e.g. 2026-01-01)
endDate	string	End date (ISO 8601)

Example

curl "https://api.cheapestinference.com/api/usage?startDate=2026-01-01&endDate=2026-02-01" \
  -H "Authorization: Bearer YOUR_AUTH_TOKEN"

---

Get usage per key

GET /api/usage/:keyId

Returns usage data for a specific key.

Example

curl https://api.cheapestinference.com/api/usage/clx1abc... \
  -H "Authorization: Bearer YOUR_AUTH_TOKEN"

---

Plans (public)

GET /api/plans

Returns all available plans with rate limits and pricing. No authentication required.

Example

curl https://api.cheapestinference.com/api/plans

Response

[
  {
    "slug": "standard",
    "name": "Standard",
    "priceUsdc": "20",
    "rateLimits": {
      "tpm_limit": 3333,
      "rpm_limit": 60
    }
  },
  {
    "slug": "pro",
    "name": "Pro",
    "priceUsdc": "60",
    "rateLimits": {
      "tpm_limit": 13333,
      "rpm_limit": 200
    }
  }
]