# List all employers

Endpoint: GET /api/v1/employers
Version: 0.0.1
Security: bearerAuth

## Query parameters:

  - `page` (number)

  - `per_page` (number)

  - `custom_attributes` (string)
    Stringified JSON to filter employers by custom attributes. Example: {"location": "Boston"}

## Response 200 fields (application/json):

  - `data` (array, required)

  - `data.id` (string, required)

  - `data.name` (string, required)

  - `data.ein` (string,null)

  - `data.dba_name` (string,null)

  - `data.phone` (string,null)

  - `data.employee_count` (number,null)

  - `data.entity_structure` (string,null)
    Enum: "sole_proprietorship", "partnership", "llc", "corporation", "nonprofit", "cooperative", "professional_corporation"

  - `data.naics_code` (string,null)

  - `data.address` (object,null)

  - `data.address.street` (string, required)

  - `data.address.secondary` (string,null)

  - `data.address.city` (string, required)

  - `data.address.state` (string, required)

  - `data.address.zip` (string,null)

  - `data.address.country` (string, required)
    3 letter country code

  - `data.address.full_address` (string,null)

  - `data.custom_attributes` (object, required)
    Custom attribute values

  - `data.active_theme_id` (string,null)

  - `data.created_at` (string, required)

  - `data.updated_at` (string, required)

  - `total` (number, required)

## Response 400 fields (application/json):

  - `message` (string, required)

## Response 401 fields (application/json):

  - `message` (string, required)
    Enum: "Not authorized"