Skip to main content

​
Request

Once you have an access token for a user, you can make an HTTP GET request to our API to retrieve their verification information, including that access token. We have two options for authenticating this request. If you configured an OAuth 2 client in the previous step that automatically authenticates API requests with the access token it obtained, you should check that it is configured to use one of the methods listed here.

​
Response

You will receive a JSON-formatted response on success, and an empty HTTP response with an appropriate status code in case of error, examples of which are below.
The user has an active verification in one group.
{
  "sbid_number": "ABC45FG",
  "verifications": [
    {
        "group": "key-worker",
        "expires_on": "2026-03-18"
    }
  ]
}