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

# CPF — Cobertura do corpus

> Arquivos que esta instância Gu1 já terminou de carregar para CPF, e o intervalo de datas de ocorrência.

## Request

```http theme={null}
GET /api/integration-services/ar_gueno_cpf_service/corpus/coverage
```

Sem query nem body. A Gu1 usa o tenant da instância. Não envie `tenant`.

Exige o serviço CPF ativo na organização e `services:execute`. **Cobrança:** não é cobrado. As consultas não são limitadas por este intervalo: `/cuits`, `/accounts` e `/operations` continuam lendo o corpus completo.

Um arquivo aceito com `202` não aparece até a carga terminar. Cargas pendentes, em andamento ou com falha não entram na lista. Um arquivo sem datas de ocorrência entra com `from` e `to` em `null`.

## Response

`loaded` é `true` quando pelo menos um arquivo terminou de carregar. `coverageFrom` e `coverageTo` são a data de ocorrência mais antiga e a mais recente desses arquivos.

```json theme={null}
{
  "success": true,
  "data": {
    "integrationCode": "ar_gueno_cpf_service",
    "tenant": "bdc",
    "service": "cpf",
    "loaded": true,
    "fileCount": 1,
    "coverageFrom": "2024-03-01",
    "coverageTo": "2024-12-20",
    "files": [
      {
        "fileName": "ops-2024.xlsx",
        "r2Key": "bdc/cpf/incoming/ops-2024.xlsx",
        "from": "2024-03-01",
        "to": "2024-12-20",
        "records": 840,
        "finishedAt": "2026-10-28T14:02:00.000Z"
      }
    ]
  }
}
```

Se não houver cargas concluídas, `loaded` é `false`, `fileCount` é `0`, as datas são `null` e `files` é `[]`.

## Erros

| HTTP | `error.code` | Quando |
| - | - | - |
| 400 | `invalid_tenant` | Esta instância não está habilitada para ler a cobertura |
| 503 | `TENANT_SLUG_REQUIRED` | Esta instância não está configurada para ler o corpus |
| 503 | `SERVICE_UNAVAILABLE` | O serviço não está disponível |


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.