Obtener ID Verification (Listado y Uno)

curl --request GET \
  --url http://api.gu1.ai/api/kyc/id-verification/verifications \
  --header 'Authorization: Bearer <token>'

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('http://api.gu1.ai/api/kyc/id-verification/verifications', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "http://api.gu1.ai/api/kyc/id-verification/verifications",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "http://api.gu1.ai/api/kyc/id-verification/verifications"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("http://api.gu1.ai/api/kyc/id-verification/verifications")

http = Net::HTTP.new(url.host, url.port)

request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'

response = http.request(request)
puts response.read_body

GET

api

kyc

id-verification

verifications

Obtener ID Verification (Listado y Uno)

curl --request GET \
  --url http://api.gu1.ai/api/kyc/id-verification/verifications \
  --header 'Authorization: Bearer <token>'

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('http://api.gu1.ai/api/kyc/id-verification/verifications', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "http://api.gu1.ai/api/kyc/id-verification/verifications",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "http://api.gu1.ai/api/kyc/id-verification/verifications"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("http://api.gu1.ai/api/kyc/id-verification/verifications")

http = Net::HTTP.new(url.host, url.port)

request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'

response = http.request(request)
puts response.read_body

Resumen

Cada envío por POST ID Verification se guarda para auditoría. Podés:

Listar verificaciones (con filtros opcionales: entityId, withoutEntity, status, paginación).
Obtener una verificación por ID (el mismo UUID que verificationId en la respuesta del POST).

Para descargar los bytes del frente/reverso almacenados, usá Obtener imágenes ID Verification. Todos los endpoints están limitados a tu organización. El objeto extractedData de cada ítem tiene la misma forma que en el POST (ver campos de extractedData), incluido ejemplar cuando aplica en DNI argentino.

1. Listar verificaciones

GET https://api.gu1.ai/api/kyc/id-verification/verifications

Parámetros de query

Parámetro	Tipo	Descripción
`entityId`	string (UUID)	Opcional. Filtrar por entidad persona.
`withoutEntity`	boolean	Si es `true`, solo verificaciones sin entidad asociada.
`status`	string	Opcional. `approved` \| `declined` \| `failed`.
`limit`	number	Máximo de ítems (por defecto 50, máx. 100).
`offset`	number	Desplazamiento para paginación.

Respuesta (200 OK)

{
  "verifications": [
    {
      "id": "c3d4e5f6-a7b8-9012-cdef-345678901234",
      "organizationId": "123e4567-e89b-12d3-a456-426614174000",
      "entityId": "223e4567-e89b-12d3-a456-426614174001",
      "status": "declined",
      "requestId": "4e2bf9fb-d75b-4b26-9362-e51436cfe1eb",
      "vendorData": "my-ref-001",
      "errorMessage": null,
      "warnings": ["DOCUMENT_EXPIRED", "POSSIBLE_DUPLICATED_USER"],
      "extractedData": {
        "providerStatus": "Declined",
        "fullName": "Breno Henrique Ferreira Silva",
        "firstName": "Breno Henrique",
        "lastName": "Ferreira Silva",
        "firstSurname": "Ferreira",
        "secondSurname": "Silva",
        "documentNumber": "08585626509",
        "personalNumber": "2156732124SSPBA",
        "documentType": "Driver's License",
        "taxNumber": "10584158599",
        "dateOfBirth": "2004-08-29",
        "age": 21,
        "expirationDate": "2025-03-07",
        "dateOfIssue": "2024-03-08",
        "firstIssueDate": "2024-03-08",
        "nationality": "BRA",
        "gender": "U",
        "placeOfBirth": "Barreiras/Ba",
        "maritalStatus": "UNKNOWN",
        "issuingState": "BRA",
        "issuingStateName": "Brazil",
        "warningMeta": {
          "duplicatedSessionId": "a4bfeef8-6d6e-4e9b-8fcb-44950912b2b4",
          "duplicatedSessionNumber": 2834,
          "duplicatedApiService": "ID_VERIFICATION"
        },
        "frontImageQualityScore": {
          "overall_score": 98.2,
          "focus_score": 100,
          "brightness_score": 94,
          "is_document_fully_visible": true
        },
        "backImageQualityScore": {
          "overall_score": 97.1,
          "focus_score": 100
        },
        "extraFields": {
          "license_category": "AB",
          "restrictions": "01"
        },
        "mrz": {
          "line1": "IDBRA085856265<<<<<<<<<<<<<<<",
          "line2": "0408299M2503077BRA<<<<<<<<<<<6",
          "line3": "SILVA<<BRENO<HENRIQUE<FERREIRA"
        },
        "parsedAddress": {},
        "barcodes": []
      },
      "createdAt": "2026-05-26T14:32:10.123Z",
      "documentFrontStoragePath": "org/.../front.jpg",
      "documentBackStoragePath": "org/.../back.jpg",
      "storageProvider": "s3"
    }
  ],
  "pagination": { "limit": 20, "offset": 0, "total": 1 }
}

2. Obtener una verificación

GET https://api.gu1.ai/api/kyc/id-verification/verifications/:id

Devuelve un registro de auditoría por ID. Usá el verificationId de la respuesta del POST o del listado.

Parámetros de path

string

required

UUID de la verificación ID (el mismo que verificationId del POST o del listado).

Respuesta (200 OK)

Mismo formato que un ítem del listado (incluye extractedData completo). 404 si no existe o no pertenece a tu organización.

Headers

En todas las solicitudes:

Authorization: Bearer TU_API_KEY

Incluí X-Organization-Id si tu cuenta está limitada por organización.

Errores

Código	HTTP	Descripción
`NOT_FOUND`	404	El ID de verificación no existe o pertenece a otra organización.
`UNAUTHORIZED`	401	API key u organización faltante o inválida.

Ejemplo

const response = await fetch(
  'https://api.gu1.ai/api/kyc/id-verification/verifications?limit=20',
  { headers: { Authorization: 'Bearer TU_API_KEY' } }
);
const { verifications, pagination } = await response.json();
const first = verifications[0];
console.log(first?.extractedData?.taxNumber, first?.extractedData?.extraFields);

const id = 'c3d4e5f6-a7b8-9012-cdef-345678901234';
const response = await fetch(
  `https://api.gu1.ai/api/kyc/id-verification/verifications/${id}`,
  { headers: { Authorization: 'Bearer TU_API_KEY' } }
);
const verification = await response.json();

curl -s "https://api.gu1.ai/api/kyc/id-verification/verifications?limit=10" \
  -H "Authorization: Bearer TU_API_KEY"

curl -s "https://api.gu1.ai/api/kyc/id-verification/verifications/VERIFICATION_UUID" \
  -H "Authorization: Bearer TU_API_KEY"

Comenzando

SDK

Casos de Uso

Webhooks

Workflows

Monitoreo (entidades)

Persona

Mensajería

Empresa

Dispositivos

Eventos

Conozca Su Cliente (KYC)

Transacciones

Métodos de Pago

Reglas

Listas personalizadas

Matriz de Riesgo

Alertas

Investigaciones

Ingesta de Datos

Importaciones masivas

Documentos

Enriquecimiento

AML Crypto

Servicios

Integraciones

Tutoriales Interactivos

Obtener ID Verification (Listado y Uno)

Resumen

1. Listar verificaciones

Parámetros de query

Respuesta (200 OK)

2. Obtener una verificación

Parámetros de path

Respuesta (200 OK)

Headers

Errores

Ejemplo

​Resumen

​1. Listar verificaciones

​Parámetros de query

​Respuesta (200 OK)

​2. Obtener una verificación

​Parámetros de path

​Respuesta (200 OK)

​Headers

​Errores

​Ejemplo

Resumen

1. Listar verificaciones

Parámetros de query

Respuesta (200 OK)

2. Obtener una verificación

Parámetros de path

Respuesta (200 OK)

Headers

Errores

Ejemplo