Logic-Immo Places API resolves place ids to names. Each result has the display name, level, main postal code, administrative and department codes and the parent chain up to France. It works from id to name only. Text is rejected with 422: use the autocomplete route to turn text into an id. An unknown id is listed in not_found and never resolves to another place.
Run this endpoint
Endpoint
Parameters
Start with the required fields, then add optional filters only when your use case needs them.
Runnable path
1 required parameter needed before sending a request.
string
Required
Place ids from autocomplete or search results, comma separated, up to 20. Example: AD08FR31096.
example
Response Schema
Example response fields are illustrative; inspect the JSON before integrating.
Example response fields
Scan these fields before integrating.
data
meta
success
{
"data": {
"results": [
{
"id": "AD08FR31096",
"name": "Paris",
"parents": [
{
"id": "AD02FR1",
"name": "France",
"type_key": "AD02"
},
{
"id": "AD06FR76",
"name": "Paris",
"type_key": "AD06"
}
],
"type_key": "AD08",
"country_id": "AD02FR1",
"postal_code": "75000",
"department_code": "75",
"administrative_code": "75056"
}
],
"not_found": []
},
"meta": {
"billable": true,
"endpoint_family": "places"
},
"success": true
}Errors
Handle these documented responses before retrying or showing customer-facing failures.
Validation Error
An id is missing, malformed, or more than 20 ids were sent. This response is not billable.
{
"errors": {
"q": [
"The q field is required."
]
},
"message": "The request validation failed"
}Upstream Unavailable
Logic-Immo could not be reached, or returned data that does not match the expected shape. Retry shortly. This response is not billable.
{
"meta": {
"billable": false,
"retryable": true,
"endpoint_family": "places"
},
"error": {
"code": "UPSTREAM_UNAVAILABLE",
"message": "Logic-Immo could not be reached. Please retry shortly."
},
"success": false
}Generate Code with AI
Copy a ready-made prompt with all the endpoint details, parameters, and example responses. Paste it into ChatGPT, Claude, or any AI assistant to instantly generate working code.
Try It Live
Test this endpoint in our interactive playground with real data.