Jobs

Driver job search

GET search

Endpoint

GET /api/v1/jobs/search

Parameters

Name Description In
by_licenses Filter by license ["b", "b1", "c", "ce", "c1", "c1e", "d", "d1", "d1e", "adr", "hiab", "phv"]
by_title Search by title
latitude Latitude
longitude Longitude
distance Distance
by_job_type Filter by job type ["full_time", "part_time", "temporary_contract", "fixed_term_contract"]
by_industry Filter by industry ["tourism", "bus", "international", "coach", "van", "medical", "rail_replacement", "school", "private_hire", "hgv", "courier", "warehouse"]
by_date_published Filter by date published ["today", "3", "7", "14", "all_time"]
by_status Filter by status ["active", "auction"]
order_by[min_rate] Higher/lower price ["asc", "desc"]
order_by[published_at] Newest/oldest ["asc", "desc"]
page Page number
per_page Number of items per page

Request

Route

GET /api/v1/jobs/search?by_status=active

Headers

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

Query Parameters

by_status=active

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: 4
content-type: application/json; charset=utf-8
vary: Accept, Origin
etag: W/"a18b0f0988e907af3c41e1e3ea02a735"
cache-control: max-age=0, private, must-revalidate
x-request-id: 3c70f35f-aba2-4cb6-b0a5-78d768edb79c
x-runtime: 0.014526
content-length: 1095

Body

{
  "jobs": [
    {
      "id": 472,
      "company": {
        "id": 488,
        "image": null,
        "name": "Kerluke-Buckridge"
      },
      "currency": "GBP",
      "job_type": "part_time",
      "licenses": [
        "b",
        "adr"
      ],
      "min_rate": "26.0",
      "postcode": "LS1 1UR",
      "published_at": "2025-10-20T07:54:25.182Z",
      "timer": 86400,
      "title": "Future Sales Administrator"
    },
    {
      "id": 473,
      "company": {
        "id": 489,
        "image": null,
        "name": "Walsh Inc"
      },
      "currency": "GBP",
      "job_type": "fixed_term_contract",
      "licenses": [
        "phv",
        "c1e"
      ],
      "min_rate": "46.0",
      "postcode": "B1 1AA",
      "published_at": "2025-10-20T07:54:25.204Z",
      "timer": 86400,
      "title": "Advertising Supervisor"
    },
    {
      "id": 474,
      "company": {
        "id": 490,
        "image": null,
        "name": "Purdy, Kilback and Purdy"
      },
      "currency": "GBP",
      "job_type": "temporary_contract",
      "licenses": [
        "d1e",
        "hiab"
      ],
      "min_rate": "51.0",
      "postcode": "M1 1AE",
      "published_at": "2025-10-20T07:54:25.227Z",
      "timer": 86400,
      "title": "Future Strategist"
    },
    {
      "id": 475,
      "company": {
        "id": 491,
        "image": null,
        "name": "Lesch, Brakus and Schmeler"
      },
      "currency": "GBP",
      "job_type": "part_time",
      "licenses": [
        "phv",
        "c1e"
      ],
      "min_rate": "83.0",
      "postcode": "B1 1AA",
      "published_at": "2025-10-20T07:54:25.258Z",
      "timer": 86400,
      "title": "Legacy Education Designer"
    }
  ]
}