---
title: "List Accounts"
method: GET
path: "/accounts"
tags: ["Accounts"]
---

# List Accounts

`GET /accounts`

List all payroll accounts. 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.
- `connected` boolean — If included, filter on connected accounts. If true, return only accounts that are connected. If false, return only accounts that are disconnected. Connected accounts are accounts for which you can retrieve new data manually using On Demand Updates or automatically via Monitoring.
- `monitoring_status` 'active' | 'degraded' | 'user_action_required' | 'customer_disabled' | 'unavailable' — Monitoring status describes the the automated ability of Pinwheel to retrieve new account information.

## 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` PayrollAccountObjResponse[], required

---

[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)