> ## Documentation Index
> Fetch the complete documentation index at: https://docs.gu1.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# 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.

## 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](/pt/api-reference/enrichment/execute-by-id).

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](/pt/api-reference/enrichment/get-normalized).

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

```bash theme={null}
Authorization: Bearer YOUR_API_KEY
```

## Parâmetros de rota

<ParamField path="id" type="string" required>
  UUID da entidade na Gu1 (na API o path param se chama `entityId`).
</ParamField>

## Resposta

Envelope: `{ "success": true, "data": { ... } }`.

### Quando há dados (`hasEnrichmentData: true`)

<ResponseField name="entityId" type="string">
  UUID da entidade.
</ResponseField>

<ResponseField name="hasEnrichmentData" type="boolean">
  `true` quando existe uma linha de snapshot atual.
</ResponseField>

<ResponseField name="status" type="string">
  Status do snapshot (em geral `completed`).
</ResponseField>

<ResponseField name="lastExecutedAt" type="string">
  Timestamp ISO 8601 do último enrichment que atualizou este snapshot.
</ResponseField>

<ResponseField name="lastExecutedBy" type="string">
  UUID do usuário que disparou a última execução, ou `"system"`.
</ResponseField>

<ResponseField name="lastExecutionDurationMs" type="number">
  Duração da última execução em milissegundos, quando registrada.
</ResponseField>

<ResponseField name="mapped" type="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.
</ResponseField>

<ResponseField name="raw" type="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.
</ResponseField>

<ResponseField name="providersUsed" type="array">
  Códigos de integração presentes neste snapshot. O nome do campo JSON é `providersUsed`.
</ResponseField>

<ResponseField name="summary" type="string">
  Resumo opcional da última execução.
</ResponseField>

<ResponseField name="normalizedEnrichmentId" type="string">
  UUID da linha de [enrichment normalizado](/pt/api-reference/enrichment/get-normalized) associada, quando existir.
</ResponseField>

<ResponseField name="createdAt" type="string">
  Timestamp ISO 8601 de criação do snapshot.
</ResponseField>

<ResponseField name="updatedAt" type="string">
  Timestamp ISO 8601 da última atualização do snapshot.
</ResponseField>

### Quando a entidade existe mas não há snapshot

HTTP **200** com `hasEnrichmentData: false` (não é 404):

```json theme={null}
{
  "success": true,
  "data": {
    "entityId": "550e8400-e29b-41d4-a716-446655440000",
    "hasEnrichmentData": false,
    "message": "No enrichment data available for this entity"
  }
}
```

Isso é diferente do [enrichment normalizado](/pt/api-reference/enrichment/get-normalized), que responde **404** quando não há linha normalizada.

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

<CodeGroup>
  ```bash cURL theme={null}
  curl -X GET "https://api.gu1.ai/entities/550e8400-e29b-41d4-a716-446655440000/enrichment-data" \
    -H "Authorization: Bearer YOUR_API_KEY"
  ```

  ```javascript JavaScript theme={null}
  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();
  ```

  ```python Python theme={null}
  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())
  ```
</CodeGroup>

```json theme={null}
{
  "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](/pt/api-reference/enrichment/get-normalized) — dossiê canônico da Gu1
* [Executar enrichment](/pt/api-reference/enrichment/execute-by-id) — executar integrações
* [Obter entidade](/pt/api-reference/entities/get) — identidade, status e score de risco
* [Códigos de integração](/pt/api-reference/integrations/provider-codes) — códigos usados como chaves em `mapped` / `raw`