consultar verificación
curl --request GET \
--url https://nufi.azure-api.net/kyb/verificaciones/{folio} \
--header 'NUFI-API-KEY: <nufi-api-key>' \
--header 'X-Workspace: <x-workspace>'import requests
url = "https://nufi.azure-api.net/kyb/verificaciones/{folio}"
headers = {
"NUFI-API-KEY": "<nufi-api-key>",
"X-Workspace": "<x-workspace>"
}
response = requests.get(url, headers=headers)
print(response.text)const options = {
method: 'GET',
headers: {'NUFI-API-KEY': '<nufi-api-key>', 'X-Workspace': '<x-workspace>'}
};
fetch('https://nufi.azure-api.net/kyb/verificaciones/{folio}', 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 => "https://nufi.azure-api.net/kyb/verificaciones/{folio}",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"NUFI-API-KEY: <nufi-api-key>",
"X-Workspace: <x-workspace>"
],
]);
$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 := "https://nufi.azure-api.net/kyb/verificaciones/{folio}"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("NUFI-API-KEY", "<nufi-api-key>")
req.Header.Add("X-Workspace", "<x-workspace>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://nufi.azure-api.net/kyb/verificaciones/{folio}")
.header("NUFI-API-KEY", "<nufi-api-key>")
.header("X-Workspace", "<x-workspace>")
.asString();require 'uri'
require 'net/http'
url = URI("https://nufi.azure-api.net/kyb/verificaciones/{folio}")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["NUFI-API-KEY"] = '<nufi-api-key>'
request["X-Workspace"] = '<x-workspace>'
response = http.request(request)
puts response.read_body{
"Code": 200,
"Status": "Success",
"Message": "Seguimiento obtenido",
"Data": {
"Folio": "VD-2607-ZUZFKY",
"ExternalReference": "EXP-2026-00123",
"VerificationStatus": "Completado",
"Verdict": "Aprobada",
"VerdictComment": null,
"Modality": "Domiciliar",
"ProductName": "Crédito Autoplazo",
"ProductKey": "AUTOPLAZO",
"CreatedAtUtc": "2026-07-28T23:37:42.000Z",
"SentAtUtc": "2026-07-28T23:38:10.000Z",
"CompletedAtUtc": "2026-07-28T23:55:02.000Z",
"ExpiresAtUtc": "2026-08-04T23:37:42.000Z",
"GeoResult": "Consistente",
"DistanceMeters": 42.7,
"Accuracy": 12.5,
"GeoIntegrity": "Ok",
"GeoSignals": null,
"BiometricStatus": "Aprobada",
"Photos": [
{
"Section": "1.1 Fachada",
"Url": "https://storage.example.com/foto.jpg",
"TimestampUtc": "2026-07-28T23:50:11.000Z",
"GeoResult": "Consistente",
"DistanceMeters": 38.2,
"HashSha256": "9f2b…"
}
]
}
}{
"Code": 403,
"Status": "forbidden",
"Message": "El ID de Workspace no es válido o no está activo",
"Data": null
}{
"Code": 404,
"Status": "not_found",
"Message": "Verificación no encontrada",
"Data": null
}Endpoints
Consultar verificación
Consulta el seguimiento y resultado de una verificación por folio.
GET
/
verificaciones
/
{folio}
consultar verificación
curl --request GET \
--url https://nufi.azure-api.net/kyb/verificaciones/{folio} \
--header 'NUFI-API-KEY: <nufi-api-key>' \
--header 'X-Workspace: <x-workspace>'import requests
url = "https://nufi.azure-api.net/kyb/verificaciones/{folio}"
headers = {
"NUFI-API-KEY": "<nufi-api-key>",
"X-Workspace": "<x-workspace>"
}
response = requests.get(url, headers=headers)
print(response.text)const options = {
method: 'GET',
headers: {'NUFI-API-KEY': '<nufi-api-key>', 'X-Workspace': '<x-workspace>'}
};
fetch('https://nufi.azure-api.net/kyb/verificaciones/{folio}', 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 => "https://nufi.azure-api.net/kyb/verificaciones/{folio}",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"NUFI-API-KEY: <nufi-api-key>",
"X-Workspace: <x-workspace>"
],
]);
$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 := "https://nufi.azure-api.net/kyb/verificaciones/{folio}"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("NUFI-API-KEY", "<nufi-api-key>")
req.Header.Add("X-Workspace", "<x-workspace>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://nufi.azure-api.net/kyb/verificaciones/{folio}")
.header("NUFI-API-KEY", "<nufi-api-key>")
.header("X-Workspace", "<x-workspace>")
.asString();require 'uri'
require 'net/http'
url = URI("https://nufi.azure-api.net/kyb/verificaciones/{folio}")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["NUFI-API-KEY"] = '<nufi-api-key>'
request["X-Workspace"] = '<x-workspace>'
response = http.request(request)
puts response.read_body{
"Code": 200,
"Status": "Success",
"Message": "Seguimiento obtenido",
"Data": {
"Folio": "VD-2607-ZUZFKY",
"ExternalReference": "EXP-2026-00123",
"VerificationStatus": "Completado",
"Verdict": "Aprobada",
"VerdictComment": null,
"Modality": "Domiciliar",
"ProductName": "Crédito Autoplazo",
"ProductKey": "AUTOPLAZO",
"CreatedAtUtc": "2026-07-28T23:37:42.000Z",
"SentAtUtc": "2026-07-28T23:38:10.000Z",
"CompletedAtUtc": "2026-07-28T23:55:02.000Z",
"ExpiresAtUtc": "2026-08-04T23:37:42.000Z",
"GeoResult": "Consistente",
"DistanceMeters": 42.7,
"Accuracy": 12.5,
"GeoIntegrity": "Ok",
"GeoSignals": null,
"BiometricStatus": "Aprobada",
"Photos": [
{
"Section": "1.1 Fachada",
"Url": "https://storage.example.com/foto.jpg",
"TimestampUtc": "2026-07-28T23:50:11.000Z",
"GeoResult": "Consistente",
"DistanceMeters": 38.2,
"HashSha256": "9f2b…"
}
]
}
}{
"Code": 403,
"Status": "forbidden",
"Message": "El ID de Workspace no es válido o no está activo",
"Data": null
}{
"Code": 404,
"Status": "not_found",
"Message": "Verificación no encontrada",
"Data": null
}Consulta el seguimiento y resultado de una verificación domiciliaria o laboral por folio.
Catálogos de respuesta
VerificationStatus
Indica en qué etapa va el trámite:| Valor | Significado |
|---|---|
NoIniciado | Creada, la liga aún no sale. |
Enviado | La liga se entregó al solicitante. |
Abierto | El solicitante abrió la liga. |
Iniciado | Aceptó el consentimiento y va avanzando. |
Completado | Terminó todo el flujo. |
Expirado | Se venció sin completarse. |
Rechazado | Cancelada. |
SuspendidaPorRiesgo | Se detectaron señales de manipulación de ubicación. |
Verdict
Resolución del analista:Pendiente, Aprobada, Rechazada, Reposicion (se le pide al solicitante repetir la captura).
GeoResult
Ubicación real contra domicilio declarado:| Valor | Significado |
|---|---|
Consistente | ≤ 100 m |
Inconsistente | > 500 m |
Indeterminado | Sin precisión suficiente o sin domicilio |
GeoIntegrity
Plausibilidad del rastreo:Ok, Sospechosa, Comprometida. Cuando no es Ok, GeoSignals trae el detalle (p. ej. ["VelocidadImposible:834km/h"]).
BiometricStatus
Iniciada, Completada, Pendiente (el proveedor aún no emite veredicto), Aprobada, Rechazada.
Ejemplo de respuesta 200
{
"Code": 200,
"Status": "Success",
"Message": "Seguimiento obtenido",
"Data": {
"Folio": "VD-2607-ZUZFKY",
"ExternalReference": "EXP-2026-00123",
"VerificationStatus": "Completado",
"Verdict": "Aprobada",
"VerdictComment": null,
"Modality": "Domiciliar",
"ProductName": "Crédito Autoplazo",
"ProductKey": "AUTOPLAZO",
"CreatedAtUtc": "2026-07-28T23:37:42Z",
"SentAtUtc": "2026-07-28T23:38:10Z",
"CompletedAtUtc": "2026-07-28T23:55:02Z",
"ExpiresAtUtc": "2026-08-04T23:37:42Z",
"GeoResult": "Consistente",
"DistanceMeters": 42.7,
"Accuracy": 12.5,
"GeoIntegrity": "Ok",
"GeoSignals": null,
"BiometricStatus": "Aprobada",
"Photos": [
{
"Section": "1.1 Fachada",
"Url": "https://storage.example.com/foto.jpg",
"TimestampUtc": "2026-07-28T23:50:11Z",
"GeoResult": "Consistente",
"DistanceMeters": 38.2,
"HashSha256": "9f2b…"
}
]
}
}
ApplicantUrl no se devuelve en esta consulta. Solo viaja en la respuesta de crear verificación.Errores
| HTTP | Status | Message |
|---|---|---|
| 403 | forbidden | El ID de Workspace no es válido o no está activo |
| 404 | not_found | Verificación no encontrada — el folio no existe o es de otro workspace |
Path Parameters
Folio de la verificación (p. ej. VD-2607-ZUZFKY).
Was this page helpful?
⌘I
.png?fit=max&auto=format&n=SrFWYqQUIKuRmdvu&q=85&s=29a9d6074794b17ba1b2d2cd5d208849)