---
title: "List all workers for the authenticated employer"
method: GET
path: "/workers"
tags: ["Workers"]
---

# List all workers for the authenticated employer

`GET /workers`

## Request

- Base URL: `https://app.hireart.com/api/v2`
- URL: `https://app.hireart.com/api/v2/workers`
- Auth: HTTP bearer

## Query parameters

- `page` integer
- `per_page` integer
- `job_id` string

## Response `200`

Successful response

- WorkerList
  - `object` 'list', required
  - `page` integer, required
  - `per_page` integer, required
  - `total_count` integer, required
  - `total_pages` integer, required
  - `data` Worker[], required
    - `object` 'worker', required
    - `id` string, required
    - `full_name` string, nullable
    - `first_name` string, nullable
    - `last_name` string, nullable
    - `email` string, nullable
    - `phone` string, nullable
    - `status` 'active' | 'onboarding' | 'offer' | 'terminated' | 'unknown' | 'null', nullable

## Other responses

- `401`: Unauthorized
- `429`: Rate limit exceeded (100 requests per 60 seconds per API key)
- `500`: Internal server error

---

[API](https://skmtc.dev/hireart/apis/hireart-api.md) - [All operations](https://skmtc.dev/hireart/apis/hireart-api/llms.txt) - [OpenAPI document](https://skmtc.dev/hireart/apis/hireart-api/revisions/41935c8fd584?raw)