Jobs

List jobs with specified status

GET jobs

Endpoint

GET /api/v1/jobs

Parameters

Name Description In
by_status Status of jobs ["active", "pending", "auction", "closed", "draft", "template", "ongoing", "completed"]
by_title Search by title
latitude Latitude
longitude Longitude
order_by Order by field ["created_at desc", "created_at", "start_date"]
page Page number
per_page Number of items per page

Request

Route

GET /api/v1/jobs?by_status=draft

Headers

Accept: application/json
Content-Type: application/json
Authorization: Bearer eyJhbGciOiJIUzI1NiJ9.eyJzdWIiOiIxMjczIiwic2NwIjoidXNlciIsImF1ZCI6bnVsbCwiaWF0IjoxNzUzMjY2MjA2LCJleHAiOjE3NTU4NTgyMDYsImp0aSI6ImZhZjU5ZDJlLWRlMjUtNDM5NS1hNmQ3LTUxYTg3MDdmYWRlYSJ9.PKmzudNs9nEA94AjhYjDVmiWCn4EyyZpexv88tosWLE
Host: example.org
Cookie:

Query Parameters

by_status=draft

Body

{
}

Response

Simulated Response

Status

200

Headers

x-frame-options: SAMEORIGIN
x-xss-protection: 0
x-content-type-options: nosniff
x-permitted-cross-domain-policies: none
referrer-policy: strict-origin-when-cross-origin
per-page: 20
total: 5
content-type: application/json; charset=utf-8
vary: Accept, Origin
etag: W/"5810401c91907f1e92634665fd99549e"
cache-control: max-age=0, private, must-revalidate
x-request-id: 1a6abb26-00b1-41b1-b7a8-fe8def46214e
x-runtime: 0.020343
content-length: 1206

Body

{
  "jobs": [
    {
      "id": 365,
      "drivers_count": 0,
      "drivers_required": 2,
      "end_date": "2026-06-22",
      "job_type": "fixed_term_contract",
      "number": 26381260,
      "postcode": "BS1 1AA",
      "published_at": "2025-07-23T09:23:26.158Z",
      "start_date": "2025-07-29",
      "title": "Central Manufacturing Specialist"
    },
    {
      "id": 366,
      "drivers_count": 0,
      "drivers_required": 1,
      "end_date": "2025-10-03",
      "job_type": "part_time",
      "number": 16020302,
      "postcode": "M1 1AE",
      "published_at": "2025-07-23T09:23:26.168Z",
      "start_date": "2025-07-24",
      "title": "Lead Agent"
    },
    {
      "id": 367,
      "drivers_count": 0,
      "drivers_required": 8,
      "end_date": "2026-06-02",
      "job_type": "temporary_contract",
      "number": 31462851,
      "postcode": "L1 1AA",
      "published_at": "2025-07-23T09:23:26.177Z",
      "start_date": "2025-07-24",
      "title": "International Banking Agent"
    },
    {
      "id": 368,
      "drivers_count": 0,
      "drivers_required": 1,
      "end_date": "2026-07-13",
      "job_type": "fixed_term_contract",
      "number": 13791589,
      "postcode": "CF10 1AA",
      "published_at": "2025-07-23T09:23:26.185Z",
      "start_date": "2025-07-25",
      "title": "Future Analyst"
    },
    {
      "id": 369,
      "drivers_count": 0,
      "drivers_required": 7,
      "end_date": "2026-07-17",
      "job_type": "part_time",
      "number": 5717353,
      "postcode": "L1 1AA",
      "published_at": "2025-07-23T09:23:26.193Z",
      "start_date": "2025-07-31",
      "title": "IT Architect"
    }
  ]
}