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

# List Employers

`GET /employers`

List all employers supported by Link. This is a paginated endpoint; see how Pinwheel implements pagination <a href='https://docs.pinwheelapi.com/docs/pagination-1' target='_blank'>here</a>.

## Query parameters

- `cursor` string — Cursor for the page you want to retrieve.
- `limit` integer — The maximum number of results to return.
- `last_updated` string, date-time — Filter for results updated more recently than `last_updated`. ISO 8601 timestamp.

## 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
  - `meta` PaginationMeta, required
    - `count` integer — Number of objects returned.
    - `next_cursor` string — Pointer to the next page of results.
  - `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.

---

[API](https://skmtc.net/getpinwheel/apis/pinwheel.md) · [All operations](https://skmtc.net/getpinwheel/apis/pinwheel/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/getpinwheel/pinwheel/versions/bf20c4d4c5d3/schema)