Find a place code by name or coordinates

GET

/api/v1/statistics/places/resolve

Last modified:2026-11-01 18:58:30

Maintainer:Not configured

OperationId:statistics_places_resolve

Returns the place codes that /series and /places accept, from a place name (q) or from coordinates (lat and lon). Each place carries its code, the code system, its name, its type and its country. Coordinates return every place that contains the point, from the smallest up.

Request

Query Params

Header Params

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location 'https://sugra.ai/api/v1/statistics/places/resolve?q=undefined&lat=undefined&lon=undefined' \
--header 'x-api-key:   ABCD314159'

Responses

🟢200OK

application/json

Matching places with their codes.

Bodyapplication/json

Example

{
    "data": {
        "places": [
            {
                "id": "06037",
                "code_system": "fips",
                "name": "Los Angeles County",
                "type": "county",
                "country": "string"
            }
        ]
    },
    "meta": {
        "endpoint": "/api/v1/fred/us/cpi",
        "data_time": "2026-04-16T14:30:00Z",
        "response_time": "2026-04-16T14:30:12Z",
        "provider": "Sugra API v1.0.1",
        "data_age_days": 0,
        "source": "string",
        "attribution": "string",
        "fallback_used": true,
        "fallback_chain": [
            "string"
        ],
        "cached": true,
        "stale": true,
        "stale_since": "string",
        "period": "string",
        "notes": "string"
    }
}

🟠401Unauthorized

🟠422Parameter Error

🟠429

🔴500Server Error

🔴503Service Unavailable

Modified at 2026-11-01 18:58:30

Official statistics series for one place

Official statistics for every place of a type inside a region