API reference · Jobs

Check whether jobs are still open

POSThttps://trawle.com/v1/jobs/status

Bulk status for up to 100 job ids from earlier results: open, closed (with closedAt) or not_found. Use it to drop closed jobs from a list you are tracking, instead of fetching each job. Data refreshes once a day.

Request body

application/json · CheckJobStatusRequest

idsarray<string>required
Job ids from earlier search results (jobs[].id), up to 100.
Limits
1 to 100 items, items: 1 to 20 characters
Example
["1234567","1234568"]

Responses

200One status per id.CheckJobStatusResult

itemsarray<object> · JobStatusrequired
One item per distinct id asked for, in the order given.
4 propertiesper item
- idstringrequired
  Example
  1234567
- statusstringrequired
  open: still on the employer's site at the last daily scan. closed: gone from it. not_found: not a Trawle job id (or archived long ago); treat it as closed.
  One of
  openclosednot_found
- closedAtstring<date-time> | nullrequired
  When it disappeared; null unless closed.
  Example
  2026-10-31T06:12:00.000Z
- lastSeenAtstring<date-time> | nullrequired
  Last daily scan that saw it open; null when not found.
  Example
  2026-10-31T06:12:00.000Z

400Invalid request: see error.issues and error.hint.Error

errorobjectrequired
4 properties
- codestringrequired
  Machine-readable: invalid_request, not_found, forbidden, rate_limited, internal.
  Example
  invalid_request
- messagestringrequired
  Example
  places: expected an array of GeoNames ids
- hintstringoptional
  What to do next, e.g. which lookup to call first.
  Example
  Resolve place names to ids with GET /v1/places?q=
- issuesarray<object>optional
  Validation problems, one per invalid field.
  2 propertiesper item
  pathstringrequired
  messagestringrequired

PreviousSearch open jobs NextGet a job

POST /v1/jobs/status

curl -X POST "https://trawle.com/v1/jobs/status" \
  -H "Content-Type: application/json" \
  -d '{
  "ids": ["1234567", "1234568"]
}'

Response

{
  "items": [
    {
      "id": "1234567",
      "status": "open",
      "closedAt": "2026-10-31T06:12:00.000Z",
      "lastSeenAt": "2026-10-31T06:12:00.000Z"
    }
  ]
}