State Summaries returns state-level summary data in a single GET request. Send an optional limit query parameter to control how many records you receive, up to 100.
Use State Summaries when you need a compact list of geographic or demographic reference data for a dashboard, selector, report, or internal lookup.The response contains the number of returned state summaries, a list of state summary records, and attribution information.
Because the endpoint is designed around summary records, it fits cases where you want a lightweight state dataset rather than a full detail feed. For example, you can populate a dropdown, prefill analytics filters, or cache a small set of state summaries for repeated reads.
The API keeps the request simple: no body, just an optional limit in the query string. That makes State Summaries easy to integrate into read-heavy applications that need a basic state reference endpoint.
Fetch the state summaries list with the default page size.
curl -X GET "http://localhost:8080/dosvak/state-summaries?limit=100" \
-H "apy-token: $APY_TOKEN"Returns a JSON object containing the number of state summaries, a list of state summary records, and attribution details.
{
"count": 2,
"results": [
{
"state_name": "California",
"county_count": 58,
"population_total": "39431263",
"avg_median_household_income": "80794.000000000000",
"avg_poverty_rate": "13.1000000000000000",
"avg_unemployment_rate": "5.4000000000000000"
},
{
"state_name": "Texas",
"county_count": 254,
"population_total": "31290831",
"avg_median_household_income": null,
"avg_poverty_rate": null,
"avg_unemployment_rate": null
}
],
"attribution": [
]
}Loading your default key…Returns a JSON object containing the number of state summaries, a list of state summary records, and attribution details.
| Attribute | Type | Mandatory | Description |
|---|---|---|---|
| limit | Integer | No | Maximum number of items to return. Default: 100. Minimum: 1. Maximum: 100. |
100bad_requestRequired parameter missing or malformed body.
unauthorizedAPI key missing, revoked, or not authorized for this service.
rate_limitedYour plan's per-second rate exceeded. Retry with exponential backoff.
upstream_busyBackend temporarily unavailable. Try again in a few seconds.