---
title: "Ricerca catastale per comune, foglio e mappale."
method: GET
path: "/api/v2/parcels/search"
---

# Ricerca catastale per comune, foglio e mappale.

`GET /api/v2/parcels/search`

## Request

- Base URL: `https://api.zornade.com`
- URL: `https://api.zornade.com/api/v2/parcels/search`
- Auth: none declared

## Query parameters

- `comune` string, required
- `foglio` string
- `label` string
- `sezione` string
- `limit` integer
- `cursor` string

## Response `200`

Lista di particelle con meta {comune, foglio, label, count, limit, truncated, next_cursor}. `truncated` e' un fatto, non una deduzione, e `next_cursor` nullo significa che la collezione e' finita. Serve davvero: 7843 comuni su 7896 hanno piu' di 100 particelle, quindi la prima pagina da sola non esaurisce quasi mai la ricerca.

- ParcelListResponse: Risposta di lista: data con le particelle e meta descrittivo.
  - `data` ParcelListItem[], required
    - `fid` integer, required
    - `gml_id` string
    - `label` string, required
    - `cadastral_reference` string, nullable
    - `municipality` object, required: Comune catastale della particella. Stessa forma in /parcels/search, /parcels/locate e /parcels/{id}.
      - `code` string: Codice catastale (belfiore), es. H501.
      - `name` string
      - `province` string
      - `region` string
    - `municipality_name` string: Solo il nome del comune, come campo piatto. Comodita' per i consumatori che leggevano municipality come stringa; municipality resta l'oggetto da usare.
    - `area_m2` number, nullable
    - `centroid` object, nullable
      - `lat` number
      - `lng` number
    - `foglio` string
    - `sezione` string: Stringa vuota, "_" oppure la sezione urbana.
  - `meta` object, required
    - `comune` string, nullable
    - `foglio` string, nullable
    - `label` string, nullable
    - `count` integer
    - `limit` integer: Limite applicato alla risposta.
    - `truncated` boolean: true quando la risposta tocca il limite e potrebbero esserci altre particelle: l'elenco non e' completo.

## Other responses

- `400`: Errore con codice e messaggio.

---

[API](https://skmtc.dev/zornade/apis/zornade-api-v2.md) · [All operations](https://skmtc.dev/zornade/apis/zornade-api-v2/llms.txt) · [OpenAPI document](https://skmtc.dev/zornade/apis/zornade-api-v2/revisions/fdd459443083?raw)