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

# POST /v1/intersections

> Lista áreas de referência que sobrepõem uma geometria.

Endpoint de descoberta: envie um polígono, receba toda área de
referência que o intersecta, com área e frações de sobreposição.

## Request

```json theme={null}
{
  "input": {
    "geometry": {
      "type": "Polygon",
      "coordinates": [[[-60,-3],[-60,-2],[-59,-2],[-59,-3],[-60,-3]]]
    },
    "crs": "EPSG:4326"
  },
  "reference_areas_source": "icmbio_ucs_federais",
  "reference_areas_country_iso3": "BRA",
  "reference_id": "deal-12345"
}
```

| Campo                          | Obrigatório | Notas                                                        |
| ------------------------------ | ----------- | ------------------------------------------------------------ |
| `input.geometry`               | sim         | GeoJSON. Precisa ser válido.                                 |
| `input.crs`                    | não         | CRS de origem. Default: `EPSG:4326`.                         |
| `reference_areas_source`       | não         | Restringe a um source. Omita para consultar todos.           |
| `reference_areas_country_iso3` | não         | Filtra sources por país (ISO 3166-1 alpha-3).                |
| `reference_id`                 | não         | Id de correlação fornecido pelo cliente, ecoado na resposta. |

## Response

```json theme={null}
{
  "data": {
    "intersections": [
      {
        "source_name": "icmbio_ucs_federais",
        "source_id": "uc-042",
        "name": "Parque Nacional da Amazônia",
        "country_iso3": "BRA",
        "properties": { },
        "overlap_area_m2": 1234567.8,
        "overlap_pct_input": 0.42,
        "overlap_pct_feature": 0.03
      }
    ],
    "reference_areas_check": "ok",
    "reference_id": "deal-12345"
  }
}
```

`reference_areas_check` vale `"ok"` quando todos os sources
responderam, `"failed"` quando uma resposta parcial foi retornada
porque pelo menos um source não pôde ser alcançado.

`overlap_pct_input` é a fração da sua geometria de input coberta
pela feição casada; `overlap_pct_feature` é a fração da feição
casada coberta pelo seu input.