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.eyJzdWIiOiIxMjczIiwic2NwIjoidXNlciIsImF1ZCI6bnVsbCwiaWF0IjoxNzQ4NTE2NTI0LCJleHAiOjE3NTExMDg1MjQsImp0aSI6IjJlMjNjYTgwLTY1NGEtNGUwYS05OGUyLWU1NDJjYTBiNmVlYiJ9.tDwyMd_Kcp6Py79Qa8rXIID2ZEggUWpYWZPU_d2YLXI
Host: example.org
Cookie:

Query Parameters

by_status=draft

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/"52cc28ebb9d76edd425f7e741080b079"
cache-control: max-age=0, private, must-revalidate
x-request-id: 7aab8ee3-2b68-4d16-98ee-23a9099f6a96
x-runtime: 0.011658
content-length: 1214

Body

{
  "jobs": [
    {
      "id": 365,
      "drivers_count": 0,
      "drivers_required": 9,
      "end_date": "2026-05-21",
      "job_type": "temporary_contract",
      "number": 5596335,
      "postcode": "B1 1AA",
      "published_at": "2025-05-29T10:02:03.995Z",
      "start_date": "2025-05-30",
      "title": "Construction Consultant"
    },
    {
      "id": 366,
      "drivers_count": 0,
      "drivers_required": 6,
      "end_date": "2025-12-01",
      "job_type": "full_time",
      "number": 437594,
      "postcode": "CF10 1AA",
      "published_at": "2025-05-29T10:02:04.001Z",
      "start_date": "2025-05-30",
      "title": "Government Producer"
    },
    {
      "id": 367,
      "drivers_count": 0,
      "drivers_required": 2,
      "end_date": "2025-05-30",
      "job_type": "temporary_contract",
      "number": 2490516,
      "postcode": "B1 1AA",
      "published_at": "2025-05-29T10:02:04.007Z",
      "start_date": "2025-06-01",
      "title": "Principal Retail Producer"
    },
    {
      "id": 368,
      "drivers_count": 0,
      "drivers_required": 9,
      "end_date": "2026-02-16",
      "job_type": "part_time",
      "number": 71027190,
      "postcode": "NG1 1AA",
      "published_at": "2025-05-29T10:02:04.013Z",
      "start_date": "2025-06-05",
      "title": "Future Design Orchestrator"
    },
    {
      "id": 369,
      "drivers_count": 0,
      "drivers_required": 3,
      "end_date": "2026-01-17",
      "job_type": "temporary_contract",
      "number": 58988331,
      "postcode": "BS1 1AA",
      "published_at": "2025-05-29T10:02:04.020Z",
      "start_date": "2025-05-30",
      "title": "Legal Director"
    }
  ]
}