---
title: "Retrieve Keeper at Date of Event for a vehicle."
method: POST
path: "/v1/vehicle-keeper"
---

# Retrieve Keeper at Date of Event for a vehicle.

`POST /v1/vehicle-keeper`

## Request

- Base URL: `https://driver-vehicle-licensing.api.gov.uk/kadoe`
- URL: `https://driver-vehicle-licensing.api.gov.uk/kadoe/v1/vehicle-keeper`
- Auth: one of:
  - HTTP bearer
  - API key in header `X-API-Key`
- TypeScript: <https://skmtc.dev/driver-and-vehicle-licensing-age/apis/kadoe-service/docs/v1/vehicle-keeper/post.ts> (a function with typed inputs; its response is checked against the schema)

## Request body

- KadoeRequest
  - `enquirerId` string, required: Identifier for the enquirer.
  - `linkProviderId` string: Identifier for the link provider, should there be one.
  - `reasonCode` string, required: Code indicating the reason for the enquiry.
  - `registrationNumber` string: Vehicle's registration number.
  - `chassisVin` string: Vehicle's chassis identification number.
  - `eventDate` string, YYYY-MM-DD, required: The date of event in format YYYY-MM-DD.
  - `referenceNumber` string, required: Alpha-numeric reference provided by the enquirer.

## Response `200`

Keeper details at date of event

- KadoeResponse
  - `registrationNumber` string: Vehicle's registration number.
  - `chassisVin` string: Vehicle's chassis identification number.
  - `make` string: The make of the vehicle.
  - `model` string: The model of the vehicle.
  - `fleetNumber` string: The assigned fleet number of the vehicle.
  - `colour` string: The vehicle's colour.
  - `secondaryColour` string: Another colour present on the vehicle.
  - `keeper` Keeper
    - `title` string: Title of the person who is the registered keeper of the vehicle.
    - `firstNames` string: First names of the person who is the registered keeper of the vehicle.
    - `lastName` string: Last name of the person who is the registered keeper of the vehicle.
    - `companyName` string: Name of the company who is the registered keeper of the vehicle
    - `address` Address
      - `line1` string
      - `line2` string
      - `line3` string
      - `line4` string
      - `line5` string
      - `postcode` string
  - `message` string: Information message for stolen, scrapped and exported vehicles.
  - `taxStatus` 'Not Taxed for on Road Use' | 'SORN' | 'Untaxed' | 'Taxed': The current tax status of the vehicle.
  - `seatingCapacity` integer: The seating capacity of the vehicle.
  - `bodyType` string: The body type of the vehicle.
  - `taxClass` string: The tax class of the vehicle.

## Other responses

- `400`: Bad Request
- `401`: Unauthorized
- `403`: Forbidden
- `404`: Not found
- `500`: Internal Server Error
- `503`: Service Unavailable

---

[API](https://skmtc.dev/driver-and-vehicle-licensing-age/apis/kadoe-service.md) - [All operations](https://skmtc.dev/driver-and-vehicle-licensing-age/apis/kadoe-service/llms.txt) - [OpenAPI document](https://skmtc.dev/driver-and-vehicle-licensing-age/apis/kadoe-service/revisions/c48e90bffa95?raw)