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.eyJzdWIiOiIxMzg4Iiwic2NwIjoidXNlciIsImF1ZCI6bnVsbCwiaWF0IjoxNzQyNDY0OTQwLCJleHAiOjE3NDUwNTY5NDAsImp0aSI6ImRlMDNlYWFhLWE5MzctNDQ4Yy1iNWRiLWVlMGEzMDM2NGRlYSJ9.uChNy4HKVFQifnhCVbJGNFBMgIWOjUjSPCxbiCih-do
Host: example.org
Cookie:

Query Parameters

by_status=active

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/"260a1431271fc9c84fbb9399016616d3"
cache-control: max-age=0, private, must-revalidate
x-request-id: c6893c51-36c8-4dc2-a160-bfeeb0d9bdfa
x-runtime: 0.016591
content-length: 1035

Body

{
  "jobs": [
    {
      "id": 472,
      "company": {
        "id": 486,
        "image": null,
        "name": "McGlynn Group"
      },
      "job_type": "part_time",
      "licenses": [
        "phv",
        "b"
      ],
      "min_rate": "53.61",
      "postcode": "NG1 1AA",
      "published_at": "2025-03-20T09:02:20.083Z",
      "timer": 86400,
      "title": "Corporate Banking Coordinator"
    },
    {
      "id": 473,
      "company": {
        "id": 487,
        "image": null,
        "name": "Ernser and Sons"
      },
      "job_type": "fixed_term_contract",
      "licenses": [
        "adr",
        "d1"
      ],
      "min_rate": "86.54",
      "postcode": "NG1 1AA",
      "published_at": "2025-03-20T09:02:20.107Z",
      "timer": 86400,
      "title": "Government Strategist"
    },
    {
      "id": 474,
      "company": {
        "id": 488,
        "image": null,
        "name": "Hilll, Kohler and Lueilwitz"
      },
      "job_type": "fixed_term_contract",
      "licenses": [
        "c",
        "d1"
      ],
      "min_rate": "30.86",
      "postcode": "M1 1AE",
      "published_at": "2025-03-20T09:02:20.126Z",
      "timer": 86400,
      "title": "Internal Representative"
    },
    {
      "id": 475,
      "company": {
        "id": 489,
        "image": null,
        "name": "Paucek, McKenzie and Effertz"
      },
      "job_type": "part_time",
      "licenses": [
        "c1",
        "d1"
      ],
      "min_rate": "46.43",
      "postcode": "L1 1AA",
      "published_at": "2025-03-20T09:02:20.145Z",
      "timer": 86400,
      "title": "Real-Estate Analyst"
    }
  ]
}