---
title: "List Identity Validation Requests"
method: GET
path: "/"
tags: ["Identity Validation"]
---

# List Identity Validation Requests

`GET /`

## Request

- Base URL: `https://app2test.infiniaweb.com/infinia_api/v1/identity-validation`
- URL: `https://app2test.infiniaweb.com/infinia_api/v1/identity-validation/`
- Auth: HTTP basic

Retrieve a paginated list of identity validation requests.

## Query parameters

- `pageNumber` integer: Page number
- `pageSize` integer: Page size
- `dateFrom` string, date-time: Start date
- `dateTo` string, date-time: End date
- `status` 'SUCCESSFUL' | 'FAILED' | 'IN_PROGRESS' | 'TEMPORARY_FAILURE'
- `limit` integer
- `cursor` string

## Headers

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

## Response `200`

Successful Response

- union
  - ValidationListPaginated
    - `next_cursor` string
    - `has_more` boolean
    - `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
              - …
            - CUITDocumentResponse
              - …
            - CUILDocumentResponse
              - …
        - AccountIdentityResponseBrazil
          - `code` 'BR', required: ISO 3166-1 alpha-2 country code
          - `validation` union, required: Type of document to validate
            - CPFDocumentResponse
              - …
            - CNPJDocumentResponse
              - …
  - ErrorResponse
    - `status` 'error' | 'fail'
    - `message` string, required
    - `error_code` string
    - `trace_id` string

## Other responses

- `422`: Validation Error

---

[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)