SUsugra
Research

Official statistics series for one place

Changed on

Returns the series of one indicator for one place, as published by one agency, in date order. Places are given by open codes: ISO 3166-1 alpha-3 for countries (USA), ISO 3166-2 for regions (IN-MH), FIPS for US states and counties (06, 06037), NUTS for European regions (DE11), zcta:94043 for US ZIP code areas, or a code returned by /places/resolve. Without agency the first agency with data is used; projections and model estimates are never served. The agency, its website and its method are in data.source.

get/api/v1/statistics/series/{indicator}

Request

  • Base URL
    https://sugra.ai
  • URL
    https://sugra.ai/api/v1/statistics/series/{indicator}
  • Auth
    API key in header x-api-key

Path parameters

indicatorstring required

Sugra indicator code.

Example:median-household-income

Query parameters

placestring required

Place code.

Example:06037
startstring nullable

First period to include: 2020, 2020-06 or 2020-06-30.

Example:2015
endstring nullable

Last period to include: 2024, 2024-06 or 2024-06-30.

Example:2024
agencystring nullable

Agency code from /indicators/{indicator}.

Example:census-bureau

Response

Series of the indicator for the place, with the publishing agency.

Example response

{
  "data": {
    "indicator": "median-household-income",
    "name": "Median household income",
    "unit": "USD",
    "period": "annual",
    "place": {
      "id": "06037",
      "code_system": "fips",
      "name": "Los Angeles County",
      "type": "county",
      "country": "USA"
    },
    "source": {
      "id": "census-bureau",
      "name": "U.S. Census Bureau",
      "url": "https://www.census.gov/",
      "method": "ACS 5-year estimate"
    },
    "observations": [
      {
        "date": "2024"
      }
    ]
  },
  "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