Obter dados atuais 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>"
}Referência API
Obter dados atuais de enrichment
Lê os payloads mapped e raw atuais de uma entidade, agrupados por código de integração — sem executar enrichments de novo.
GET
/
entities
/
{id}
/
enrichment-data
Obter dados atuais 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>"
}Visão geral
Devolve o snapshot atual de enrichment de uma entidade: os últimos dados mapped mesclados e as respostas raw gravadas depois de rodar enrichments. Este endpoint é uma leitura. Não chama integrações externas e não consome créditos de enrichment. Para executar integrações, use Executar enrichment. Use quando precisar de payloads por integração (mapped / raw com chaves como br_cpf_enrichment). Para o dossiê canônico da Gu1 usado pelas regras (enrichmentData.normalized.*), use Obter enrichment normalizado.
Exige a permissão granular entities:read na API key (fallback legacy entities:read).
Endpoint
GET https://api.gu1.ai/entities/{id}/enrichment-data
Autenticação
Authorization: Bearer YOUR_API_KEY
Parâmetros de rota
string
required
UUID da entidade na Gu1 (na API o path param se chama
entityId).Resposta
Envelope:{ "success": true, "data": { ... } }.
Quando há dados (hasEnrichmentData: true)
string
UUID da entidade.
boolean
true quando existe uma linha de snapshot atual.string
Status do snapshot (em geral
completed).string
Timestamp ISO 8601 do último enrichment que atualizou este snapshot.
string
UUID do usuário que disparou a última execução, ou
"system".number
Duração da última execução em milissegundos, quando registrada.
object
Campos mapped consolidados (mapeamento Gu1). As chaves costumam ser códigos de integração; os valores são os objetos mapped desse código.
object
Payloads brutos de origem, com chave = código de integração. A forma varia por integração; não trate como schema estável da Gu1.
array
Códigos de integração presentes neste snapshot. O nome do campo JSON é
providersUsed.string
Resumo opcional da última execução.
string
UUID da linha de enrichment normalizado associada, quando existir.
string
Timestamp ISO 8601 de criação do snapshot.
string
Timestamp ISO 8601 da última atualização do snapshot.
Quando a entidade existe mas não há snapshot
HTTP 200 comhasEnrichmentData: false (não é 404):
{
"success": true,
"data": {
"entityId": "550e8400-e29b-41d4-a716-446655440000",
"hasEnrichmentData": false,
"message": "No enrichment data available for this entity"
}
}
Erros
| HTTP | error.code | Quando |
|---|---|---|
404 | ENTITY_NOT_FOUND | O UUID da entidade não está nesta organização |
403 | — | A entidade está oculta para o chamador |
500 | INTERNAL_ERROR | Falha inesperada |
Exemplo
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 e raw em produção são maiores e mudam conforme a integração. Trate o exemplo como pista de forma.
Relacionado
- Obter enrichment normalizado — dossiê canônico da Gu1
- Executar enrichment — executar integrações
- Obter entidade — identidade, status e score de risco
- Códigos de integração — códigos usados como chaves em
mapped/raw
Was this page helpful?