---
title: "Get Employer"
method: GET
path: "/employers/{employer_id}"
tags: ["Employers and Platforms"]
---

# Get Employer

`GET /employers/{employer_id}`

## Request

- Base URL: `https://api.getpinwheel.com/v1`
- URL: `https://api.getpinwheel.com/v1/employers/{employer_id}`
- Auth: API key in header `X-API-SECRET`
- TypeScript: <https://skmtc.dev/getpinwheel/apis/pinwheel/docs/employers/:employer_id/get.ts> (a function with typed inputs; its response is checked against the schema)

Get an Employer given the employer ID.

## Path parameters

- `employer_id` string, uuid, required: UUID of the employer.

## Headers

- `Pinwheel-Version` '2025-07-08' | '2023-11-22' | '2023-07-18' | '2023-04-18' | '2022-09-09' | '2022-06-22' | '2022-03-02', required

## Response `200`

OK

- object
  - `data` EmployerObjResponse, required
    - `id` string, uuid, required: UUID of the employer.
    - `name` string, required: Name of employer, e.g., Apple, Disney, Walmart.
    - `last_updated` string, date-time, required: ISO 8601 timestamp of the last update to this object.
    - `logo_url` string: The URL of the employer logo.
    - `supported_jobs` string[], required: Array of supported jobs.
    - `fractional_amount_supported` boolean, required: Whether or not the platform accepts decimal values for `direct_deposit_switch`.
    - `amount_supported` boolean, required: Whether a direct deposit job supports specific amount.
    - `min_amount` number: Minimum amount, if any, platform accepts for `direct_deposit_switch`.
    - `max_amount` number: Maximum amount, if any, platform accepts for `direct_deposit_switch`.
    - `min_percentage` integer, required: Minimum percentage allowed for `direct_deposit_switch`.
    - `max_percentage` integer, required: Maximum percentage allowed for `direct_deposit_switch`.
    - `percentage_supported` boolean, required: Whether a direct deposit job supports percentage switching.

## Changes

- **2026-07-31** `372b93d1c20d`: 1 info
  - removed the `paycheck_viewer` enum value from the `data/supported_jobs/items/` response property for the response status `200`

[Operation history](https://skmtc.dev/getpinwheel/apis/pinwheel/changes/employers/:employer_id/get.md)

---

[API](https://skmtc.dev/getpinwheel/apis/pinwheel.md) - [All operations](https://skmtc.dev/getpinwheel/apis/pinwheel/llms.txt) - [OpenAPI document](https://skmtc.dev/getpinwheel/apis/pinwheel/revisions/d1c86ae1189c?raw)