geographies

Series For Geography

Every series that can say something about this area, split by whether it can honestly be attributed to it.

stat_key: restrict to one stat (e.g. 'crime', 'sale_price'); omit for every dataset this area has. See /api/v1/stats for valid keys. Plain default (not Query(...)) deliberately -- this function is also called directly as a plain Python function (county_page()), and a Query(...) object survives unresolved as the literal default in that path, not as None -- confirmed live: it broke county_page() with psycopg2.ProgrammingError: can't adapt type 'Query' the first time this was written the other way. FastAPI still exposes a bare str | None = None non-path parameter as an optional query param on its own.

partial values go in a SEPARATE ARRAY, not merely flagged. A frontend cannot accidentally render them by ignoring a boolean — the separation is structural. See architecture-design.md 4.8.

api-product-consultant, 2026-08-30: an unfiltered call for one populous county (Dublin, every dataset it has any series for) measured ~230,000 characters -- an unreasonable payload for a caller that wants one dataset, human or AI agent alike. stat_key is additive and optional -- omitted, behaviour is byte-for- byte what it always was (confirmed: this function's own internal caller, county_page(), calls it positionally with no stat_key and is unaffected). Filters in SQL, not in Python after the fact -- the point is to never fetch the other stats' rows at all, not just to hide them from the response.

get/api/v1/geographies/{geography_id}/series

Request

  • Base URL: https://statsmapped.com
  • URL: https://statsmapped.com/api/v1/geographies/{geography_id}/series
  • Auth: none declared

Path parameters

geography_idstring required
Example:county:cavan

Query parameters

stat_keystring nullable

Response

Successful Response

countrystring

Changes

No recorded changes to this operation across all 1 revision of this API.