List Job Proposals - OpenTrain AI

curl -sS "https://app.opentrain.ai/api/public/v1/jobs/<JOB_ID>/proposals?status=UNREVIEWED&limit=25" \
  -H "Authorization: Bearer $OT_API_TOKEN"

opentrain proposals list --job-id <JOB_ID> --status UNREVIEWED --limit 25 --json

{
  "jobId": "<JOB_ID>",
  "status": "UNREVIEWED",
  "limit": 25
}

{
  "proposals": [
    {
      "id": "<PROPOSAL_ID>",
      "jobId": "<JOB_ID>",
      "jobTitle": "Spanish Sentiment Labeling — Social Media Posts",
      "createdAt": "2026-06-11T15:40:00.000Z",
      "updatedAt": "2026-06-11T15:40:00.000Z",
      "status": {
        "raw": "UNREVIEWED",
        "label": "Unreviewed"
      },
      "bid": {
        "amountUsd": 0.06,
        "unit": "PER_LABEL",
        "labelerHourlyRateUsd": null
      },
      "candidate": {
        "id": "<FREELANCER_ID>",
        "profileSlug": "maria-g",
        "displayName": "Maria G.",
        "firstName": "Maria",
        "lastNameInitial": "G",
        "profileTitle": "Text Annotation Specialist",
        "profilePhotoUrl": "https://app.opentrain.ai/<PHOTO_PATH>",
        "countryCode": "ES",
        "country": "Spain",
        "talentType": "FREELANCER",
        "highestEarningsUsd": 2400,
        "reviewCount": 7
      },
      "metrics": {
        "interviewScore": 86,
        "matchScore": 0.91
      }
    }
  ],
  "nextCursor": null
}

GET

api

public

jobs

{id}

proposals

curl -sS "https://app.opentrain.ai/api/public/v1/jobs/<JOB_ID>/proposals?status=UNREVIEWED&limit=25" \
  -H "Authorization: Bearer $OT_API_TOKEN"

opentrain proposals list --job-id <JOB_ID> --status UNREVIEWED --limit 25 --json

{
  "jobId": "<JOB_ID>",
  "status": "UNREVIEWED",
  "limit": 25
}

{
  "proposals": [
    {
      "id": "<PROPOSAL_ID>",
      "jobId": "<JOB_ID>",
      "jobTitle": "Spanish Sentiment Labeling — Social Media Posts",
      "createdAt": "2026-06-11T15:40:00.000Z",
      "updatedAt": "2026-06-11T15:40:00.000Z",
      "status": {
        "raw": "UNREVIEWED",
        "label": "Unreviewed"
      },
      "bid": {
        "amountUsd": 0.06,
        "unit": "PER_LABEL",
        "labelerHourlyRateUsd": null
      },
      "candidate": {
        "id": "<FREELANCER_ID>",
        "profileSlug": "maria-g",
        "displayName": "Maria G.",
        "firstName": "Maria",
        "lastNameInitial": "G",
        "profileTitle": "Text Annotation Specialist",
        "profilePhotoUrl": "https://app.opentrain.ai/<PHOTO_PATH>",
        "countryCode": "ES",
        "country": "Spain",
        "talentType": "FREELANCER",
        "highestEarningsUsd": 2400,
        "reviewCount": 7
      },
      "metrics": {
        "interviewScore": 86,
        "matchScore": 0.91
      }
    }
  ],
  "nextCursor": null
}

Lists the proposals on one of your jobs, newest first — each with the candidate’s bid, AI-interview score, and a privacy-safe candidate summary. This is the entry point of the candidate evaluation flow: list here, then drill into GET /proposals/{id} and the interview transcript. Candidate identity is masked pre-hire: first name + last initial, no contact details. Personal emails are never exposed at any stage — see privacy. Requirements: proposals:read scope. The job must be yours (403 otherwise). Works pre-claim.

Request

string

required

Your job’s ID.

status

string

Filter by proposal status: UNREVIEWED, SHORTLISTED, MAYBE, HIRED, DECLINED, NOT_A_FIT, or RESUME_SENT. Case-insensitive; spaces and hyphens are normalized to underscores. Invalid values return 400 with details.supportedStatuses.

limit

number

default:"25"

Page size, max 100. Below 1 → 400.

cursor

string

Pagination cursor (a proposal ID) from a previous response’s nextCursor.

Response

proposals

object[]

Proposals ordered by creation date, newest first.

Show proposal entry

string

Proposal ID.

jobId

string

The job this proposal belongs to.

jobTitle

string

Job title (denormalized for convenience).

createdAt

string

ISO submission timestamp.

updatedAt

string

ISO last-change timestamp.

status

object

{raw, label} — machine value (e.g. UNREVIEWED) plus display label.

bid

object

{amountUsd, unit, labelerHourlyRateUsd} — the candidate’s asking rate and its unit.

candidate

object

Privacy-safe candidate summary:

{id, profileSlug, displayName, firstName, lastNameInitial, profileTitle, profilePhotoUrl, countryCode, country, talentType, highestEarningsUsd, reviewCount}

. Use id or profileSlug with GET /freelancers/{idOrSlug} for the full profile.

metrics

object

{interviewScore, matchScore} — AI-interview score and job-match score, null when not available.

nextCursor

string | null

Pass back as cursor for the next page; null at the end.

Errors

Status	`code`	Meaning
`400`	`BAD_REQUEST`	Invalid `status` (`details.supportedStatuses`) or `limit` below 1
`401`	`UNAUTHORIZED`	Missing or invalid token
`403`	`FORBIDDEN`	Missing `proposals:read` scope, or the job belongs to another account
`404`	`NOT_FOUND`	No such job

curl -sS "https://app.opentrain.ai/api/public/v1/jobs/<JOB_ID>/proposals?status=UNREVIEWED&limit=25" \
  -H "Authorization: Bearer $OT_API_TOKEN"

opentrain proposals list --job-id <JOB_ID> --status UNREVIEWED --limit 25 --json

{
  "jobId": "<JOB_ID>",
  "status": "UNREVIEWED",
  "limit": 25
}

{
  "proposals": [
    {
      "id": "<PROPOSAL_ID>",
      "jobId": "<JOB_ID>",
      "jobTitle": "Spanish Sentiment Labeling — Social Media Posts",
      "createdAt": "2026-06-11T15:40:00.000Z",
      "updatedAt": "2026-06-11T15:40:00.000Z",
      "status": {
        "raw": "UNREVIEWED",
        "label": "Unreviewed"
      },
      "bid": {
        "amountUsd": 0.06,
        "unit": "PER_LABEL",
        "labelerHourlyRateUsd": null
      },
      "candidate": {
        "id": "<FREELANCER_ID>",
        "profileSlug": "maria-g",
        "displayName": "Maria G.",
        "firstName": "Maria",
        "lastNameInitial": "G",
        "profileTitle": "Text Annotation Specialist",
        "profilePhotoUrl": "https://app.opentrain.ai/<PHOTO_PATH>",
        "countryCode": "ES",
        "country": "Spain",
        "talentType": "FREELANCER",
        "highestEarningsUsd": 2400,
        "reviewCount": 7
      },
      "metrics": {
        "interviewScore": 86,
        "matchScore": 0.91
      }
    }
  ],
  "nextCursor": null
}

Invite Freelancer to Job

Create Job Draft

⌘I

​Request

​Response

​Errors

Request

Response

Errors