Get Credits
Changed onGet the current credit balance of the account that pays for this credential's usage.
A Voyager sign-in in a workspace billed on Voyager reads the workspace's Voyager credits and plan (billing_product: "voyager"), its auto-reload (auto_reload) and its agent chat gate (chat); every other credential reads Moda's. upgrade_url is where that payer manages billing.
A balance that cannot be read answers 200 with plan: "unknown" and the payer's billing_product (unchanged for Moda clients, which always bill Moda). Only when the payer itself cannot be decided (a Voyager credential whose workspace switch is unreadable) is it a retryable 503 billing_unavailable: a Stripe blip is never read as "billed by Moda".
Request
- Base URLhttps://api.moda.app/v1
- URLhttps://api.moda.app/v1/credits
- AuthHTTP bearer
Headers
Calendar-dated API version pin. New integrations should pin 2026-05-01 to opt into the newest response shapes. For back-compat the server also accepts requests with no header and resolves them to the current default (today: 2026-04-12); that default advances on each sunset date. Any unsupported value returns 400 unsupported_version.
Response
Successful Response
Changes
- breaking
response property
planlist-of-types was widened by adding typesnullto media typeapplication/jsonof response200 - info
added the non-success response with the status
- info
added the optional property
to the response with the status - info
added the optional property
to the response with the status - info
added the optional property
to the response with the status - info
added the optional property
to the response with the status - info
added the optional property
to the response with the status - info
added the optional property
to the response with the status - info
added the optional property
to the response with the status - info
added the optional property
to the response with the status - info
added the optional property
to the response with the status - info
added the optional property
to the response with the status - info
added the optional property
to the response with the status - info
added the optional property
to the response with the status - info
added the optional property
to the response with the status - info
added the optional property
to the response with the status - info
added the optional property
to the response with the status - info
added the optional property
to the response with the status - info
added the optional property
to the response with the status - info
added the optional property
to the response with the status - info
added the optional property
to the response with the status - info
added the optional property
to the response with the status - info
added the optional property
to the response with the status - info
added the optional property
to the response with the status - info
added the optional property
to the response with the status - info
added the optional property
to the response with the status - info
added the optional property
to the response with the status - info
added the optional property
to the response with the status - info
added the optional property
to the response with the status - info
added the optional property
to the response with the status
- breaking