---
title: "Get an employer"
method: GET
path: "/employers/{id}"
tags: ["Employers"]
---

# Get an employer

`GET /employers/{id}`

## Request

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

Returns a single employer with their company memberships and pending claims. Requires `employers.read`.

## Path parameters

- `id` string, required: The employer id.

## Response `200`

Successful response.

- Employer
  - `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/:id/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)