Get usage

GET/v1/usage

Returns how much of the plan's allowance is in use right now. flows_used is counted across every site on the account (the same counter that enforces the plan cap), so it always agrees with what the API will let you create.

Response fields

flows_used

integer

Flows currently in use, counted across every site on the account.

flows_limit

integer

Flows allowed on the current plan. -1 means unlimited.

conversions_used

integer | null

Conversions used this period. null when not yet metered.

conversions_limit

integer

Conversions allowed this period. -1 means unlimited.

period_start

timestamp | null

Start of the current usage window.

period_end

timestamp | null

End of the current usage window.

GET/v1/usage

curl https://app.converly.io/api/v1/usage \
  -H "Authorization: Bearer sk_live_…"

200 OK

{
  "flows_used": 1,
  "flows_limit": 1,
  "conversions_used": 42,
  "conversions_limit": 100,
  "period_start": "2026-06-06T21:35:41.000Z",
  "period_end": "2026-07-06T21:35:41.000Z"
}