Get Credit Balance

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

opentrain credits show --json

{}

{
  "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
      }
    ]
  }
}

GET

api

public

credits

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

opentrain credits show --json

{}

{
  "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
      }
    ]
  }
}

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

object

Hide credits

number

Spendable balance in US cents.

number

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

string

Always usd.

object[]

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`)

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

opentrain credits show --json

{}

{
  "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
      }
    ]
  }
}

Poll Updates

List Credit Ledger

⌘I

Getting started

Connect your agent

Core concepts

Guides

API reference

CLI

MCP server

Annotation platforms

Response

Errors

​Response

​Errors

Response

Errors