---
title: "Batch lookup (up to 100)"
method: POST
path: "/v1/employers/batch"
tags: ["Employers"]
---

# Batch lookup (up to 100)

`POST /v1/employers/batch`

Batch employer lookup — designed for spreadsheet-style bulk searches.

Each item can include name, ein, employer_id, plus optional location
filters (state, zip, city) to narrow to a specific site.

Up to 100 items processed synchronously. 101-500 returns a job_id
for async polling (coming soon). Max 500 items per request.

Typical usage: underwriter uploads a spreadsheet with company name +
address for each policy they're quoting.

## Headers

- `X-Api-Key` string

## Request body

- BatchLookupRequest
  - `lookups` BatchLookupItem[], required — 1–100 lookup items per synchronous request (use CSV upload for more).
    - `name` string — Employer name (fuzzy match)
    - `ein` string — Exact EIN; dashes optional
    - `employer_id` string — FastDOL employer_id (UUID) for an exact match
    - `state` string — 2-letter state code, to narrow
    - `zip` string — 5-digit ZIP, to narrow
    - `city` string — City, to narrow

## Response `200`

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)