# Document Verification

Manage the verification sessions that are used to securely verify the identity of your customers using documents like their driver's license or passport.


## Servers

Sandbox environment
```
https://api.sbx.transmitsecurity.io/verify
```

Production environment (US)
```
https://api.transmitsecurity.io/verify
```

Production environment (EU)
```
https://api.eu.transmitsecurity.io/verify
```

Production environment (CA)
```
https://api.ca.transmitsecurity.io/verify
```

Production environment (AU)
```
https://api.au.transmitsecurity.io/verify
```

## Security

### verify_access_token

An access token generated by the [token endpoint](/openapi/token.openapi/other/getaccesstoken), which must target the following resource: `https://verify.identity.security` (in the future we’ll block access to tokens without this resource).

Type: http
Scheme: bearer
Bearer Format: jwt

## Download OpenAPI description

[Document Verification](https://developer.transmitsecurity.com/_bundle/openapi/verify/verifications.openapi.yaml)

## Other

### Create verification session

 - [POST /api/v1/verification](https://developer.transmitsecurity.com/openapi/verify/verifications.openapi/other/createsession.md): Creates a new verification session that will provide a secure context to the verification process. It returns a start token that will be used when initiating the verification process from the client side. This should be called from the backend. See the Quick start guide for details.

### Get verification result

 - [GET /api/v1/verification/{sid}/result](https://developer.transmitsecurity.com/openapi/verify/verifications.openapi/other/getresult.md): Retrieves the results of the verification session, which contains detailed information about the submitted documents (including PII). This should be called from the backend.

### Delete verification session

 - [DELETE /api/v1/verification/{sid}](https://developer.transmitsecurity.com/openapi/verify/verifications.openapi/other/deletesession.md): Deletes a verification session. This deletes the personal user data collected during the verification process

### Get all images for session

 - [GET /api/v1/verification/{sid}/images](https://developer.transmitsecurity.com/openapi/verify/verifications.openapi/other/getimages.md): Retrieves all the images that were submitted for the session. The response contains only the image metadata, which includes the image ID that can be used to fetch the actual image.

### Get image by ID

 - [GET /api/v1/verification/{sid}/images/{id}](https://developer.transmitsecurity.com/openapi/verify/verifications.openapi/other/getimage.md): Retrieve the actual image from the session (and not only the image metadata). The image is specified by the image ID returned upon fetching all the session images.

### Get consent

 - [GET /api/v1/verification/{sid}/consent](https://developer.transmitsecurity.com/openapi/verify/verifications.openapi/other/getconsent.md): Checks whether user consent was provided for a specific session and if so, provides the timestamp