Driver and Vehicle Licensing Agency (DVLA) Vehicle API

openapi: 3.2.0
info:
  title: Dvla Gov Uk Vehicle API
  version: 1.2.0
  contact:
    name: DVLA API Team
    email: DvlaAPIAccess@dvla.gov.uk
  description: 'Operations tagged vehicle across 2 of this provider''s published API definitions: v1.2.0-vehicle-enquiry-service.json, dvla-gov-uk-vehicle-enquiry-openapi.yml. Each path carries the servers of the definition it was published in.'
servers:
- description: Production environment
  url: https://driver-vehicle-licensing.api.gov.uk/vehicle-enquiry
- description: Test environment
  url: https://uat.driver-vehicle-licensing.api.gov.uk/vehicle-enquiry
tags:
- name: Vehicle
paths:
  /v1/vehicles:
    post:
      tags:
      - Vehicle
      description: Returns vehicle details based on registration number
      summary: Get vehicle details by registration number
      operationId: getVehicleDetailsByRegistrationNumber
      parameters:
      - name: x-api-key
        in: header
        description: Client Specific API Key
        required: true
        schema:
          type: string
      - name: X-Correlation-Id
        in: header
        description: Consumer Correlation ID
        required: false
        schema:
          type: string
      requestBody:
        description: Registration number of the vehicle to find details for
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/VehicleRequest'
      responses:
        '200':
          description: Successful response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Vehicle'
        '400':
          description: Bad Request
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '404':
          description: Vehicle Not Found
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '500':
          description: Internal Server Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '503':
          description: Service Unavailable
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
    servers:
    - description: Production environment
      url: https://driver-vehicle-licensing.api.gov.uk/vehicle-enquiry
    - description: Test environment
      url: https://uat.driver-vehicle-licensing.api.gov.uk/vehicle-enquiry
components:
  schemas:
    VehicleRequest:
      type: object
      properties:
        registrationNumber:
          type: string
    ErrorResponse:
      type: object
      description: Error Response
      properties:
        errors:
          type: array
          items:
            $ref: '#/components/schemas/Errors'
    Vehicle:
      type: object
      properties:
        registrationNumber:
          type: string
          example: WN67DSO
          description: Vehicle registration number without space
        artEndDate:
          type: string
          format: date
          example: '2007-12-25'
          description: Additional Rate of Tax Applicable until End Date
        co2Emissions:
          type: integer
          format: int32
          example: 0
          description: Carbon Dioxide emissions in grams per kilometre
        engineCapacity:
          type: integer
          format: int32
          example: 1796
          description: Cylinder Capacity (CC - Engine Capacity)
        yearOfFirstRegistration:
          type: integer
          format: int32
          example: 2012
          description: Year of First Registration in 4 digits
        monthOfFirstRegistration:
          type: integer
          format: int32
          example: 12
          description: Month of First Registration. 1 = Jan, 2 = Feb, etc
        yearOfFirstRegistrationWithDVLA:
          type: integer
          format: int32
          example: 2012
          description: Year of First Registration With DVLA in 4 digits
        monthOfFirstRegistrationWithDVLA:
          type: integer
          format: int32
          example: 12
          description: Month of First Registration With DVLA. 1 = Jan, 2 = Feb, etc
        euroStatus:
          type: string
          example: Euro 5
          description: Euro Status (Dealer / Customer Provided (new vehicles))
        markedAsScrapped:
          type: boolean
          example: true
          description: Scrapped marker
        markedForExport:
          type: boolean
          example: true
          description: Export marker
        fuelType:
          type: string
          example: PETROL
          description: Fuel Type (Method of Propulsion)
        motStatus:
          type: string
          example: No details held by DVLA
          description: MOT status of vehicle
          enum:
          - No details held by DVLA
          - No results returned
          - Valid
          - Not valid
        motExpiry:
          type: string
          format: date
          example: '2008-12-25'
          description: MOT expiry date
        revenueWeight:
          type: integer
          format: int32
          example: 1640
          description: Revenue Weight in kilograms
        taxDueDate:
          type: string
          format: date
          example: '2017-12-25'
          description: Date of tax liablity, Used in calculating licence information presented to user
        taxStatus:
          type: string
          example: Untaxed
          description: Tax status of the vehicle
          enum:
          - Not Taxed for on Road Use
          - SORN
          - Untaxed
          - Taxed
        colour:
          type: string
          example: Blue
          description: Vehicle Colour
        make:
          type: string
          example: ROVER
          description: Vehicle Make
        typeApproval:
          type: string
          example: N1
          description: Vehicle Type Approval category
        wheelPlan:
          type: string
          example: NON STANDARD
          description: Wheel plan
        yearOfManufacture:
          type: integer
          format: int32
          example: 2004
          description: Year of Manufacture
        vehicleStatus:
          type: string
          description: Vehicle status
          enum:
          - Not Taxed for on Road Use
          - SORN
          - Untaxed
          - Taxed and Due
          - Taxed
        dateOfLastV5CIssued:
          type: string
          format: date
          example: '2016-12-25'
          description: Date of last V5C issued.
        realDrivingEmissions:
          type: string
          example: '1'
          description: Real driving emissions
        automatedVehicle:
          type: boolean
          example: false
          description: Automated Vehicle
    Errors:
      type: object
      properties:
        status:
          type: string
          example: '400'
        code:
          type: string
          example: '105'
          description: DVLA reference code
        title:
          type: string
          example: Invalid vrn number
          description: Error title
        detail:
          type: string
          description: A meaningful description of the error which has occurred
          example: Invalid format for field - vehicle registration number
      required:
      - title
x-refined-from:
- v1.2.0-vehicle-enquiry-service.json
- dvla-gov-uk-vehicle-enquiry-openapi.yml