Vehicles

Add a vehicle by registration

Adds a vehicle to the authorised user's account. Server triggers a DVLA Vehicle Enquiry Service lookup to populate make, model, year, fuel, MOT due date and tax due date. Insurance, last service and service interval are taken from the request body if supplied.

post/api/v1/vehicles

Request

  • Base URL: https://fleetkeep.co.uk
  • URL: https://fleetkeep.co.uk/api/v1/vehicles
  • Auth: OAuth 2 (authorization code, authorization URL https://fleetkeep.co.uk/auth/oauth2/authorize, token URL https://fleetkeep.co.uk/auth/oauth2/token, scopes: vehicles:write)

Request body

registrationstring required
labelstring nullable
insuranceDueDatestring date nullable
lastServiceDatestring date nullable
lastServiceMileageinteger nullable
serviceIntervalMonthsinteger nullable
serviceIntervalDaysinteger nullable
operationalStatus'active' | 'standby' | 'in_maintenance' | 'off_road' | 'sold_or_removed'
assignedDriverNamestring nullable
assignedDriverContactstring nullable
statusNotesstring nullable

Example request

{
  "registration": "BD15 KFG"
}

Response

Vehicle created

idstring uuid required

Changes

No recorded changes to this operation across all 1 revision of this API.