List Credit Ledger - OpenTrain AI

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

opentrain credits ledger --limit 25 --json

{
  "limit": 25
}

{
  "entries": [
    {
      "id": "<ENTRY_ID>",
      "type": "TOP_UP",
      "amountCents": 10000,
      "createdAt": "2026-06-12T10:00:00.000Z",
      "holdEntryId": null,
      "jobofferId": null,
      "contractId": null,
      "milestoneId": null,
      "topUpId": "<TOP_UP_ID>",
      "note": null
    },
    {
      "id": "<ENTRY_ID_2>",
      "type": "HOLD",
      "amountCents": -2500,
      "createdAt": "2026-06-11T15:30:00.000Z",
      "holdEntryId": null,
      "jobofferId": "<PROPOSAL_ID>",
      "contractId": "<CONTRACT_ID>",
      "milestoneId": "<MILESTONE_ID>",
      "topUpId": null,
      "note": null
    }
  ],
  "nextCursor": "<CURSOR>"
}

GET

api

public

credits

ledger

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

opentrain credits ledger --limit 25 --json

{
  "limit": 25
}

{
  "entries": [
    {
      "id": "<ENTRY_ID>",
      "type": "TOP_UP",
      "amountCents": 10000,
      "createdAt": "2026-06-12T10:00:00.000Z",
      "holdEntryId": null,
      "jobofferId": null,
      "contractId": null,
      "milestoneId": null,
      "topUpId": "<TOP_UP_ID>",
      "note": null
    },
    {
      "id": "<ENTRY_ID_2>",
      "type": "HOLD",
      "amountCents": -2500,
      "createdAt": "2026-06-11T15:30:00.000Z",
      "holdEntryId": null,
      "jobofferId": "<PROPOSAL_ID>",
      "contractId": "<CONTRACT_ID>",
      "milestoneId": "<MILESTONE_ID>",
      "topUpId": null,
      "note": null
    }
  ],
  "nextCursor": "<CURSOR>"
}

Lists every credit ledger entry on your account, newest first, with cursor pagination. Each entry links the related top-up, proposal, contract, or milestone so you can reconcile balance changes against the actions that caused them. amountCents is signed: positive entries add to the available balance, negative entries draw from it. Accounts that have never used credits get an empty page (not a 404). Requirements: payments:read scope + the public_api_credits feature. Works pre-claim.

Entry types

`type`	Meaning
`TOP_UP`	A completed top-up added funds
`HOLD`	Funds reserved into escrow (hire or milestone funding)
`HOLD_RELEASE`	A hold returned to the available balance (e.g. milestone cancelled)
`CAPTURE`	Held funds paid out (milestone released)
`REFUND`	Funds returned to the account
`ADJUSTMENT`	Manual correction by OpenTrain

Request

cursor

string

Opaque cursor from a previous response’s nextCursor. Omit for the first page.

limit

integer

default:"50"

Page size, 1–100. Out-of-range values return 400.

Response

entries

object[]

Show ledger entry

string

Ledger entry ID.

type

string

One of the entry types above.

amountCents

number

Signed amount in US cents.

createdAt

string

ISO timestamp.

holdEntryId

string | null

For HOLD_RELEASE/CAPTURE, the originating HOLD entry.

jobofferId

string | null

Related proposal, when the entry came from a hire.

contractId

string | null

Related contract.

milestoneId

string | null

Related milestone.

topUpId

string | null

Related top-up, for TOP_UP entries.

note

string | null

Free-text note (mostly on ADJUSTMENT entries).

nextCursor

string | null

Pass as cursor to fetch older entries; null at the end of the ledger.

Errors

Status	`code`	Meaning
`400`	`BAD_REQUEST`	`limit` outside 1–100 (`details: {field: "limit"}`)
`401`	`UNAUTHORIZED`	Missing or invalid token
`403`	`FORBIDDEN`	Missing `payments:read` scope, or `public_api_credits` disabled

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

opentrain credits ledger --limit 25 --json

{
  "limit": 25
}

{
  "entries": [
    {
      "id": "<ENTRY_ID>",
      "type": "TOP_UP",
      "amountCents": 10000,
      "createdAt": "2026-06-12T10:00:00.000Z",
      "holdEntryId": null,
      "jobofferId": null,
      "contractId": null,
      "milestoneId": null,
      "topUpId": "<TOP_UP_ID>",
      "note": null
    },
    {
      "id": "<ENTRY_ID_2>",
      "type": "HOLD",
      "amountCents": -2500,
      "createdAt": "2026-06-11T15:30:00.000Z",
      "holdEntryId": null,
      "jobofferId": "<PROPOSAL_ID>",
      "contractId": "<CONTRACT_ID>",
      "milestoneId": "<MILESTONE_ID>",
      "topUpId": null,
      "note": null
    }
  ],
  "nextCursor": "<CURSOR>"
}

Get Credit Balance

Create Credit Top-Up

⌘I

​Entry types

​Request

​Response

​Errors

Entry types

Request

Response

Errors