SUsugra
Research

Find a place code by name or coordinates

Changed on

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.

get/api/v1/statistics/places/resolve

Request

  • Base URL
    https://sugra.ai
  • URL
    https://sugra.ai/api/v1/statistics/places/resolve
  • Auth
    API key in header x-api-key

Query parameters

qstring nullable

Place name.

Example:Los Angeles County
latnumber nullable

Latitude in degrees.

Example:34.0522
lonnumber nullable

Longitude in degrees.

Example:-118.2437

Response

Matching places with their codes.

Example response

{
  "data": {
    "places": [
      {
        "id": "06037",
        "code_system": "fips",
        "name": "Los Angeles County",
        "type": "county",
        "country": "USA"
      }
    ]
  },
  "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": 8.532,
    "source": "sugra_crypto",
    "attribution": "Short interest and Reg SHO daily short volume data is owned by and sourced from FINRA (Financial Industry Regulatory Authority).",
    "fallback_chain": [
      "sugra_crypto",
      "sugra_finance"
    ],
    "stale_since": "2026-09-08T12:00:00Z",
    "period": "2026-Q1",
    "notes": "the UKMTO report behind these counts is dated 2026-08-21 and is 11 days old"
  }
}

Changes