Skip to main content
Requirements:
  • API key pair
  • scanRef of the verification to delete

Deleting verification data

POST https://ivs.idenfy.com/api/v2/delete
Authorization: Basic {API_KEY}:{API_SECRET}
Content-Type: application/json
This endpoint removes data from iDenfy’s system including client photos of their document and face, parsed document information, names, surnames, and other personal data. The only required parameter is scanRef of the verification.

Request example

{
  "scanRef": "350e2420-8850-11e9-baa5-309c231b1bac"
}

Response — success

For successful API calls that correctly delete all data, there will be no message body — just a response with a 200 status code.

Response — failed

Failed API calls return a message identifying the problem.
{
  "message": "Token has not expired yet.",
  "identifier": "PARTNER_ERROR",
  "documentation": "",
  "severity": "NOT_SEVERE"
}
In case of a malformed JSON body or API key/secret mismatch, you will receive a standard iDenfy API error response. For more details, see error messages.