Get Approval

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

opentrain approvals get --approval-id <APPROVAL_ID> --json

{
  "approvalId": "<APPROVAL_ID>"
}

{
  "approval": {
    "id": "<APPROVAL_ID>",
    "type": "milestone_fund",
    "status": "confirmed",
    "contractId": "<CONTRACT_ID>",
    "milestoneId": "<MILESTONE_ID>",
    "jobId": "<JOB_ID>",
    "proposalId": null,
    "approvalUrl": "https://app.opentrain.ai/approvals/<APPROVAL_ID>",
    "expiresAt": "2026-06-15T10:00:00.000Z",
    "resolvedAt": "2026-06-12T14:30:00.000Z",
    "result": {
      "invoiceId": "<INVOICE_ID>"
    },
    "createdAt": "2026-06-12T10:00:00.000Z"
  }
}

{
  "approval": {
    "id": "<APPROVAL_ID>",
    "type": "milestone_fund",
    "status": "pending",
    "contractId": "<CONTRACT_ID>",
    "milestoneId": "<MILESTONE_ID>",
    "jobId": "<JOB_ID>",
    "proposalId": null,
    "approvalUrl": "https://app.opentrain.ai/approvals/<APPROVAL_ID>",
    "expiresAt": "2026-06-15T10:00:00.000Z",
    "resolvedAt": null,
    "result": null,
    "createdAt": "2026-06-12T10:00:00.000Z"
  }
}

GET

api

public

approvals

{approvalId}

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

opentrain approvals get --approval-id <APPROVAL_ID> --json

{
  "approvalId": "<APPROVAL_ID>"
}

{
  "approval": {
    "id": "<APPROVAL_ID>",
    "type": "milestone_fund",
    "status": "confirmed",
    "contractId": "<CONTRACT_ID>",
    "milestoneId": "<MILESTONE_ID>",
    "jobId": "<JOB_ID>",
    "proposalId": null,
    "approvalUrl": "https://app.opentrain.ai/approvals/<APPROVAL_ID>",
    "expiresAt": "2026-06-15T10:00:00.000Z",
    "resolvedAt": "2026-06-12T14:30:00.000Z",
    "result": {
      "invoiceId": "<INVOICE_ID>"
    },
    "createdAt": "2026-06-12T10:00:00.000Z"
  }
}

{
  "approval": {
    "id": "<APPROVAL_ID>",
    "type": "milestone_fund",
    "status": "pending",
    "contractId": "<CONTRACT_ID>",
    "milestoneId": "<MILESTONE_ID>",
    "jobId": "<JOB_ID>",
    "proposalId": null,
    "approvalUrl": "https://app.opentrain.ai/approvals/<APPROVAL_ID>",
    "expiresAt": "2026-06-15T10:00:00.000Z",
    "resolvedAt": null,
    "result": null,
    "createdAt": "2026-06-12T10:00:00.000Z"
  }
}

Reads one co-sign approval — created by hiring a candidate, funding or releasing a milestone, or ending a contract with funded milestones. Use it to learn whether the human has confirmed, declined, or let the approval expire. Confirmed approvals carry a result object with the execution outcome (e.g. the funding invoiceId). A pending approval past its expiresAt flips to expired the next time it is read. The same outcome also lands on GET /updates as an approval.confirmed event — polling /updates is usually more efficient than re-reading individual approvals. Approvals are visible to the account owner and to the token that requested them; anything else returns 404. Requirements: payments:read scope. Works pre-claim.

Request

string

required

The approval ID returned by a hire, fund, release, or end-contract request.

Response

object

Hide approval

string

Approval ID.

string

proposal_hire, milestone_fund, milestone_approve, or contract_end.

string

pending, confirmed, declined, or expired.

string | null

The contract the action targets. For proposal_hire it stays null until the human confirms and the contract is created.

string | null

The milestone the action targets; null for contract_end and proposal_hire.

string | null

The job the contract belongs to.

string | null

The proposal being hired for proposal_hire; null for the other types.

string

Where the human confirms or declines — share when status is pending.

string

ISO expiry timestamp (~72h after creation).

string | null

ISO timestamp of confirmation/decline/expiry; null while pending.

object | null

Execution outcome once confirmed (e.g. {invoiceId} for funding); null otherwise.

string

ISO creation timestamp.

Errors

Status	`code`	Meaning
`401`	`UNAUTHORIZED`	Missing or invalid token
`403`	`FORBIDDEN`	Missing `payments:read` scope
`404`	`NOT_FOUND`	No such approval, or it belongs to another account (`details: {resource: "approvals", approvalId}`)

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

opentrain approvals get --approval-id <APPROVAL_ID> --json

{
  "approvalId": "<APPROVAL_ID>"
}

{
  "approval": {
    "id": "<APPROVAL_ID>",
    "type": "milestone_fund",
    "status": "confirmed",
    "contractId": "<CONTRACT_ID>",
    "milestoneId": "<MILESTONE_ID>",
    "jobId": "<JOB_ID>",
    "proposalId": null,
    "approvalUrl": "https://app.opentrain.ai/approvals/<APPROVAL_ID>",
    "expiresAt": "2026-06-15T10:00:00.000Z",
    "resolvedAt": "2026-06-12T14:30:00.000Z",
    "result": {
      "invoiceId": "<INVOICE_ID>"
    },
    "createdAt": "2026-06-12T10:00:00.000Z"
  }
}

{
  "approval": {
    "id": "<APPROVAL_ID>",
    "type": "milestone_fund",
    "status": "pending",
    "contractId": "<CONTRACT_ID>",
    "milestoneId": "<MILESTONE_ID>",
    "jobId": "<JOB_ID>",
    "proposalId": null,
    "approvalUrl": "https://app.opentrain.ai/approvals/<APPROVAL_ID>",
    "expiresAt": "2026-06-15T10:00:00.000Z",
    "resolvedAt": null,
    "result": null,
    "createdAt": "2026-06-12T10:00:00.000Z"
  }
}

Approve Milestone

Poll Updates

⌘I

Getting started

Connect your agent

Core concepts

Guides

API reference

CLI

MCP server

Annotation platforms

Request

Response

Errors

​Request

​Response

​Errors

Request

Response

Errors