---
title: US State Summary API
slug: state-summaries
url: https://apyhub.com/dosvak/service/state-summaries
provider: Dosvak LLC
categories: [Geolocation, Standard Data]
tags: [state-data, demographics, reference-data, geolocation, datasets]
auth: api_key
---

# US State Summary API

Get state-level summary records with an optional limit of up to 100. Built for dropdowns, dashboards, and lightweight reference data lookups.

## Endpoints

| Method | URL | Description | Atoms |
| --- | --- | --- | --- |
| GET | `https://api.eu.apyhub.com/dosvak/state-summaries` | What it does Returns a JSON object containing the number of state summaries, a list of state summar… | 100 |

## Examples

### State summaries

#### Quickstart

Fetch the state summaries list with the default page size.

```bash
curl -X GET "https://api.eu.apyhub.com/dosvak/state-summaries?limit=100" \
  -H "apy-token: $APY_TOKEN"
```

#### What you'll get back

Returns a JSON object containing the number of state summaries, a list of state summary records, and attribution details.

```json
{
  "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": [ 
]
}
```

## About

## What it does
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.

## Usage

Base URL: `https://api.eu.apyhub.com` (default region — see
`GET https://apyhub.com/api/public/regions` for the rest).

Authenticate with an ApyHub API key in the `apy-token` header.
Full docs and a live playground: https://apyhub.com/dosvak/service/state-summaries