Jobs

Driver job search

GET search

Endpoint

GET /api/v1/jobs/search

Parameters

Name Description In
by_licenses Filter by license ["b", "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"]
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.eyJzdWIiOiIxMzc2Iiwic2NwIjoidXNlciIsImF1ZCI6bnVsbCwiaWF0IjoxNzM3NTUxNTgyLCJleHAiOjE3NDAxNDM1ODIsImp0aSI6IjE4MmM0NTZiLWY1NmMtNGI3Yi05ZDg4LTdjMGE0MDBkMTVlNiJ9.0og6cHzHfaet4rYgZ8HEe1_rcYq_pd2_n6N5oNUIlA0
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/"770b10db32db39c9c259ee436f441084"
cache-control: max-age=0, private, must-revalidate
x-request-id: 48248e34-5633-474c-a6de-414c82efddeb
x-runtime: 0.018961
content-length: 1030

Body

{
  "jobs": [
    {
      "id": 469,
      "company": {
        "id": 485,
        "image": null,
        "name": "Funk Inc"
      },
      "job_type": "fixed_term_contract",
      "licenses": [
        "c",
        "hiab"
      ],
      "min_rate": "85.46",
      "postcode": "B1 1AA",
      "published_at": "2025-01-22T12:13:02.081Z",
      "timer": 86400,
      "title": "Human Officer"
    },
    {
      "id": 470,
      "company": {
        "id": 486,
        "image": null,
        "name": "Macejkovic, Muller and Gutkowski"
      },
      "job_type": "full_time",
      "licenses": [
        "b",
        "d1e"
      ],
      "min_rate": "88.23",
      "postcode": "M1 1AE",
      "published_at": "2025-01-22T12:13:02.099Z",
      "timer": 86400,
      "title": "Retail Technician"
    },
    {
      "id": 471,
      "company": {
        "id": 487,
        "image": null,
        "name": "Bernier Group"
      },
      "job_type": "full_time",
      "licenses": [
        "adr",
        "d"
      ],
      "min_rate": "33.85",
      "postcode": "BS1 1AA",
      "published_at": "2025-01-22T12:13:02.116Z",
      "timer": 86400,
      "title": "Senior Construction Consultant"
    },
    {
      "id": 472,
      "company": {
        "id": 488,
        "image": null,
        "name": "Hodkiewicz-Jacobs"
      },
      "job_type": "fixed_term_contract",
      "licenses": [
        "hiab",
        "ce"
      ],
      "min_rate": "42.53",
      "postcode": "BS1 1AA",
      "published_at": "2025-01-22T12:13:02.134Z",
      "timer": 86400,
      "title": "National Manufacturing Representative"
    }
  ]
}