latestOpenAPI 3.0.22026-08-1451965.7 KB

f5a72ed18934

Employers

Batch lookup (up to 100)

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.

post/v1/employers/batch

Headers

X-Api-Keystring

Request body

Example request

{
  "lookups": [
    {
      "name": "Walmart",
      "state": "ID",
      "zip": "83669"
    },
    {
      "name": "Amazon",
      "state": "CA"
    },
    {
      "name": "Target",
      "zip": "55403"
    }
  ]
}

Response

Successful Response

{"stackTrail":"paths:/v1/employers/batch:post:responses:200:content:application/json:schema","oasType":"schema","type":"unknown"}