Third Party - User Access Service v1.0.3

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

• https://driver-vehicle-licensing.api.gov.uk/thirdparty-access

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

Parameters

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

Example Request

curl -X POST  -d '{
  "userName": "string",
  "email": "string"
}' 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