List Job Changes

Incremental change feed for the public marketplace: which jobs were published, updated, or closed since a timestamp. Designed for keeping an external job index in sync without re-fetching everything — store the response’s until and pass it back as the next since.

Only the latest event per job is returned (a job published then updated in the window appears once, as UPDATED). The feed is capped at 5,000 events per call; if you hit the cap, advance since to the returned until and poll again.

Tokenless, CORS-enabled, and edge-cached the same way as search. This feed covers public marketplace listings only — for events about your own account (proposals, messages, contracts), use GET /updates.

Requirements: none — no token, no scope, no feature flag. Rate limited to 120 requests/minute per IP.

Request

sincestringqueryrequired

ISO 8601 timestamp. Changes at or after this instant are returned. Missing or invalid → 400.

Response

sincestring

Echo of the requested window start.

untilstring

Window end (now). Persist this and pass it as the next call’s since.

changesobject[]

One entry per changed job — the latest event in the window.

change entry

jobIdstring

The job that changed — fetch details with GET /jobs/{id}.

eventTypestring

PUBLISHED, UPDATED, or CLOSED.

occurredAtstring

ISO timestamp of the event.

generatedAtstring

ISO timestamp when the response was generated.

Errors

Status	code	Meaning
400	BAD_REQUEST	Missing or unparseable since
429	RATE_LIMITED	Over 120 requests/minute from one IP

Request examples

curl

curl -sS "https://app.opentrain.ai/api/public/v1/jobs/changes?since=2026-06-11T00:00:00Z"

Response examples

200

{
  "since": "2026-06-11T00:00:00.000Z",
  "until": "2026-06-12T08:00:00.000Z",
  "changes": [
    {
      "jobId": "<JOB_ID>",
      "eventType": "PUBLISHED",
      "occurredAt": "2026-06-11T14:22:05.000Z"
    },
    {
      "jobId": "<OTHER_JOB_ID>",
      "eventType": "CLOSED",
      "occurredAt": "2026-06-12T06:10:41.000Z"
    }
  ],
  "generatedAt": "2026-06-12T08:00:00.000Z"
}