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.eyJzdWIiOiIxNDA2Iiwic2NwIjoidXNlciIsImF1ZCI6bnVsbCwiaWF0IjoxNzUzMjY2MjEwLCJleHAiOjE3NTU4NTgyMTAsImp0aSI6ImE5YWE5NzYzLWY2OTItNGJhOS1iMGMxLTY3ZTk0MjBkZjM0YyJ9.cYwuiTOCTotNSkVUsDSc5YnVieLzPjSNLG__9lA3_1E
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/"f06d93d59f9310c082a7da2d104dc762"
cache-control: max-age=0, private, must-revalidate
x-request-id: 8fd54980-08e8-4d6b-ad69-0929e6195a97
x-runtime: 0.029893
content-length: 1035

Body

{
  "jobs": [
    {
      "id": 477,
      "company": {
        "id": 493,
        "image": null,
        "name": "Hackett Inc"
      },
      "job_type": "fixed_term_contract",
      "licenses": [
        "b1",
        "adr"
      ],
      "min_rate": "74.0",
      "postcode": "BS1 1AA",
      "published_at": "2025-07-23T09:23:30.485Z",
      "timer": 86400,
      "title": "Internal Technician"
    },
    {
      "id": 478,
      "company": {
        "id": 494,
        "image": null,
        "name": "Bednar, Kutch and O'Kon"
      },
      "job_type": "fixed_term_contract",
      "licenses": [
        "hiab",
        "c1"
      ],
      "min_rate": "59.0",
      "postcode": "LS1 1UR",
      "published_at": "2025-07-23T09:23:30.515Z",
      "timer": 86400,
      "title": "Hospitality Associate"
    },
    {
      "id": 479,
      "company": {
        "id": 495,
        "image": null,
        "name": "Collier and Sons"
      },
      "job_type": "fixed_term_contract",
      "licenses": [
        "c1",
        "c1e"
      ],
      "min_rate": "55.0",
      "postcode": "LS1 1UR",
      "published_at": "2025-07-23T09:23:30.544Z",
      "timer": 86400,
      "title": "Banking Coordinator"
    },
    {
      "id": 480,
      "company": {
        "id": 496,
        "image": null,
        "name": "McDermott-Kertzmann"
      },
      "job_type": "temporary_contract",
      "licenses": [
        "d1",
        "d"
      ],
      "min_rate": "59.0",
      "postcode": "M1 1AE",
      "published_at": "2025-07-23T09:23:30.571Z",
      "timer": 86400,
      "title": "Forward Education Supervisor"
    }
  ]
}