Business dynamics: the annual series for one geography
Establishments, firms, employment, job creation and destruction (total, from openings and closings, from continuers), net job creation, establishment entry and exit, firm deaths, and the matching rates, from the Census Bureau's Business Dynamics Statistics (timeseries/bds), 1978 to the latest published year, nationally or for one state. from defaults to the ten years to the latest; a to past the latest year is clamped with a note; a range wholly past it is an empty answer with a reason. Counts are integers, rates are percent of the Davis-Haltiwanger-Schuh denominator (denom), decoded by the variable's own type.
Request
- Base URL: https://sugra.ai
- URL: https://sugra.ai/api/v1/census/business/dynamics
- Auth: API key in header x-api-key
Query parameters
us (national) or state (with state=<postal code>).
State postal code (CA, TX, DC, ...) when geo=state.
First year (YYYY, 1978 or later).
Last year (YYYY); default: the latest published year.
Response
One row per year, oldest first, every measure decoded.
Example response
{
"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"
}
}