---
title: "Start a bulk export job"
method: POST
path: "/v1/export"
tags: ["Bulk export"]
---

# Start a bulk export job

`POST /v1/export`

Start a bulk export job. Returns 202 with a job_id to poll.

At least one filter field must be set — unfiltered exports would
scan the entire employer table and are refused.

## Headers

- `X-Api-Key` string

## Request body

- ExportRequest
  - `format` string — Output format: csv or json (NDJSON)
  - `filters` ExportFilters — Filter surface for bulk exports — richer than the interactive search endpoint because enterprise analysts need structured queries (e.g. "top 50K employers by fatality rate with OSHA penalties > $100K in construction NAICS").
    - `name` string — Employer name (fuzzy match)
    - `ein` string — Exact EIN
    - `state` string — Single 2-letter state code
    - `states` string[] — Multiple state codes (OR)
    - `zip` string — 5-digit ZIP code
    - `naics` string — Single NAICS prefix, 2-6 digits
    - `naics_codes` string[] — Multiple NAICS prefixes (OR)
    - `parent_only` boolean — Roll up to one row per parent company
    - `parent_name` string — Limit to locations under this parent
    - `has_fatalities` boolean — Only employers with a fatality investigation on record
    - `svep` boolean — Only employers in OSHA's Severe Violator Enforcement Program
    - `min_inspections` integer — Minimum OSHA inspection count
    - `min_violations` integer — Minimum OSHA violation count
    - `min_penalties` number — Minimum total OSHA penalty dollars
    - `min_fatalities` integer — Minimum fatality count
    - `min_whd_cases` integer — Minimum WHD wage-enforcement case count
    - `min_whd_backwages` number — Minimum WHD back-wages dollars
  - `max_rows` integer — Row cap, 1–100,000
  - `sort_by` string — One of: employer_id, fatalities, inspections, penalties, violations, whd_backwages, whd_cases
  - `sort_dir` string — asc or desc

## Response `202`

Successful Response

- unknown

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/fastdol/apis/fastdol-api.md) · [All operations](https://skmtc.net/fastdol/apis/fastdol-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/fastdol/fastdol-api/revisions/f5a72ed18934/schema)