> ## 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 — Corpus coverage

> Files this Gu1 instance has finished loading for CPF, and the occurrence-date range.

## Request

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

No query or body. Gu1 uses the instance tenant. Do not send `tenant`.

Requires the CPF service enabled for the organization and `services:execute`. **Billing:** free. Lookups are not limited by this range: `/cuits`, `/accounts`, and `/operations` still read the full corpus.

A file accepted with `202` is not listed until loading finishes. Pending, in-progress, and failed loads are omitted. A file with no occurrence dates is listed with `from` and `to` set to `null`.

## Response

`loaded` is `true` when at least one file finished loading. `coverageFrom` and `coverageTo` are the earliest and latest occurrence dates across those files.

```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"
      }
    ]
  }
}
```

When nothing has finished loading, `loaded` is `false`, `fileCount` is `0`, the dates are `null`, and `files` is `[]`.

## Errors

| HTTP | `error.code` | When |
| - | - | - |
| 400 | `invalid_tenant` | This instance is not enabled to read coverage |
| 503 | `TENANT_SLUG_REQUIRED` | This instance is not configured for corpus reads |
| 503 | `SERVICE_UNAVAILABLE` | The service is unavailable |


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