Usage - HASP

Returns the current billing cycle credit summary visible to the calling credential. The scope field says whose usage it is:

Credential	`scope`	What it covers
API key with `control:read`, or an agent credential with a `hasp.data.*` grant	`organization`	Your org’s totals.
Developer credential (`hasp login`)	`user`	Only the engineer the credential belongs to. No other member’s usage and no org total is returned.

Credit usage isn’t recorded per API key, so an API key always sees the org’s totals.

Get usage

GET https://api.usehasp.com/v1/usage
Authorization: Bearer hasp_api_live_...

Response

{
  "success": true,
  "data": {
    "object": "usage",
    "scope": "organization",
    "period": {
      "start": "2026-05-01T00:00:00+00:00",
      "end": null
    },
    "credits": {
      "allotment": 100000,
      "used": 37420,
      "remaining": 62580,
      "overage_purchased": 0,
      "overage_consumed": 0
    },
    "requests": {
      "total": 841
    }
  }
}

Fields

Field	Description
`scope`	`organization` or `user` (see above).
`period.start`	Start of the current billing cycle (ISO 8601).
`period.end`	End of the current billing cycle, or `null` if open-ended.
`credits.allotment`	`organization`: total credits available this cycle (base plan + any overages purchased). `user`: the engineer’s personal credit limit, or `null` if the org set none.
`credits.used`	Credits consumed so far this cycle. Sonnet-equivalent tokens: Haiku requests count as 0.3×, Opus as 1.7×.
`credits.remaining`	`organization`: `allotment - used`; requests fail with `402 AI_CREDITS_EXHAUSTED` when this reaches zero. `user`: what’s left of the personal limit, or `null` if the org set none.
`credits.overage_purchased`	Additional credits purchased outside the plan allotment.
`credits.overage_consumed`	Overage credits consumed.
`requests.total`	Total AI requests made this cycle.

Credit accounting

Credits are denominated in Sonnet-equivalent tokens. The model rate-ratios are:

Model	Rate-ratio
`claude-haiku-4-5`	0.3×
`claude-sonnet-4-6`	1.0×
`claude-opus-4-7`	1.7×

A 100-token Haiku response consumes ~30 credits; a 100-token Opus response consumes ~170 credits. On the native streaming surface, the credits_consumed field of the run.completed event shows the credit impact of that specific request; aggregate consumption is available from this endpoint.

Error codes

Code	HTTP	Description
`INVALID_API_KEY`	401	Invalid or revoked token
`MISSING_SCOPE`	403	API key lacks the `control:read` scope, or agent credential lacks a `hasp.data.*` grant