List Contracts

curl -sS "https://app.opentrain.ai/api/partner/v1/contracts?status=active&limit=50" \
  -H "Authorization: Bearer $OT_PARTNER_TOKEN"

{
  "contracts": [
    {
      "id": "<CONTRACT_ID>",
      "status": "active",
      "jobId": "<OPENTRAIN_JOB_ID>",
      "title": "Traffic signs batch 3 — annotation",
      "startDate": "2026-06-12T10:00:00.000Z",
      "endDate": null,
      "createdAt": "2026-06-12T10:00:00.000Z",
      "projectLinkIds": ["<LINK_ID>"]
    }
  ]
}

GET

api

partner

contracts

curl -sS "https://app.opentrain.ai/api/partner/v1/contracts?status=active&limit=50" \
  -H "Authorization: Bearer $OT_PARTNER_TOKEN"

{
  "contracts": [
    {
      "id": "<CONTRACT_ID>",
      "status": "active",
      "jobId": "<OPENTRAIN_JOB_ID>",
      "title": "Traffic signs batch 3 — annotation",
      "startDate": "2026-06-12T10:00:00.000Z",
      "endDate": null,
      "createdAt": "2026-06-12T10:00:00.000Z",
      "projectLinkIds": ["<LINK_ID>"]
    }
  ]
}

Returns contracts whose job is referenced by at least one project link on the calling token’s install, newest first. This is the pull-side complement to the contract.started / contract.ended webhooks — poll it to reconcile state after downtime, since events are never replayed. Requirements: contracts:read scope.

Request

string

Restrict to contracts on the job linked by this project link. Returns 404 if no link with this ID exists on the install.

string

Filter by contract status: active or ended.

integer

default:"50"

Maximum number of contracts to return (1–200).

Response

object[]

Array of contracts, newest first.

Show Contract fields

string

Contract ID. Use it with GET /contracts/{contractId}/participants.

string

active or ended.

string

The OpenTrain job the contract belongs to.

string | null

Contract title.

string | null

ISO 8601 start timestamp.

string | null

ISO 8601 end timestamp — null while the contract is active.

string

ISO 8601 creation timestamp.

string[]

Project links on this install referencing the contract job.

Errors

Status	`code`	Meaning
`400`	`BAD_REQUEST`	Invalid `status` value or `limit` out of range
`401`	`UNAUTHORIZED`	Missing, invalid, or revoked token
`403`	`FORBIDDEN`	Token lacks `contracts:read`
`404`	`NOT_FOUND`	`projectLinkId` does not match a link on this install

curl -sS "https://app.opentrain.ai/api/partner/v1/contracts?status=active&limit=50" \
  -H "Authorization: Bearer $OT_PARTNER_TOKEN"

{
  "contracts": [
    {
      "id": "<CONTRACT_ID>",
      "status": "active",
      "jobId": "<OPENTRAIN_JOB_ID>",
      "title": "Traffic signs batch 3 — annotation",
      "startDate": "2026-06-12T10:00:00.000Z",
      "endDate": null,
      "createdAt": "2026-06-12T10:00:00.000Z",
      "projectLinkIds": ["<LINK_ID>"]
    }
  ]
}

Delete Project Link

List Contract Participants

⌘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