Skip to main content
Table of contents

Send a test request to the DCS

You’ll now have a client which can:

You must check whether your client can make successful passport validity requests using the test passport data on this page.

Use the DCS integration endpoint for your test checks. Integration endpoint: https://dcs-integration.ida.digital.cabinet-office.gov.uk/checks/passport

Generate a valid true response

Enter these sample passport details in your client to test a valid true response.

{
  "correlationId": "550e8400-e29b-41d4-a716-446655440000",
  "requestId": "af47ddc1-faa9-42fe-be1f-8131df114713",
  "timestamp": "1997-07-16T19:20:30.45+01:00",
  "passportNumber": "824159121",
  "surname": "Watson",
  "forenames": [
    "Mary"
  ],
  "dateOfBirth": "1932-02-25",
  "expiryDate": "2021-03-01"
}

If your request is successful, you should receive a response similar to this:

{
  "correlationId": "550e8400-e29b-41d4-a716-446655440000",
  "requestId": "af47ddc1-faa9-42fe-be1f-8131df114713",
  "error": false,
  "valid": true
}

If your response does not look similar to this, contact the DCS team.

Generate a valid false response

Enter these sample passport details in your client to test a valid false response.

{
  "correlationId": "550e8400-e29b-41d4-a716-446655440000",
  "requestId": "af47ddc1-faa9-42fe-be1f-8131df114713",
  "timestamp": "1997-07-16T19:20:30.45+01:00",
  "passportNumber": "532114382",
  "surname": "Moriarty",
  "forenames": [
    "James"
  ],
  "dateOfBirth": "1939-10-09",
  "expiryDate": "2022-08-03"
}

If your request is successful, you should receive a response similar to this:

{
  "correlationId": "550e8400-e29b-41d4-a716-446655440000",
  "requestId": "af47ddc1-faa9-42fe-be1f-8131df114713",
  "error": false,
  "valid": false
}

If your response does not look similar to this, contact the DCS team.

Generate an error true response

Enter these sample passport details in your client to test an error true response.

{
  "correlationId": "550e8400-e29b-41d4-a716-446655440000",
  "requestId": "af47ddc1-faa9-42fe-be1f-8131df114713",
  "timestamp": "1997-07-16T19:20:30.45+01:00",
  "passportNumber": "217237799",
  "surname": "Holmes",
  "forenames": [
    "Sherlock"
  ],
  "dateOfBirth": "1940-07-23",
  "expiryDate": "2021-04-19"
}

If your request is successful, you should receive a response similar to this:

{
  "correlationId": "550e8400-e29b-41d4-a716-446655440000",
  "requestId": "af47ddc1-faa9-42fe-be1f-8131df114713",
  "error": true,
  "errorMessage": [
    "Unplanned outage"
  ]
}

If your response does not look similar to this, contact the DCS team.

Once you’ve received the data, you can access the data in a DCS response.

This page was last reviewed on 6 August 2020.