List Pending Payments

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

paymentsobject[]

pending payment entry

idstring

Invoice ID.

statusstring

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

invoiceKindstring

FUNDING or PAYOUT.

viewerRolestring

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

amountUsdnumber | null

Invoice amount in USD.

createdAtstring

ISO creation timestamp.

invoiceNumbernumber | null

Sequential invoice number.

jobobject

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

milestoneobject

{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

Request examples

curlCLIMCP: opentrain_list_pending_payments

curl

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

CLI

opentrain payments pending --json

MCP: opentrain_list_pending_payments

{}

Response examples

200

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