---
title: "Create Identity Validation"
method: POST
path: "/"
tags: ["Identity Validation"]
---

# Create Identity Validation

`POST /`

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

## Headers

- `x-company-id` integer — ID of a child company for authentication. If not provided, the parent company will be authenticated.

## Request body

- UnifiedRequest
  - `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. By default no stale data will be used, and a new validation will be triggered.
  - `country` union, required — Country specific data to be used in the validation
    - AccountIdentityRequestArgentina
      - `code` 'AR', required — ISO 3166-1 alpha-2 country code
      - `validation` union, required — Type of document to validate
        - DNIDocumentValidation
          - `type` 'AR_DNI', required
          - `dni` string, required — DNI (Documento Nacional de Identificación) number
        - CUITDocumentValidation
          - `type` 'AR_CUIT', required
          - `cuit` string, required — CUIT (Clave Única de Identificación Tributaria) number
        - CUILDocumentValidation
          - `type` 'AR_CUIL', required
          - `cuil` string, required — CUIL (Clave Única de Identificación Laboral) number
    - AccountIdentityRequestBrazil
      - `code` 'BR', required — ISO 3166-1 alpha-2 country code
      - `validation` union, required — Type of document to validate
        - CPFDocumentValidation
          - `type` 'BR_CPF', required
          - `cpf` string, required — CPF (Cadastro de Pessoas Físicas) number
          - `dateOfBirth` string — Birthdate of the CPF owner in YYYY-MM-DD format
        - CNPJDocumentValidation
          - `type` 'BR_CNPJ', required
          - `cnpj` string, required — CNPJ (Cadastro Nacional de Pessoas Jurídicas) number

## Response `200`

Successful Response

- union
  - IdentityValidationCreatedWrapper
    - `status` 'success'
    - `data` IdentityValidationCreated, required
      - `id` string, required
  - ErrorResponse
    - `status` 'error' | 'fail'
    - `message` string, required
    - `error_code` string
    - `trace_id` string

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/infiniaweb/apis/payins.md) · [All operations](https://skmtc.net/infiniaweb/apis/payins/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/infiniaweb/payins/revisions/3f453785c478/schema)