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.eyJzdWIiOiIxNDI2Iiwic2NwIjoidXNlciIsImF1ZCI6bnVsbCwiaWF0IjoxNzYzNjI2Mzk3LCJleHAiOjE3NjYyMTgzOTcsImp0aSI6IjVhM2E4YTdiLTc5N2YtNDA0Yy05NGZkLWZlOGJkMTRhNWQ3ZSJ9.kBlk9LmzBTIVEhXPczo1pBp60OKFiucpNwRyESgFEjg
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/"37c6da35bd93f799c61aff4b4e67e5aa"
cache-control: max-age=0, private, must-revalidate
x-request-id: a18e5a9b-2a97-4931-941e-40cc9a670de4
x-runtime: 0.014419
content-length: 1117

Body

{
  "jobs": [
    {
      "id": 507,
      "company": {
        "id": 503,
        "image": null,
        "name": "Mayert, Pfannerstill and Mann"
      },
      "currency": "GBP",
      "job_type": "part_time",
      "licenses": [
        "phv",
        "adr"
      ],
      "min_rate": "24.3",
      "postcode": "LS1 1UR",
      "published_at": "2025-11-20T07:13:16.853Z",
      "timer": 86400,
      "title": "Lead Government Associate"
    },
    {
      "id": 508,
      "company": {
        "id": 504,
        "image": null,
        "name": "Adams, Witting and Sipes"
      },
      "currency": "GBP",
      "job_type": "part_time",
      "licenses": [
        "c1",
        "b"
      ],
      "min_rate": "70.2",
      "postcode": "BS1 1AA",
      "published_at": "2025-11-20T07:13:16.882Z",
      "timer": 86400,
      "title": "Administration Manager"
    },
    {
      "id": 509,
      "company": {
        "id": 505,
        "image": null,
        "name": "Padberg Inc"
      },
      "currency": "GBP",
      "job_type": "fixed_term_contract",
      "licenses": [
        "c",
        "c1e"
      ],
      "min_rate": "81.0",
      "postcode": "B1 1AA",
      "published_at": "2025-11-20T07:13:16.908Z",
      "timer": 86400,
      "title": "Principal Advertising Supervisor"
    },
    {
      "id": 510,
      "company": {
        "id": 506,
        "image": null,
        "name": "Schuppe, Gislason and Nikolaus"
      },
      "currency": "GBP",
      "job_type": "temporary_contract",
      "licenses": [
        "d1e",
        "c1e"
      ],
      "min_rate": "29.7",
      "postcode": "L1 1AA",
      "published_at": "2025-11-20T07:13:16.934Z",
      "timer": 86400,
      "title": "Consulting Planner"
    }
  ]
}