Obtener ID Verification (Listado y Uno)

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

import requests

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

headers = {"Authorization": "Bearer <token>"}

response = requests.get(url, headers=headers)

print(response.text)

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

}

HttpResponse<String> response = Unirest.get("http://api.gu1.ai/api/kyc/id-verification/verifications")
  .header("Authorization", "Bearer <token>")
  .asString();

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>'

import requests

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

headers = {"Authorization": "Bearer <token>"}

response = requests.get(url, headers=headers)

print(response.text)

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

}

HttpResponse<String> response = Unirest.get("http://api.gu1.ai/api/kyc/id-verification/verifications")
  .header("Authorization", "Bearer <token>")
  .asString();

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"

ID Verification (Frente/Reverso del documento)Obtener imágenes ID Verification

⌘I

​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