---
title: "Identity validation updated"
method: POST
path: "identity_validation.updated"
tags: ["Webhooks"]
---

# Identity validation updated

`POST identity_validation.updated` (webhook)

Sent when an identity validation changes status (`IN_PROGRESS` → `SUCCESSFUL`, `FAILED`, `TEMPORARY_FAILURE`, etc.). Set the destination URL using `callback_url` when creating the validation. The body is identical to the [Get Identity Validation](ref:v1_get_identity_validation__id___get) response.

## Payload

- UnifiedResponseWrapper
  - `status` 'success'
  - `data` UnifiedResponse, required
    - `id` string, required
    - `createdAt` string, date-time, required: Date when the validation request was initially created
    - `updatedAt` string, date-time, required: Date of the most recent update to the validation request
    - `validatedAt` string, date-time: Date when the data was last validated or verified
    - `status` 'SUCCESSFUL' | 'IN_PROGRESS' | 'FAILED' | 'TEMPORARY_FAILURE', required: Status of the validation process. <br> - SUCCESSFUL: The validation process ended correctly. The person/entity was found and the associated data is available to query. <br> - IN_PROGRESS: The validation process is still in progress, keep querying for the result. <br> - FAILED: The validation process ended and no entity/person could be found with the provided data. <br> - TEMPORARY_FAILURE: The validation process ended with an error. The error is temporary and you may retry it later.
    - `statusDescription` string: Verbose description/explanation of the status
    - `callbackUrl` string: 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.
    - `freshnessLimit` integer: Specifies the maximum age in seconds of the data to be returned.
    - `country` union: Country specific data obtained from the validation process
      - AccountIdentityResponseArgentina
        - `code` 'AR', required: ISO 3166-1 alpha-2 country code
        - `validation` union: Document information
          - DNIDocumentResponse
            - `type` 'AR_DNI', required
            - `dni` string, required: DNI (Documento Nacional de Identidad) number
            - `fullName` string, required: Full legal name of the DNI owner
            - `deceased` boolean, required: True if the DNI owner is deceased; otherwise, False
            - `dateOfBirth` string, required: Birthdate of the DNI owner in YYYY-MM-DD format
            - `activityDescription` string: Description of the activity registered for the DNI owner
            - `activityCode` string: Code of the activity registered for the DNI owner in AFIP
          - CUITDocumentResponse
            - `type` 'AR_CUIT', required
            - `cuit` string, required: CUIT (Clave Única de Identificación Tributaria) number
            - `fullName` string, required: Full name of the owner of the CUIT
            - `addressLine` string, required: Address of the owner of the CUIT
            - `state` string, required: Province of the owner of the CUIT
            - `city` string, required: City of the owner of the CUIT
            - `postalCode` string, required: Postal code of the owner of the CUIT
          - CUILDocumentResponse
            - `type` 'AR_CUIL', required
            - `cuil` string, required: CUIL number
            - `fullName` string, required: Full legal name of the CUIL owner
            - `deceased` boolean, required: True if the CUIL owner is deceased; otherwise, False
            - `dateOfBirth` string, required: Birthdate of the CUIL owner in YYYY-MM-DD format
            - `activityDescription` string: Description of the activity registered for the CUIL owner
            - `activityCode` string: Code of the activity registered for the CUIL owner in AFIP
      - AccountIdentityResponseBrazil
        - `code` 'BR', required: ISO 3166-1 alpha-2 country code
        - `validation` union, required: Type of document to validate
          - CPFDocumentResponse
            - `type` 'BR_CPF', required
            - `cpf` string, required: CPF (Cadastro de Pessoas Físicas) number
            - `fullName` string: Full legal name of the CPF owner
            - `dateOfBirth` string: Birthdate of the CPF owner in YYYY-MM-DD format
            - `isMinor` boolean: True if the CPF owner is a minor; otherwise, False. If the CPF owner is a minor, no PII will be provided to comply with local regulations
            - `deceased` boolean: True if the CPF owner is deceased; otherwise, False
            - `yearOfDeath` string: Date when the CPF owner passed away in YYYY-MM-DD format
          - CNPJDocumentResponse
            - `type` 'BR_CNPJ', required
            - `cnpj` string, required: CNPJ (Cadastro Nacional de Pessoas Jurídicas) number
            - `fullName` string, required: Full legal name of the CNPJ owner

## Acknowledgement `200`

Any 2xx response is treated as a successful acknowledgement. Infinia will retry delivery on non-2xx responses.

---

[API](https://skmtc.dev/infiniaweb/apis/identity-validation.md) - [All operations](https://skmtc.dev/infiniaweb/apis/identity-validation/llms.txt) - [OpenAPI document](https://skmtc.dev/infiniaweb/apis/identity-validation/revisions/362c28f2f2b4?raw)