ZIP Code Business Patterns: establishments of one ZIP
Changed onEstablishments, employment, annual and first-quarter payroll of employer businesses in one 5-digit ZIP from the Census Bureau's ZIP Code Business Patterns (<vintage>/zbp), 1998 to the latest published vintage (the series stops at 2018). zip is required. Earlier vintages publish SIC codes and are 400. The industry variable is renamed per vintage and is resolved from the vintage's own variable list. The geography clause is the vintage's own name (zipcode then zip code). Size classes stay pinned to all establishments. A vintage past the latest is an empty answer with a reason. Do not GET *_LABEL columns. Do not pull every ZIP.
Request
- Base URL: https://sugra.ai
- URL: https://sugra.ai/api/v1/census/business/zip
- Auth: API key in header x-api-key
Query parameters
Vintage year (YYYY, 1998 to the latest published; required).
5-digit ZIP code (required).
00 for all industries (default), a NAICS sector (54, or a range such as 31-33) or a 3-6 digit NAICS code.
Response
One row for the ZIP at the requested NAICS code, all establishments.
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"
}
}Changes
- info
added the optional property
//to the response with the status - info
added the optional property
//to the response with the status
- info
- info
added the non-success response with the status
- info