Skip to main content
Table of contents

Third Party - User Access Service v1.0.4

3rd Party API to provide user authentication, change password and change API Key services

Click here to see this OpenAPI specification in JSON format.

Base URLs

Email: DVLA API Team

Authenticate User

post__v1_authenticate

POST /v1/authenticate


Parameters

Name In Type Required Restrictions Description
body body AuthRequest true none none

Example Request

curl -X POST  -d '{
  "userName": "string",
  "password": "string"
}' https://driver-vehicle-licensing.api.gov.uk/thirdparty-access/v1/authenticate \
 -H 'Content-Type: application/json' -H 'Accept: application/json'

Responses

Status Meaning Description Schema
200 OK Success AuthResponse
400 Bad Request Bad Request Error
401 Unauthorized Authentication Failure Error
500 Internal Server Error Internal Server Error Error

Additional common error responses are listed in the Common Error Responses page.

Example Response

200 Response

{
  "id-token": "string"
}

Change Password

post__v1_password

POST /v1/password

3rd Party API to support periodic or adhoc password change


Parameters

Name In Type Required Restrictions Description
body body ChangePasswordRequest true none none

Example Request

curl -X POST  -d '{
  "userName": "string",
  "password": "string",
  "newPassword": "string",
  "verifyCode": "string"
}' https://driver-vehicle-licensing.api.gov.uk/thirdparty-access/v1/password \
 -H 'Content-Type: application/json' -H 'Accept: application/json'

Responses

Status Meaning Description Schema
200 OK Success Empty
400 Bad Request Bad Request Error
401 Unauthorized Unauthorized Error
500 Internal Server Error Unable to change password Error

Additional common error responses are listed in the Common Error Responses page.

Example Response

200 Response

{}

New Password

post__v1_new-password

POST /v1/new-password

3rd Party API to send password recovery codes to users


Example Request

curl -X POST  https://driver-vehicle-licensing.api.gov.uk/thirdparty-access/v1/new-password \
 -H 'Content-Type: application/json' -H 'Accept: application/json'

Responses

Status Meaning Description Schema
200 OK Success Empty
400 Bad Request Bad Request Error
401 Unauthorized Unauthorized Error
500 Internal Server Error Unable to change password Error

Additional common error responses are listed in the Common Error Responses page.

Example Response

200 Response

{}

Change API Key

post__v1_new-api-key

POST /v1/new-api-key

3rd Party API to support periodic or adhoc retrieval of a new API Key. If successful the old API Key will no longer be valid


Parameters

Name In Type Required Restrictions Description
x-api-key header string true none none
Authorization header string true none none

Example Request

curl -X POST  https://driver-vehicle-licensing.api.gov.uk/thirdparty-access/v1/new-api-key \
 -H 'Accept: application/json' -H 'x-api-key: string' -H 'Authorization: string'

Responses

Status Meaning Description Schema
200 OK Success ChangeApiKeyResponse
400 Bad Request Bad request Error
401 Unauthorized Unauthorized Error
500 Internal Server Error Unable to fetch new API Key, existing API Key remains valid Error

Additional common error responses are listed in the Common Error Responses page.

Example Response

200 Response

{
  "newApiKey": "string"
}

Schemas

Empty

{}

Empty Schema

Properties

None

AuthRequest

{
  "userName": "string",
  "password": "string"
}

Properties

Name Type Required Restrictions Description
userName string false none none
password string false none none

AuthResponse

{
  "id-token": "string"
}

Properties

Name Type Required Restrictions Description
id-token string false none none

ChangePasswordRequest

{
  "userName": "string",
  "password": "string",
  "newPassword": "string",
  "verifyCode": "string"
}

Properties

Name Type Required Restrictions Description
userName string false none none
password string false none none
newPassword string false none none
verifyCode string false none none

newPasswordRequest

{
  "userName": "string",
  "email": "string"
}

Properties

Name Type Required Restrictions Description
userName string false none none
email string false none none

ChangeApiKeyResponse

{
  "newApiKey": "string"
}

Properties

Name Type Required Restrictions Description
newApiKey string false none none

Error

[
  {
    "status": 0,
    "code": 0,
    "title": "string",
    "detail": "string"
  }
]

Properties

Name Type Required Restrictions Description
status integer false none none
code integer false none none
title string true none none
detail string false none none