Get current enrichment data
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>"
}API Reference
Get current enrichment data
Read the current mapped and raw enrichment payloads for an entity, keyed by integration code β without running enrichments again.
GET
/
entities
/
{id}
/
enrichment-data
Get current enrichment data
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>"
}Overview
Returns the current enrichment snapshot for an entity: the last merged mapped data and raw responses stored after enrichments ran. This endpoint is a read. It does not call external integrations and does not consume enrichment credits. To run integrations, use Execute enrichment. Use this when you need per-integration payloads (mapped / raw keyed by codes such as br_cpf_enrichment). For the Gu1 canonical dossier used by rules (enrichmentData.normalized.*), use Get normalized enrichment.
Requires granular permission entities:read on the API key (legacy fallback entities:read).
Endpoint
GET https://api.gu1.ai/entities/{id}/enrichment-data
Authentication
Authorization: Bearer YOUR_API_KEY
Path parameters
string
required
Gu1 entity UUID (path param name in the API is
entityId).Response
Envelope:{ "success": true, "data": { ... } }.
When data exists (hasEnrichmentData: true)
string
Entity UUID.
boolean
true when a current snapshot row exists.string
Snapshot status (typically
completed).string
ISO 8601 timestamp of the last enrichment that updated this snapshot.
string
User UUID that triggered the last run, or
"system".number
Duration of the last run in milliseconds, when recorded.
object
Consolidated mapped fields (Gu1 mapping). Keys are typically integration codes; values are the mapped objects for that code.
object
Raw upstream payloads keyed by integration code. Shape varies by integration; do not treat it as a stable Gu1 schema.
array
Integration codes present in this snapshot. JSON field name is
providersUsed.string
Optional short summary of the last run.
string
UUID of the related normalized enrichment row, when linked.
string
ISO 8601 timestamp when the snapshot row was created.
string
ISO 8601 timestamp of the last snapshot update.
When the entity exists but has no snapshot
HTTP 200 withhasEnrichmentData: false (not a 404):
{
"success": true,
"data": {
"entityId": "550e8400-e29b-41d4-a716-446655440000",
"hasEnrichmentData": false,
"message": "No enrichment data available for this entity"
}
}
Errors
| HTTP | error.code | When |
|---|---|---|
404 | ENTITY_NOT_FOUND | Entity UUID is not in this organization |
403 | β | Entity is hidden from the caller |
500 | INTERNAL_ERROR | Unexpected failure |
Example
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 and raw in production are larger and differ by integration. Treat the sample as a shape hint.
Related
- Get normalized enrichment β Gu1 canonical dossier
- Execute enrichment β run integrations
- Get entity β identity, status, and risk score
- Integration codes β codes used as keys in
mapped/raw
Was this page helpful?