---
title: "List employers"
method: GET
path: "/employers"
tags: ["Employers"]
---

# List employers

`GET /employers`

## Request

- Base URL: `https://api.cavuno.com/v1`
- URL: `https://api.cavuno.com/v1/employers`
- Auth: HTTP bearer

Returns the employers (board users with role `employer`) of the authenticated account, with their approved company memberships and pending claims. Employers with no membership or claim are omitted. Requires `employers.read`.

## Query parameters

- `cursor` string: Pagination cursor.
- `limit` integer: Page size (1–100, default 50).
- `search` string: Case-insensitive substring match on the employer email or display name.

## Response `200`

Successful response.

- object
  - `object` 'list', required
  - `url` string, required
  - `hasMore` boolean, required
  - `nextCursor` string, nullable, required
  - `data` Employer[], required
    - `id` string, required: Unique identifier for the employer.
    - `object` 'employer', required: String representing the object's type.
    - `email` string, required: The employer's email address.
    - `displayName` string, nullable, required
    - `avatarUrl` string, nullable, required
    - `emailVerifiedAt` string, nullable, required
    - `createdAt` string, required
    - `lastActiveAt` string, nullable, required: ISO-8601 timestamp of the last activity on the board (a sign-in or signed-in use), to the hour, or `null`.
    - `deactivatedAt` string, date-time, nullable, required: ISO 8601 timestamp when sign-in was disabled, or `null` when the employer can sign in. Deactivate revokes all sessions and blocks sign-in; company memberships, claims, and jobs are preserved. Reactivate restores sign-in; the employer signs in again to establish a new session.
    - `companies` EmployerApprovedCompany[], required: Approved company memberships.
      - `companyId` string, required
      - `companyName` string, required
      - `status` string, required: Membership status (e.g. `approved`).
      - `approvalSource` string, nullable, required: How the membership was approved (`domain_match` | `work_email_verification` | `admin` | `owner_creation`), or `null`.
      - `joinedAt` string, required: ISO-8601 timestamp the membership was created.
    - `pendingClaims` EmployerPendingClaim[], required: Pending company claims (memberships awaiting approval).
      - `membershipId` string, required
      - `companyId` string, required
      - `companyName` string, required
      - `companyWebsiteDomain` string, nullable, required
      - `workEmail` string, nullable, required
      - `workEmailVerifiedAt` string, nullable, required

## Other responses

- `default`: An error. Every non-2xx response uses the same envelope; see the Errors section of the introduction.

## Changes

- **2026-10-19** `c34152c38176`: 1 info
  - added the optional property `error/upgrade` to the response with the `default` status

[Operation history](https://skmtc.dev/cavuno/apis/cavuno-v1-rest-api/changes/employers/get.md)

---

[API](https://skmtc.dev/cavuno/apis/cavuno-v1-rest-api.md) · [All operations](https://skmtc.dev/cavuno/apis/cavuno-v1-rest-api/llms.txt) · [OpenAPI document](https://skmtc.dev/cavuno/apis/cavuno-v1-rest-api/revisions/d5974dabff14?raw)