List Pending Payments

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

opentrain payments pending --json

{}

{
  "payments": [
    {
      "id": "<INVOICE_ID>",
      "status": "PENDING_FUNDING",
      "invoiceKind": "FUNDING",
      "viewerRole": "EMPLOYER",
      "amountUsd": 300,
      "createdAt": "2026-06-12T10:05:00.000Z",
      "invoiceNumber": 1042,
      "job": {
        "id": "<JOB_ID>",
        "title": "Spanish tweet sentiment labeling"
      },
      "milestone": {
        "id": "<MILESTONE_ID>",
        "name": "First labeling batch"
      }
    }
  ]
}

GET

api

public

payments

pending

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

opentrain payments pending --json

{}

{
  "payments": [
    {
      "id": "<INVOICE_ID>",
      "status": "PENDING_FUNDING",
      "invoiceKind": "FUNDING",
      "viewerRole": "EMPLOYER",
      "amountUsd": 300,
      "createdAt": "2026-06-12T10:05:00.000Z",
      "invoiceNumber": 1042,
      "job": {
        "id": "<JOB_ID>",
        "title": "Spanish tweet sentiment labeling"
      },
      "milestone": {
        "id": "<MILESTONE_ID>",
        "name": "First labeling batch"
      }
    }
  ]
}

Lists incomplete invoices visible to your account, newest first. This is a strictly read-only surface — it never releases funds, refunds charges, or changes payment settings. Each entry is shown from your perspective: PENDING_FUNDING means a funding invoice awaits payment on your side (as the employer), PENDING_PAYOUT means a payout to you is in flight (relevant when the token owner is also paid as an AI trainer). Use GET /approvals/{id} and GET /updates to track the co-sign approvals that resolve funding items. Requirements: payments:read scope. Works pre-claim. No parameters.

Response

object[]

Show pending payment entry

string

Invoice ID.

string

PENDING_FUNDING (you owe an escrow payment) or PENDING_PAYOUT (a payout to you is in flight).

string

FUNDING or PAYOUT.

string

Your role on the invoice: EMPLOYER, FREELANCER, or BOTH.

number | null

Invoice amount in USD.

string

ISO creation timestamp.

number | null

Sequential invoice number.

object

{id, title} of the linked job (null fields when not job-linked).

object

{id, name} of the linked milestone (null fields when not milestone-linked).

Errors

Status	`code`	Meaning
`401`	`UNAUTHORIZED`	Missing or invalid token
`403`	`FORBIDDEN`	Missing `payments:read` scope

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

opentrain payments pending --json

{}

{
  "payments": [
    {
      "id": "<INVOICE_ID>",
      "status": "PENDING_FUNDING",
      "invoiceKind": "FUNDING",
      "viewerRole": "EMPLOYER",
      "amountUsd": 300,
      "createdAt": "2026-06-12T10:05:00.000Z",
      "invoiceNumber": 1042,
      "job": {
        "id": "<JOB_ID>",
        "title": "Spanish tweet sentiment labeling"
      },
      "milestone": {
        "id": "<MILESTONE_ID>",
        "name": "First labeling batch"
      }
    }
  ]
}

Get Credit Top-Up

List Webhooks

⌘I

Getting started

Connect your agent

Core concepts

Guides

API reference

CLI

MCP server

Annotation platforms

Response

Errors

​Response

​Errors

Response

Errors