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.eyJzdWIiOiIxMjU0Iiwic2NwIjoidXNlciIsImF1ZCI6bnVsbCwiaWF0IjoxNzM3NTUxNTc5LCJleHAiOjE3NDAxNDM1NzksImp0aSI6IjQ0NjFhNWRhLTkyOWYtNGJmNC1iMjY2LTgwOWRlNDg1M2EwZSJ9.w4mVXZJcV7G2PfxBVrOhiQj3KQeaQM2mpDo_fE_nc9s
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/"b0ebac97fd9e6ca3af7f97d8bdd909b4"
cache-control: max-age=0, private, must-revalidate
x-request-id: b94b56a0-7e27-4043-8372-76bf47dcc385
x-runtime: 0.012200
content-length: 1238

Body

{
  "jobs": [
    {
      "id": 361,
      "drivers_count": 0,
      "drivers_required": 6,
      "end_date": "2025-10-11",
      "job_type": "full_time",
      "number": 94040405,
      "postcode": "CF10 1AA",
      "published_at": "2025-01-22T12:12:59.227Z",
      "start_date": "2025-01-24",
      "title": "Principal Design Executive"
    },
    {
      "id": 362,
      "drivers_count": 0,
      "drivers_required": 2,
      "end_date": "2025-11-20",
      "job_type": "full_time",
      "number": 86786509,
      "postcode": "M1 1AE",
      "published_at": "2025-01-22T12:12:59.232Z",
      "start_date": "2025-01-28",
      "title": "Dynamic Marketing Supervisor"
    },
    {
      "id": 363,
      "drivers_count": 0,
      "drivers_required": 3,
      "end_date": "2025-07-12",
      "job_type": "fixed_term_contract",
      "number": 91688553,
      "postcode": "EC1A 1BB",
      "published_at": "2025-01-22T12:12:59.236Z",
      "start_date": "2025-01-23",
      "title": "Corporate Manufacturing Orchestrator"
    },
    {
      "id": 364,
      "drivers_count": 0,
      "drivers_required": 3,
      "end_date": "2025-04-03",
      "job_type": "part_time",
      "number": 59240097,
      "postcode": "NG1 1AA",
      "published_at": "2025-01-22T12:12:59.241Z",
      "start_date": "2025-01-27",
      "title": "Healthcare Planner"
    },
    {
      "id": 365,
      "drivers_count": 0,
      "drivers_required": 10,
      "end_date": "2025-12-14",
      "job_type": "part_time",
      "number": 55425012,
      "postcode": "L1 1AA",
      "published_at": "2025-01-22T12:12:59.245Z",
      "start_date": "2025-02-01",
      "title": "Chief Community-Services Executive"
    }
  ]
}