List Contract Participants

curl -sS https://app.opentrain.ai/api/partner/v1/contracts/<CONTRACT_ID>/participants \
  -H "Authorization: Bearer $OT_PARTNER_TOKEN"

{
  "contractId": "<CONTRACT_ID>",
  "participants": [
    {
      "opentrainUserId": "<OPENTRAIN_USER_ID>",
      "displayName": "Maria S.",
      "country": "PH",
      "profileUrl": "https://app.opentrain.ai/profile/maria-s-annotation",
      "workEmail": "maria.1234@opentrain.work"
    }
  ]
}

GET

api

partner

contracts

{contractId}

participants

curl -sS https://app.opentrain.ai/api/partner/v1/contracts/<CONTRACT_ID>/participants \
  -H "Authorization: Bearer $OT_PARTNER_TOKEN"

{
  "contractId": "<CONTRACT_ID>",
  "participants": [
    {
      "opentrainUserId": "<OPENTRAIN_USER_ID>",
      "displayName": "Maria S.",
      "country": "PH",
      "profileUrl": "https://app.opentrain.ai/profile/maria-s-annotation",
      "workEmail": "maria.1234@opentrain.work"
    }
  ]
}

Returns the AI trainers on a contract whose job is linked by this install. Use it to provision workspace members — or to re-resolve a workEmail that was absent from a webhook payload. Requirements: participants:read scope. The workEmail field additionally requires the participants:email scope and the install’s PII consent — see privacy and Work Email.

Request

string

required

The contract ID, from list contracts or a contract.started event.

Response

string

The contract these participants belong to.

object[]

The AI trainers on the contract.

Show Participant fields

string

Stable OpenTrain user ID — use it as your cross-reference key.

string | null

Display name, masked to first name + last initial (for example "Maria S."). Full last names never leave the platform.

string | null

Country.

string

Public OpenTrain profile URL.

string

Platform-issued @opentrain.work Work Email. Present only when the install has PII consent and the token holds participants:email. Personal emails are never shared.

Errors

Status	`code`	Meaning
`401`	`UNAUTHORIZED`	Missing, invalid, or revoked token
`403`	`FORBIDDEN`	Token lacks `participants:read`
`404`	`NOT_FOUND`	Contract not found, or its job is not linked by this install

curl -sS https://app.opentrain.ai/api/partner/v1/contracts/<CONTRACT_ID>/participants \
  -H "Authorization: Bearer $OT_PARTNER_TOKEN"

{
  "contractId": "<CONTRACT_ID>",
  "participants": [
    {
      "opentrainUserId": "<OPENTRAIN_USER_ID>",
      "displayName": "Maria S.",
      "country": "PH",
      "profileUrl": "https://app.opentrain.ai/profile/maria-s-annotation",
      "workEmail": "maria.1234@opentrain.work"
    }
  ]
}

List Contracts

Get Contract Budget

⌘I

Getting started

Connect your agent

Core concepts

Guides

API reference

CLI

MCP server

Annotation platforms

List Contract Participants

Request

Response

Errors

​Request

​Response

​Errors

Request

Response

Errors