v1

latestOpenAPI 3.1.02026-07-2617501.1 MB

Lookup a vehicle by its number

get/v1/vehicles/lookup

Query parameters

numberstring required

Specify the Motive assigned number of the vehicle that you want to see the information of.

Headers

X-Time-Zonestring

X-Time-Zone

X-Metric-Unitsboolean

Specify if you want to use the Metric units or the Imperial units. TRUE: Metric units. FALSE: Imperial Units

X-User-Idinteger

Specify the ID of the Fleet Admin or the Fleet Manager who is accessing this endpoint.

Response

200

Example response

{
  "vehicles": [
    {
      "vehicle": {
        "id": 6620,
        "company_id": 2178,
        "number": "11282",
        "status": "active",
        "ifta": true,
        "vin": "1FUJBBCG66LU70309",
        "make": "Freightliner",
        "model": "Conv",
        "year": "2006",
        "fuel_type": "diesel",
        "group_ids": [
          2514
        ],
        "created_at": "2016-10-05T18:00:30Z",
        "updated_at": "2024-07-31T05:30:53Z",
        "eld_device": {
          "id": 746694,
          "identifier": "AABL36FB400300",
          "model": "lbb-3.6ca"
        },
        "current_driver": {
          "id": 4300668,
          "first_name": "Bradly",
          "last_name": "Myers",
          "email": "myers1971b@gmail.com",
          "driver_company_id": "BRAMYEBYMS",
          "status": "active",
          "role": "driver"
        },
        "carb_ctc_test_enabled": "true",
        "carb_ctc_emission_status": "compliant",
        "registration_expiry_date": "2025-12-24"
      },
      "availability_details": {
        "availability_status": "out_of_service",
        "out_of_service_reason": "Vehicle Maintenance",
        "updated_at": "2024-07-31T05:30:53Z",
        "additional_note": "This vehicle is scheduled for maintenance",
        "custom_driver_app_warning_prompt": "This vehicle is scheduled for maintenance, please don't operate",
        "updated_by_user": {
          "id": 123,
          "first_name": "First",
          "last_name": "Last",
          "user_name": "demo_dispatcher",
          "email": "demo.dispatcher@gmail.com",
          "company_reference_id": 1234,
          "status": "active",
          "role": "dispatcher"
        }
      }
    }
  ],
  "pagination": {
    "per_page": 25,
    "page_no": 1,
    "total": 2192
  }
}