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

# Sources

> Os datasets de referência contra os quais seus rulesets e queries fazem match.

Um **source** é um dataset curado — tipicamente um registro de
polígonos ou uma lista de identificadores de subject — usado como
lado direito de um match. Exemplos:

* `funai_tis` — registro oficial de terras indígenas
* `ibama_embargos` — áreas embargadas por infrações ambientais
* `icmbio_ucs_federais` — unidades de conservação federais
* `ofac_sdn` — lista OFAC SDN dos EUA
* `sicar_br` — Cadastro Ambiental Rural

## Listando o que está disponível

```bash theme={null}
GET /v1/sources
```

Retorna metadados de todo source que sua Organização pode acessar —
nome, kind, cobertura por país e timestamp do último refresh.

Filtrar por kind:

```bash theme={null}
GET /v1/sources?kind=subject_register
```

Existem três kinds:

* **`leaf`** — um source espacial regular.
* **`group`** — uma coleção virtual que expande para várias leaves;
  selecionar um group é equivalente a consultar todos os seus
  membros.
* **`subject_register`** — source não-espacial, indexado por
  identificadores tipados (CNPJ, EIN, OFAC SDN). Carrega uma lista
  `supported_schemes`.

## Atualização

Cada source carrega `collected_at_latest` — o timestamp do último
refresh. Os sources são atualizados em uma cadência apropriada à
fonte upstream.

Se uma fonte upstream estiver indisponível no momento da query, o
check afetado é marcado como `failed` e o `status` do verdict vira
`degraded`. A request ainda retorna 2xx com o resultado parcial,
para que você decida como tratar.

## Referenciando sources

Em um ruleset:

```json theme={null}
{
  "sets": {
    "protected_overlap": {
      "source": "icmbio_ucs_federais",
      "joins": [{ "intersects": { "target": "$input" } }]
    }
  }
}
```

Em `/v1/intersections` e `/v1/distance`, você pode consultar todos
os sources de uma vez (default) ou restringir a um específico via
`reference_areas_source`.