Concepts
Geo
Geographic entities for filtering
The /geo/* endpoints power the geographic filters of the POST /properties search — property.locations.in.ids (administrative-division UUIDs) and property.locations.in.uniqueCodes (native national codes, e.g. the INSEE code in France). Covered countries: France (FR) and Belgium (BE).
Endpoints
| Endpoint | Purpose |
|---|---|
GET /geo/autocomplete | Autocomplete suggestions for user input |
GET /geo/administrative-divisions/{uuid} | Administrative division detail |
AdministrativeDivision schema
| Field | Type |
|---|---|
id | string (UUID) |
name | string |
uniqCode | string | null |
type | enum | null (COUNTRY, ADMINISTRATIVE_REGION, ADMINISTRATIVE_SUBREGION, MUNICIPALITY_GROUP, MUNICIPALITY, MUNICIPAL_DISTRICT, NEIGHBORHOOD, SUB_MUNICIPALITY, SUB_NEIGHBOURHOOD) |
countryCode | enum | null (FR, BE) |
postalCodes | string[] | null |
centroid | GeoJSON geometry | null |
geometry | GeoJSON geometry | null |