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.eyJzdWIiOiIxMjYxIiwic2NwIjoidXNlciIsImF1ZCI6bnVsbCwiaWF0IjoxNzQyNDY0OTM2LCJleHAiOjE3NDUwNTY5MzYsImp0aSI6IjAwMjFkNWRlLTMxYWUtNGVhZi1hYzMxLTRkYzU1OTBjY2MyMCJ9.AU4CgPjQnfkTPTEjsataWrhKwIqlL8335fbNEgUweyI
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/"d0cd0e71dfafc2dc030444e2d4f54d47"
cache-control: max-age=0, private, must-revalidate
x-request-id: 2543c05d-80b5-4d15-b804-5612845bd991
x-runtime: 0.011230
content-length: 1197

Body

{
  "jobs": [
    {
      "id": 362,
      "drivers_count": 0,
      "drivers_required": 5,
      "end_date": "2025-08-18",
      "job_type": "full_time",
      "number": 72279230,
      "postcode": "CF10 1AA",
      "published_at": "2025-03-20T09:02:16.475Z",
      "start_date": "2025-03-21",
      "title": "Technology Analyst"
    },
    {
      "id": 363,
      "drivers_count": 0,
      "drivers_required": 1,
      "end_date": "2025-10-23",
      "job_type": "part_time",
      "number": 89547540,
      "postcode": "L1 1AA",
      "published_at": "2025-03-20T09:02:16.479Z",
      "start_date": "2025-03-25",
      "title": "Retail Director"
    },
    {
      "id": 364,
      "drivers_count": 0,
      "drivers_required": 9,
      "end_date": "2025-10-14",
      "job_type": "fixed_term_contract",
      "number": 14822486,
      "postcode": "BS1 1AA",
      "published_at": "2025-03-20T09:02:16.483Z",
      "start_date": "2025-03-22",
      "title": "IT Executive"
    },
    {
      "id": 365,
      "drivers_count": 0,
      "drivers_required": 6,
      "end_date": "2026-02-14",
      "job_type": "full_time",
      "number": 14320293,
      "postcode": "CF10 1AA",
      "published_at": "2025-03-20T09:02:16.487Z",
      "start_date": "2025-03-28",
      "title": "Farming Executive"
    },
    {
      "id": 366,
      "drivers_count": 0,
      "drivers_required": 7,
      "end_date": "2025-11-04",
      "job_type": "temporary_contract",
      "number": 57993657,
      "postcode": "CF10 1AA",
      "published_at": "2025-03-20T09:02:16.491Z",
      "start_date": "2025-03-26",
      "title": "Internal Marketing Technician"
    }
  ]
}