Obtener datos actuales de enrichment
curl --request GET \
--url http://api.gu1.ai/entities/{id}/enrichment-data \
--header 'Authorization: Bearer <token>'import requests
url = "http://api.gu1.ai/entities/{id}/enrichment-data"
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/entities/{id}/enrichment-data', 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/entities/{id}/enrichment-data",
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/entities/{id}/enrichment-data"
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/entities/{id}/enrichment-data")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("http://api.gu1.ai/entities/{id}/enrichment-data")
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{
"entityId": "<string>",
"hasEnrichmentData": true,
"status": "<string>",
"lastExecutedAt": "<string>",
"lastExecutedBy": "<string>",
"lastExecutionDurationMs": 123,
"mapped": {},
"raw": {},
"providersUsed": [
{}
],
"summary": "<string>",
"normalizedEnrichmentId": "<string>",
"createdAt": "<string>",
"updatedAt": "<string>"
}Referencia API
Obtener datos actuales de enrichment
Lee los payloads mapped y raw actuales de una entidad, agrupados por código de integración — sin volver a ejecutar enrichments.
GET
/
entities
/
{id}
/
enrichment-data
Obtener datos actuales de enrichment
curl --request GET \
--url http://api.gu1.ai/entities/{id}/enrichment-data \
--header 'Authorization: Bearer <token>'import requests
url = "http://api.gu1.ai/entities/{id}/enrichment-data"
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/entities/{id}/enrichment-data', 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/entities/{id}/enrichment-data",
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/entities/{id}/enrichment-data"
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/entities/{id}/enrichment-data")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("http://api.gu1.ai/entities/{id}/enrichment-data")
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{
"entityId": "<string>",
"hasEnrichmentData": true,
"status": "<string>",
"lastExecutedAt": "<string>",
"lastExecutedBy": "<string>",
"lastExecutionDurationMs": 123,
"mapped": {},
"raw": {},
"providersUsed": [
{}
],
"summary": "<string>",
"normalizedEnrichmentId": "<string>",
"createdAt": "<string>",
"updatedAt": "<string>"
}Descripción general
Devuelve el snapshot actual de enrichment de una entidad: los últimos datos mapped fusionados y las respuestas raw guardadas después de correr enrichments. Este endpoint es una lectura. No llama a integraciones externas y no consume créditos de enrichment. Para ejecutar integraciones, usá Ejecutar enrichment. Usalo cuando necesitás payloads por integración (mapped / raw con claves como br_cpf_enrichment). Para el dossier canónico de Gu1 que usan las reglas (enrichmentData.normalized.*), usá Obtener enrichment normalizado.
Requiere el permiso granular entities:read en la API key (fallback legacy entities:read).
Endpoint
GET https://api.gu1.ai/entities/{id}/enrichment-data
Autenticación
Authorization: Bearer YOUR_API_KEY
Parámetros de ruta
string
required
UUID de la entidad en Gu1 (en la API el path param se llama
entityId).Respuesta
Envelope:{ "success": true, "data": { ... } }.
Cuando hay datos (hasEnrichmentData: true)
string
UUID de la entidad.
boolean
true cuando existe una fila de snapshot actual.string
Estado del snapshot (típicamente
completed).string
Timestamp ISO 8601 del último enrichment que actualizó este snapshot.
string
UUID del usuario que disparó la última corrida, o
"system".number
Duración de la última corrida en milisegundos, cuando está registrada.
object
Campos mapped consolidados (mapeo Gu1). Las claves suelen ser códigos de integración; los valores son los objetos mapped de ese código.
object
Payloads crudos de origen, con clave = código de integración. La forma varía por integración; no lo trates como schema estable de Gu1.
array
Códigos de integración presentes en este snapshot. El nombre del campo JSON es
providersUsed.string
Resumen opcional de la última corrida.
string
UUID de la fila de enrichment normalizado asociada, cuando existe.
string
Timestamp ISO 8601 de creación del snapshot.
string
Timestamp ISO 8601 de la última actualización del snapshot.
Cuando la entidad existe pero no hay snapshot
HTTP 200 conhasEnrichmentData: false (no es un 404):
{
"success": true,
"data": {
"entityId": "550e8400-e29b-41d4-a716-446655440000",
"hasEnrichmentData": false,
"message": "No enrichment data available for this entity"
}
}
Errores
| HTTP | error.code | Cuándo |
|---|---|---|
404 | ENTITY_NOT_FOUND | El UUID de la entidad no está en esta organización |
403 | — | La entidad está oculta para el llamador |
500 | INTERNAL_ERROR | Fallo inesperado |
Ejemplo
curl -X GET "https://api.gu1.ai/entities/550e8400-e29b-41d4-a716-446655440000/enrichment-data" \
-H "Authorization: Bearer YOUR_API_KEY"
const response = await fetch(
'https://api.gu1.ai/entities/550e8400-e29b-41d4-a716-446655440000/enrichment-data',
{ headers: { Authorization: 'Bearer YOUR_API_KEY' } }
);
const body = await response.json();
import requests
response = requests.get(
'https://api.gu1.ai/entities/550e8400-e29b-41d4-a716-446655440000/enrichment-data',
headers={'Authorization': 'Bearer YOUR_API_KEY'}
)
print(response.json())
{
"success": true,
"data": {
"entityId": "550e8400-e29b-41d4-a716-446655440000",
"hasEnrichmentData": true,
"status": "completed",
"lastExecutedAt": "2026-09-03T15:30:00.000Z",
"lastExecutedBy": "system",
"lastExecutionDurationMs": 1840,
"mapped": {
"br_cpf_enrichment": {
"taxId": "12345678901",
"name": "Example Person"
}
},
"raw": {
"br_cpf_enrichment": {
"status": "REGULAR"
}
},
"providersUsed": ["br_cpf_enrichment"],
"summary": null,
"normalizedEnrichmentId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
"createdAt": "2026-09-01T12:00:00.000Z",
"updatedAt": "2026-09-03T15:30:00.000Z"
}
}
mapped y raw en producción son más grandes y cambian según la integración. Tomá el ejemplo como pista de forma.
Relacionado
- Obtener enrichment normalizado — dossier canónico de Gu1
- Ejecutar enrichment — correr integraciones
- Obtener entidad — identidad, estado y score de riesgo
- Códigos de integración — códigos usados como claves en
mapped/raw
Was this page helpful?