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.eyJzdWIiOiIxMzEzIiwic2NwIjoidXNlciIsImF1ZCI6bnVsbCwiaWF0IjoxNzYzNjI2MzkzLCJleHAiOjE3NjYyMTgzOTMsImp0aSI6Ijk2NDBkODM1LWNjYjAtNGE0Ny1hMGU1LWExMzBmYmFiZGYyZiJ9.5-j1AouskMlsJVyAN6e3lmi8wxfBxbzQaBrgEFeKHqc
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/"08e62c357b9be0ce634c72d93378939c"
cache-control: max-age=0, private, must-revalidate
x-request-id: d2e7c97c-6757-4e26-b757-5defbdb5e86b
x-runtime: 0.012124
content-length: 1276

Body

{
  "jobs": [
    {
      "id": 381,
      "currency": "GBP",
      "drivers_count": 0,
      "drivers_required": 8,
      "end_date": "2026-05-22",
      "job_type": "fixed_term_contract",
      "number": 93094948,
      "postcode": "EC1A 1BB",
      "published_at": "2025-11-20T07:13:13.480Z",
      "start_date": "2025-11-29",
      "title": "Sales Supervisor"
    },
    {
      "id": 382,
      "currency": "GBP",
      "drivers_count": 0,
      "drivers_required": 8,
      "end_date": "2026-05-09",
      "job_type": "part_time",
      "number": 88975113,
      "postcode": "M1 1AE",
      "published_at": "2025-11-20T07:13:13.488Z",
      "start_date": "2025-11-25",
      "title": "Dynamic Facilitator"
    },
    {
      "id": 383,
      "currency": "GBP",
      "drivers_count": 0,
      "drivers_required": 7,
      "end_date": "2025-12-21",
      "job_type": "part_time",
      "number": 34040263,
      "postcode": "LS1 1UR",
      "published_at": "2025-11-20T07:13:13.496Z",
      "start_date": "2025-11-28",
      "title": "Forward Consultant"
    },
    {
      "id": 384,
      "currency": "GBP",
      "drivers_count": 0,
      "drivers_required": 10,
      "end_date": "2026-05-20",
      "job_type": "temporary_contract",
      "number": 79108741,
      "postcode": "LS1 1UR",
      "published_at": "2025-11-20T07:13:13.504Z",
      "start_date": "2025-11-27",
      "title": "Marketing Executive"
    },
    {
      "id": 385,
      "currency": "GBP",
      "drivers_count": 0,
      "drivers_required": 9,
      "end_date": "2026-01-08",
      "job_type": "full_time",
      "number": 90146934,
      "postcode": "M1 1AE",
      "published_at": "2025-11-20T07:13:13.511Z",
      "start_date": "2025-11-27",
      "title": "Product Manager"
    }
  ]
}