v1

latestOpenAPI 3.1.02026-07-2432337285.3 KB
Identity Validation

Create Identity Validation

Create an identity validation request to verify the identity of a user.

post/

Headers

x-company-idinteger

ID of a child company for authentication. If not provided, the parent company will be authenticated.

ID of a child company for authentication. If not provided, the parent company will be authenticated.

Request body

callbackUrlstring

Specifies the URL to which the callback will be sent when the transaction status changes. The callback is sent as a POST request with a JSON body containing the validation result, using the same schema as the Get Identity Validation endpoint.

freshnessLimitinteger

Specifies the maximum age in seconds of the data to be returned. By default no stale data will be used, and a new validation will be triggered.

Example request

{
  "freshnessLimit": 86000,
  "country": {
    "validation": {
      "dni": "20300000"
    }
  }
}

Response

Successful Response

OR