List employers

get/v1/employers

Retrieves a paginated list of all employers that the authenticated organization has access to. Use query parameters to filter by name or active status. Results are paginated using page and limit parameters.

Query ParametersExpand Collapse

active_in: optional boolean

Filter by active status

limit: optional number

Items per page (default: 20, max: 100)

minimum1

maximum100

name: optional string

Filter by employer name (partial match)

page: optional number

Page number (default: 1)

minimum1

ReturnsExpand Collapse

id: string

Unique employer identifier with 'empr_' prefix

active: boolean

Whether the employer is currently active in the system

created_at: string

Timestamp when the employer was created

formatdate-time

legal_name: string

Legal business name for compliance and tax purposes

name: string

Display name of the employer

organization_id: string

ID of the parent organization (org_*)

updated_at: string

Timestamp when the employer was last updated

formatdate-time

address: optional object { city, state, street_1, 3 more }

Nested address within EmployerSerializer.

city: string

City name

state: string

Two-letter state code (e.g., CA, NY)

street_1: string

Primary street address

zip_code: string

ZIP code (5 or 9 digit)

country: optional string

Country code (default: US)

street_2: optional string

Secondary street address (apt, suite, etc.)

ein: optional string

Employer Identification Number (masked in responses)

eligibility_policy_id: optional string

ID of the benefit eligibility policy (epol_*), if assigned

List employers

curl https://api.vitablehealth.com/v1/employers \
    -H "Authorization: Bearer $VITABLE_connect_API_API_KEY"

[
  {
    "id": "id",
    "active": true,
    "created_at": "2019-12-27T18:11:19.117Z",
    "legal_name": "legal_name",
    "name": "name",
    "organization_id": "organization_id",
    "updated_at": "2019-12-27T18:11:19.117Z",
    "address": {
      "city": "city",
      "state": "state",
      "street_1": "street_1",
      "zip_code": "zip_code",
      "country": "country",
      "street_2": "street_2"
    },
    "ein": "ein",
    "eligibility_policy_id": "eligibility_policy_id"
  }
]

Returns Examples

[
  {
    "id": "id",
    "active": true,
    "created_at": "2019-12-27T18:11:19.117Z",
    "legal_name": "legal_name",
    "name": "name",
    "organization_id": "organization_id",
    "updated_at": "2019-12-27T18:11:19.117Z",
    "address": {
      "city": "city",
      "state": "state",
      "street_1": "street_1",
      "zip_code": "zip_code",
      "country": "country",
      "street_2": "street_2"
    },
    "ein": "ein",
    "eligibility_policy_id": "eligibility_policy_id"
  }
]