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

> Los datasets de referencia contra los cuales tus rulesets y queries hacen match.

Un **source** es un dataset curado — típicamente un registro de
polígonos o una lista de identificadores de subject — usado como
lado derecho de un match. Ejemplos:

* `funai_tis` — registro oficial de tierras indígenas
* `ibama_embargos` — áreas embargadas por infracciones ambientales
* `icmbio_ucs_federais` — unidades de conservación federales
* `ofac_sdn` — lista OFAC SDN de EE. UU.
* `sicar_br` — Catastro Ambiental Rural

## Listando lo que está disponible

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

Devuelve metadata de cada source que tu Organización puede acceder
— nombre, kind, cobertura por país y timestamp del último refresh.

Filtrar por kind:

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

Existen tres kinds:

* **`leaf`** — un source espacial regular.
* **`group`** — una colección virtual que se expande a varias
  leaves; seleccionar un group equivale a consultar todos sus
  miembros.
* **`subject_register`** — source no-espacial, indexado por
  identificadores tipados (CNPJ, EIN, OFAC SDN). Lleva una lista
  `supported_schemes`.

## Actualización

Cada source lleva `collected_at_latest` — el timestamp del último
refresh. Los sources se actualizan en una cadencia apropiada a la
fuente upstream.

Si una fuente upstream está indisponible al momento de la query, el
check afectado se marca como `failed` y el `status` del verdict pasa
a `degraded`. La request aún devuelve 2xx con el resultado parcial,
para que decidas cómo manejarlo.

## Referenciando sources

En un ruleset:

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

En `/v1/intersections` y `/v1/distance` puedes consultar todos los
sources a la vez (default) o restringir a uno específico vía
`reference_areas_source`.