Get Credit Top-Up - OpenTrain AI

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

opentrain credits top-up-status --top-up-id <TOP_UP_ID> --json

{
  "topUpId": "<TOP_UP_ID>"
}

{
  "topUp": {
    "id": "<TOP_UP_ID>",
    "status": "COMPLETED",
    "amountCents": 10000,
    "createdAt": "2026-06-12T10:00:00.000Z",
    "completedAt": "2026-06-12T10:12:00.000Z",
    "expiresAt": "2026-06-13T10:00:00.000Z"
  }
}

{
  "topUp": {
    "id": "<TOP_UP_ID>",
    "status": "PENDING",
    "amountCents": 10000,
    "createdAt": "2026-06-12T10:00:00.000Z",
    "completedAt": null,
    "expiresAt": "2026-06-13T10:00:00.000Z"
  }
}

GET

api

public

credits

top-ups

{topUpId}

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

opentrain credits top-up-status --top-up-id <TOP_UP_ID> --json

{
  "topUpId": "<TOP_UP_ID>"
}

{
  "topUp": {
    "id": "<TOP_UP_ID>",
    "status": "COMPLETED",
    "amountCents": 10000,
    "createdAt": "2026-06-12T10:00:00.000Z",
    "completedAt": "2026-06-12T10:12:00.000Z",
    "expiresAt": "2026-06-13T10:00:00.000Z"
  }
}

{
  "topUp": {
    "id": "<TOP_UP_ID>",
    "status": "PENDING",
    "amountCents": 10000,
    "createdAt": "2026-06-12T10:00:00.000Z",
    "completedAt": null,
    "expiresAt": "2026-06-13T10:00:00.000Z"
  }
}

Reads one top-up. Poll it after handing the checkoutUrl to your human: PENDING means the checkout link has not been paid yet, COMPLETED means the credits are available (confirm with GET /credits). A PENDING top-up past its expiresAt flips to EXPIRED the next time it is read — expired links cannot be paid; create a new top-up instead. Top-ups belonging to another account return 404. Requirements: payments:read scope + the public_api_credits feature. Works pre-claim.

Request

topUpId

string

required

The top-up ID returned when the top-up was created.

Response

topUp

object

Hide top-up

string

Top-up ID.

status

string

PENDING, COMPLETED, EXPIRED, or CANCELED.

amountCents

number

Requested amount in US cents.

createdAt

string

ISO creation timestamp.

completedAt

string | null

ISO timestamp when payment settled; null unless COMPLETED.

expiresAt

string | null

ISO timestamp when the unpaid checkout link lapses.

Errors

Status	`code`	Meaning
`401`	`UNAUTHORIZED`	Missing or invalid token
`403`	`FORBIDDEN`	Missing `payments:read` scope, or `public_api_credits` disabled
`404`	`NOT_FOUND`	No such top-up, or it belongs to another account (`details: {resource: "credit-top-ups", topUpId}`)

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

opentrain credits top-up-status --top-up-id <TOP_UP_ID> --json

{
  "topUpId": "<TOP_UP_ID>"
}

{
  "topUp": {
    "id": "<TOP_UP_ID>",
    "status": "COMPLETED",
    "amountCents": 10000,
    "createdAt": "2026-06-12T10:00:00.000Z",
    "completedAt": "2026-06-12T10:12:00.000Z",
    "expiresAt": "2026-06-13T10:00:00.000Z"
  }
}

{
  "topUp": {
    "id": "<TOP_UP_ID>",
    "status": "PENDING",
    "amountCents": 10000,
    "createdAt": "2026-06-12T10:00:00.000Z",
    "completedAt": null,
    "expiresAt": "2026-06-13T10:00:00.000Z"
  }
}

Create Credit Top-Up

List Pending Payments

⌘I

​Request

​Response

​Errors

Request

Response

Errors