Annual Business Survey: employer firms by owner demographics

Employer firms, employment, annual payroll and receipts by owner sex, ethnicity, race and veteran status from the Census Bureau's Annual Business Survey Company Summary (<vintage>/abscs), one vintage year (2017 to the latest published). geo is the nation or one state (state= required). County, metro and congressional district stay out. The industry variable is renamed per vintage (NAICS2017, NAICS2022) and is resolved from the vintage's own variable list. Size, receipts, years-in-business and urban/rural tables stay out: those classifiers are pinned to all firms. A vintage past the latest is an empty answer with a reason. Do not GET *_LABEL columns.

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

Responses

🟢200OK

application/json

One row per owner-demographics combination at the requested geography.

Bodyapplication/json

Example

{
    "data": {
        "year": 0,
        "dataset": "string",
        "geo": "string",
        "state": "string",
        "count": 0,
        "data": [
            {
                "name": "string",
                "state_fips": "string",
                "sex": "string",
                "sex_label": "string",
                "ethnicity": "string",
                "ethnicity_label": "string",
                "race": "string",
                "race_label": "string",
                "veteran": "string",
                "veteran_label": "string",
                "naics": "string",
                "naics_label": "string",
                "firms": 0,
                "emp": 0,
                "payann": 0,
                "receipts": 0,
                "property1": "string",
                "property2": "string"
            }
        ],
        "source": "string",
        "naics": {
            "code": "string",
            "label": "string",
            "variable": "string",
            "property1": "string",
            "property2": "string"
        },
        "reason": "string",
        "property1": "string",
        "property2": "string"
    },
    "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": 0,
        "source": "string",
        "attribution": "string",
        "fallback_used": true,
        "fallback_chain": [
            "string"
        ],
        "cached": true,
        "stale": true,
        "stale_since": "string",
        "period": "string",
        "notes": "string"
    }
}

🟠401Unauthorized

🟠422Parameter Error

🟠429

🔴502Bad Gateway

🔴503Service Unavailable

🔴504Gateway Timeout