billing

Credit balance and transaction history

Agent-facing billing truth (PRI-480 A-5): remaining balance in billable seconds plus a paginated ledger. Check this before submitting work to avoid a 402. Requires the billing:read scope.

get/v1/credits

Request

  • Base URL: https://api.primateintelligence.ai
  • URL: https://api.primateintelligence.ai/v1/credits
  • Auth: HTTP bearer

Query parameters

limitinteger

Transactions per page (1–100, default 20).

Example:20
beforestring

Cursor — return transactions older than this id.

Response

Balance plus one page of ledger entries.

object'credits' required
balance_secondsnumber required

The authoritative credit balance (legacy field name retained for backward compatibility).

grant_secondsnumber nullable required

Original signup grant, when one exists.

used_secondsnumber nullable required

Consumed against the signup grant (grant minus balance).

has_moreboolean required

Example response

{
  "transactions": [
    {
      "kind": "signup_grant"
    }
  ]
}

Changes

No recorded changes to this operation across all 1 revision of this API.