Get Credit Balance

Reads the credits overview for your account. Credits are a prepaid balance that funds hires and milestone escrow without a card-present step — every money move still requires human co-sign; credits only change where the money comes from.

Accounts that have never used credits get an all-zero response (not a 404). For full transaction history, page through GET /credits/ledger; to add funds, create a top-up. Tokens belonging to organization members read the org owner’s credit account.

Requirements: payments:read scope + the public_api_credits feature. Works pre-claim. No parameters.

Response

creditsobject

credits

availableCentsnumber

Spendable balance in US cents.

reservedCentsnumber

Cents currently held in escrow for funded milestones (not spendable).

currencystring

Always usd.

recentEntriesobject[]

The 10 most recent ledger entries, newest first — same shape as GET /credits/ledger entries.

Errors

Status	code	Meaning
401	UNAUTHORIZED	Missing or invalid token
403	FORBIDDEN	Missing payments:read scope, or public_api_credits disabled for the account (details.featureKey)

Request examples

curlCLIMCP: opentrain_get_credits

curl

curl -sS https://app.opentrain.ai/api/public/v1/credits \
  -H "Authorization: Bearer $OT_API_TOKEN"

CLI

opentrain credits show --json

MCP: opentrain_get_credits

{}

Response examples

200

{
  "credits": {
    "availableCents": 5000,
    "reservedCents": 2500,
    "currency": "usd",
    "recentEntries": [
      {
        "id": "<ENTRY_ID>",
        "type": "HOLD",
        "amountCents": -2500,
        "createdAt": "2026-06-12T10:00:00.000Z",
        "holdEntryId": null,
        "jobofferId": "<PROPOSAL_ID>",
        "contractId": "<CONTRACT_ID>",
        "milestoneId": "<MILESTONE_ID>",
        "topUpId": null,
        "note": null
      }
    ]
  }
}