List My Jobs

Lists every job owned by your account — drafts included — with proposal counts, newest first. This is the authenticated counterpart to the tokenless marketplace search: use it to find your own drafts to finish, open jobs to monitor, and proposal queues to review.

Requirements: jobs:read scope. Works pre-claim.

Request

statusstringquery

Filter to one status: DRAFT, OPEN, ONGOING, COMPLETED, ARCHIVED, or PENDING_APPROVAL. Invalid values return 400 with details.supportedStatuses.

limitnumberquery

Default: 25

Page size, max 100.

cursorstringquery

Pagination cursor from a previous response’s nextCursor.

Response

jobsobject[]

Your jobs, newest first.

job entry

idstring

Job ID.

titlestring

Job title.

statusstring

DRAFT, OPEN, ONGOING, COMPLETED, ARCHIVED, or PENDING_APPROVAL.

publishedboolean

Whether the job is live on the marketplace.

acceptingApplicantsboolean

Whether new proposals are being accepted.

createdAtstring

ISO creation timestamp.

updatedAtstring

ISO last-update timestamp.

jobUrlstring

In-app URL (draft editor for drafts, listing for published jobs).

proposalCountsobject

{total, unreviewed} — proposal volume for the job. A nonzero unreviewed means there are candidates to evaluate.

nextCursorstring | 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 jobs:read scope

Request examples

curlCLIMCP: opentrain_list_jobs

curl

curl -sS "https://app.opentrain.ai/api/public/v1/jobs/mine?status=OPEN&limit=25" \
  -H "Authorization: Bearer $OT_API_TOKEN"

CLI

opentrain jobs list --status OPEN --limit 25 --json

MCP: opentrain_list_jobs

{
  "status": "OPEN",
  "limit": 25
}

Response examples

200400 (invalid status)

200

{
  "jobs": [
    {
      "id": "<JOB_ID>",
      "title": "Spanish Sentiment Labeling — Social Media Posts",
      "status": "OPEN",
      "published": true,
      "acceptingApplicants": true,
      "createdAt": "2026-06-10T11:02:00.000Z",
      "updatedAt": "2026-06-11T09:15:00.000Z",
      "jobUrl": "https://app.opentrain.ai/jobs/<JOB_ID>",
      "proposalCounts": {
        "total": 12,
        "unreviewed": 5
      }
    }
  ],
  "nextCursor": null
}

400 (invalid status)

{
  "error": "Invalid status filter",
  "code": "BAD_REQUEST",
  "requestId": "<REQUEST_ID>",
  "details": {
    "status": "LIVE",
    "supportedStatuses": [
      "DRAFT",
      "OPEN",
      "ONGOING",
      "COMPLETED",
      "ARCHIVED",
      "PENDING_APPROVAL"
    ]
  }
}