> ## Documentation Index
> Fetch the complete documentation index at: https://docs.djigui.io/llms.txt
> Use this file to discover all available pages before exploring further.

# List vehicles

> Your company's vehicles, or the one with a given plate or external id.

Returns your company's vehicles, most recent first, [paginated](/pagination).

Filter by `licencePlate` or `externalId` to find one vehicle: both are exact matches, so `data` holds zero or one vehicle. Given together, a vehicle must match both.

## Query

<ParamField query="licencePlate" type="string">
  Normalised as at registration: `1234 ab 01` finds `1234AB01`.
</ParamField>

<ParamField query="externalId" type="string">
  Your own reference for the vehicle.
</ParamField>

<ParamField query="page" default="1" type="integer" />

<ParamField query="limit" type="integer" default="20">
  1 to 100.
</ParamField>

## Response

<ResponseField name="data" type="object[]">
  Vehicles, with the fields of [Get a vehicle](/api-reference/vehicles/get).
</ResponseField>

<ResponseField name="page" type="integer" />

<ResponseField name="limit" type="integer" />

<ResponseField name="total" type="integer">
  Matching vehicles, across all pages.
</ResponseField>

<RequestExample>
  ```bash By external id theme={null}
  curl "https://businessapi-staging-civ.djigui.io/api/v1.0/vehicle?externalId=client-4821-car-1" \
    -H "x-api-key: $DJIGUI_API_KEY"
  ```
</RequestExample>

<ResponseExample>
  ```json 200 theme={null}
  {
    "data": [
      {
        "id": "0f9b2abd-2fe8-4346-b49e-4a6aefd89a89",
        "externalId": "client-4821-car-1",
        "type": "auto",
        "licencePlate": "1234AB01",
        "brand": "Toyota",
        "model": "Corolla",
        "year": 2019,
        "firstRoadDate": "2019-06-15",
        "carOriginalValue": 15000000,
        "carMarketValue": 9000000,
        "energy": "essence",
        "power": 7,
        "noSeat": 5,
        "hasRegistrationDocument": false,
        "created": "2026-10-20T09:14:03.512Z"
      }
    ],
    "page": 1,
    "limit": 20,
    "total": 1
  }
  ```
</ResponseExample>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.