ID Verification Delete API Implementation Guide
This guide illustrates how to implement the ID Verification Delete API.
Usage
If you do not wish to store sensitive customer data after a verification has been completed, you can delete the image(s) and any extracted data in a transaction record either directly in the Customer Portal or via the Delete API.
⚠️ Deletion is immediate and irreversible. Jumio cannot perform any quality or technical support investigations on transactions that have been deleted. If you are upgrading to the Jumio Platform and have migrated Netverify transaction data to the Platform, deleting through this API will also delete the migrated data. Authentication and encryption ID Verification API calls are protected using HTTP Basic Authentication. Your Basic Auth credentials are constructed using your API token as the user-id and your API secret as the password. You can view and manage your API token and secret in the Customer Portal under Settings > API credentials.
You can generate a separate set of API credentials in the Customer Portal to use when retrieving or deleting transaction data under Settings > API credentials > Transaction administration APIs.
⚠️ Never share your API token, API secret, or Basic Auth credentials with anyone — not even Jumio Support. The TLS Protocol is required to securely transmit your data, and we strongly recommend using the latest version. For information on cipher suites supported by Jumio during the TLS handshake see Supported cipher suites.
Request headers
The following fields are required in the header section of your request:
Accept: application/jsonAuthorization: (see RFC 7617) User-Agent: YourCompany YourApp/v1.0
Jumio requires the User-Agent value to reflect your business or entity name for API troubleshooting.
Delete API for ID Verification
Use the HTTP DELETE method to call the RESTful API endpoint below. Specify the ID Verification transaction reference you want to delete as a path parameter.
HTTP Request Method:DELETEREST URL (US): https://netverify.com/api/netverify/v2/scans/<transactionReference>REST URL (EU): https://lon.netverify.com/api/netverify/v2/scans/<transactionReference>REST URL (SGP): https://core-sgp.jumio.com/api/netverify/v2/scans/<transactionReference>
Request body
Required items appear in bold type.
| Name | Type | Max. Length | Description |
|---|---|---|---|
| transactionReference | String | 36 | Jumio reference number for an existing ID Verification transaction in your account. |
Response
Unsuccessful requests will return the relevant HTTP status code and information about the cause of the error.
Successful requests will return HTTP status code 200 OK as confirmation that you have successfully deleted the image(s) and extracted data from the specified transaction record.
Example
Sample ID Verification delete request
DELETE https://netverify.com/api/netverify/v2/scans/xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx/ HTTP/1.1
Accept: application/json
User-Agent: Example Corp SampleApp/1.0.1
Authorization: Basic xxxxxxxxxxxxxxxxxxxxxxxxxxxxx
⚠️ Sample requests cannot be run as-is. Replace example data with your own values.
Delete API for Authentication
Use the HTTP DELETE method to call the RESTful API endpoint below. Specify the Authentication transaction reference you want to delete as a path parameter.
HTTP Request Method:DELETEREST URL (US): https://netverify.com/api/netverify/v2/authentications/<transactionReference>REST URL (EU): https://lon.netverify.com/api/netverify/v2/authentications/<transactionReference>REST URL (SGP): https://core-sgp.jumio.com/api/netverify/v2/authentications/<transactionReference>
Request body
Required items appear in bold type.
| Name | Type | Max. Length | Description |
|---|---|---|---|
| transactionReference | String | 36 | Jumio reference number for an existing Authentication transaction in your account. |
Response
Unsuccessful requests will return the relevant HTTP status code and information about the cause of the error.
Successful requests will return HTTP status code 200 OK as confirmation that you have successfully deleted PII data, images and facemap from the specified authentication transaction record.
Example
Sample Authentication delete request
DELETE https://netverify.com/api/netverify/v2/authentications/xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx/ HTTP/1.1
Accept: application/json
User-Agent: Example Corp SampleApp/1.0.1
Authorization: Basic xxxxxxxxxxxxxxxxxxxxxxxxxxxxx
⚠️ Sample requests cannot be run as-is. Replace example data with your own values.
Delete API for Document Verification
Use the HTTP DELETE method to call the RESTful API endpoint below. Specify the Document Verification transaction reference you want to delete as a path parameter.
HTTP Request Method:DELETEREST URL (US): https://retrieval.netverify.com/api/netverify/v2/documents/<transactionReference>REST URL (EU): https://retrieval.lon.netverify.com/api/netverify/v2/documents/<transactionReference>REST URL (SGP): https://retrieval.core-sgp.jumio.com/api/netverify/v2/documents/<transactionReference>
Request body
Required items appear in bold type.
| Name | Type | Max. Length | Description |
|---|---|---|---|
| transactionReference | String | 36 | Jumio reference number for an existing Document Verification transaction in your account. |
Response
Unsuccessful requests will return the relevant HTTP status code and information about the cause of the error.
Successful requests will return HTTP status code 200 OK as confirmation that you have successfully deleted the image(s) and extracted data from the specified transaction record.
Example
Sample Document Verification delete request
DELETE https://retrieval.netverify.com/api/netverify/v2/documents/xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx/ HTTP/1.1
Accept: application/json
User-Agent: Example Corp SampleApp/1.0.1
Authorization: Basic xxxxxxxxxxxxxxxxxxxxxxxxxxxxx
⚠️ Sample requests cannot be run as-is. Replace example data with your own values.