> ## 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 referencia que solapan una geometría.

Endpoint de descubrimiento: envía un polígono, recibe cada área de
referencia que lo intersecta, con área y fracciones de
solapamiento.

## 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                          | Obligatorio | Notas                                                  |
| ------------------------------ | ----------- | ------------------------------------------------------ |
| `input.geometry`               | sí          | GeoJSON. Debe ser válido.                              |
| `input.crs`                    | no          | CRS de origen. Default: `EPSG:4326`.                   |
| `reference_areas_source`       | no          | Restringe a un source. Omite para consultar todos.     |
| `reference_areas_country_iso3` | no          | Filtra sources por país (ISO 3166-1 alpha-3).          |
| `reference_id`                 | no          | Id de correlación del cliente, ecoado en la respuesta. |

## 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"` cuando todos los sources
respondieron, `"failed"` cuando se devolvió una respuesta parcial
porque al menos un source no pudo alcanzarse.

`overlap_pct_input` es la fracción de tu geometría de input cubierta
por la feature coincidente; `overlap_pct_feature` es la fracción de
la feature coincidente cubierta por tu input.