API Reference

Account

Key-health and plan-metadata endpoints. Useful for deploy-time smoke tests and for building your own pricing UI.

GET/developer/v1/ping

Validates the API key and returns the current tier plus remaining quota. Cheap — safe to call before each batch of requests.

json

{
  "ok": true,
  "tier": "starter",
  "key_name": "prod-etl",
  "quota_remaining": {
    "minute": 58,
    "day": 9842
  },
  "reset_at": {
    "minute": "2026-04-20T14:31:00Z",
    "day": "2026-04-21T00:00:00Z"
  }
}

GET/developer/v1/plans

Public listing of tiers and their limits. No auth required — useful for rendering your own pricing page or an in-app tier picker.

json

{
  "plans": [
    {
      "id": "trial",
      "name": "Trial",
      "price_usd_month": 0,
      "rate_per_minute": 10,
      "rate_per_day": 1000,
      "history_days": 7,
      "state_level": false,
      "forecasts": false
    },
    {
      "id": "starter",
      "name": "Starter",
      "price_usd_month": 199,
      "rate_per_minute": 60,
      "rate_per_day": 10000,
      "history_days": 90,
      "state_level": false,
      "forecasts": false
    }
  ]
}