# Consultar publicações e cobertura

`GET /v1/meta` · pública, sem chave

Devolve a competência da base RFB e, em data.fontes, o estado de cada conjunto (disponivel, desatualizado ou indisponivel), a cobertura, o período e as datas de coleta e promoção. Consulte antes de interpretar uma busca sem resultados: com o conjunto indisponível ou parcial, nenhum resultado não quer dizer que o fato não existe. data.aviso traz o aviso operacional vigente (manutenção, carga em andamento) ou null.

## Requisição

```bash
curl https://api.fonteza.com.br/v1/meta
```

```python
import requests

resposta = requests.get(
    "https://api.fonteza.com.br/v1/meta",
    timeout=30,
)
resposta.raise_for_status()
dados = resposta.json()
```

## Parâmetros

Esta rota não recebe parâmetros.

## Resposta 200

Competência e disponibilidade das fontes.

- `data` (objeto)
  - `competencia` (string | null)
  - `aviso` (string | null): Aviso operacional vigente, como manutenção ou carga em andamento; null quando não há.
  - `total_linhas` (integer | null)
  - `promovido_em` (string | null (date-time))
  - `snapshot_id` (string | null)
  - `fonte` (array de string)
  - `fontes` (objeto)
    - `rfb` (objeto)
      - `estado` (string): Valores: `disponivel`, `desatualizado`, `indisponivel`.
      - `cobertura` (string): Valores: `completa`, `parcial`, `desconhecida`.
      - `disponivel` (boolean): Verdadeiro para publicação completa e consultável; RFB legada permanece consultável com cobertura desconhecida.
      - `snapshot_id` (string | null)
      - `periodo` (string | null)
      - `coletado_em` (string | null (date-time))
      - `promovido_em` (string | null (date-time))
      - `ultima_tentativa` (string | null (date-time))
      - `ultima_carga_valida` (string | null (date-time))
      - `motivo_atraso` (string | null): Valores: `cadencia_excedida`.
      - `registros` (integer)
      - `registros_visiveis` (integer | null, opcional)
      - `evidencia` (string | null, opcional): Valores: `fixture_sintetica`, `live_nao_verificada`, `pncp_live_contrato_2026-09-25`, `arquivo_oficial_nao_conciliado`.
      - `contrato_fonte` (string | null, opcional): Valores: `documentado_nao_verificado_live`, `openapi_oficial_capturado`, `dicionario_lote_documentado`.
    - `pncp_oportunidades` (objeto): Disponível somente quando evidência e contrato PNCP formam um par aceito; recorte continua limitado ao snapshot publicado.
      - `estado` (string): Valores: `disponivel`, `desatualizado`, `indisponivel`.
      - `cobertura` (string): Valores: `completa`, `parcial`, `desconhecida`.
      - `disponivel` (boolean): Verdadeiro para publicação completa e consultável; RFB legada permanece consultável com cobertura desconhecida.
      - `snapshot_id` (string | null)
      - `periodo` (string | null)
      - `coletado_em` (string | null (date-time))
      - `promovido_em` (string | null (date-time))
      - `ultima_tentativa` (string | null (date-time))
      - `ultima_carga_valida` (string | null (date-time))
      - `motivo_atraso` (string | null): Valores: `cadencia_excedida`.
      - `registros` (integer)
      - `registros_visiveis` (integer | null)
      - `evidencia` (string | null): Valores: `fixture_sintetica`, `live_nao_verificada`, `pncp_live_contrato_2026-09-25`, `arquivo_oficial_nao_conciliado`.
      - `contrato_fonte` (string | null): Valores: `documentado_nao_verificado_live`, `openapi_oficial_capturado`, `dicionario_lote_documentado`.
    - `transparencia_despesas` (objeto)
      - `estado` (string): Valores: `disponivel`, `desatualizado`, `indisponivel`.
      - `cobertura` (string): Valores: `completa`, `parcial`, `desconhecida`.
      - `disponivel` (boolean): Verdadeiro para publicação completa e consultável; RFB legada permanece consultável com cobertura desconhecida.
      - `snapshot_id` (string | null)
      - `periodo` (string | null)
      - `coletado_em` (string | null (date-time))
      - `promovido_em` (string | null (date-time))
      - `ultima_tentativa` (string | null (date-time))
      - `ultima_carga_valida` (string | null (date-time))
      - `motivo_atraso` (string | null): Valores: `cadencia_excedida`.
      - `registros` (integer)
      - `registros_visiveis` (integer | null, opcional)
      - `evidencia` (string | null): Valores: `fixture_sintetica`, `live_nao_verificada`, `pncp_live_contrato_2026-09-25`, `arquivo_oficial_nao_conciliado`.
      - `contrato_fonte` (string | null): Valores: `documentado_nao_verificado_live`, `openapi_oficial_capturado`, `dicionario_lote_documentado`.
- `meta` (objeto)
  - `fonte` (array de string)
  - `competencia` (string | null, opcional)
  - `snapshot_id` (string | null, opcional)

Exemplo (RFB validada; demais fontes ainda sem carga publicada):

```json
{
  "data": {
    "competencia": "2026-09",
    "total_linhas": 61234567,
    "promovido_em": "2026-10-06T10:00:00Z",
    "snapshot_id": "rfb-2026-09-3f9c2a7d41b8e605",
    "aviso": null,
    "fonte": [
      "RFB/DadosAbertos"
    ],
    "fontes": {
      "rfb": {
        "estado": "disponivel",
        "cobertura": "completa",
        "disponivel": true,
        "snapshot_id": "rfb-2026-09-3f9c2a7d41b8e605",
        "periodo": "2026-09",
        "coletado_em": "2026-10-06T09:00:00Z",
        "promovido_em": "2026-10-06T10:00:00Z",
        "ultima_tentativa": "2026-10-06T08:30:00Z",
        "ultima_carga_valida": "2026-10-06T09:00:00Z",
        "motivo_atraso": null,
        "registros": 61234567
      },
      "pncp_oportunidades": {
        "estado": "indisponivel",
        "cobertura": "desconhecida",
        "disponivel": false,
        "snapshot_id": null,
        "periodo": null,
        "coletado_em": null,
        "promovido_em": null,
        "ultima_tentativa": null,
        "ultima_carga_valida": null,
        "motivo_atraso": null,
        "registros": 0,
        "registros_visiveis": null,
        "evidencia": null,
        "contrato_fonte": null
      },
      "transparencia_despesas": {
        "estado": "indisponivel",
        "cobertura": "desconhecida",
        "disponivel": false,
        "snapshot_id": null,
        "periodo": null,
        "coletado_em": null,
        "promovido_em": null,
        "ultima_tentativa": null,
        "ultima_carga_valida": null,
        "motivo_atraso": null,
        "registros": 0,
        "evidencia": null,
        "contrato_fonte": null
      }
    }
  },
  "meta": {
    "fonte": [
      "RFB/DadosAbertos"
    ]
  }
}
```

## Erros

| Status | Quando | Código |
| --- | --- | --- |
| 503 | Base ainda não disponível. | `base_indisponivel` |