---
title: "Get a List of Payers"
method: GET
path: "/v1/payments/payers"
tags: ["Payers"]
---

# Get a List of Payers

`GET /v1/payments/payers`

You can retrieve a list of the Payers you've created by sending a GET request to: /v1/payments/payers

A successful response returns an array that contains identifying information for each of the Payers, including the PayerId, the name of the institution, and the last four digits of the account number.

## Response `200`

- GetPayersResponse
  - `status` ResponseStatus, required
    - `code` number
    - `desc` string
    - `messages` Message[]
      - `desc` string, required
      - `type` 'ERROR' | 'WARN' | 'INFO'
  - `data` PayerResponse[], required
    - `payerId` string, required
    - `userId` string — Will be available only for payerType 'USER'
    - `payerType` 'USER' | 'PARTNER' | 'PLATFORM', required
    - `payerSubType` 'USER' | 'PARTNER' | 'PLATFORM' | 'EMPLOYEE_PAYER' | 'EMPLOYER_PAYER', required
    - `accountLast4Digits` string, required
    - `institutionName` string, required
    - `tokenType` 'PLAID'
    - `verificationStatus` VerificationStatusResponseData
      - `status` 'IN_PROGRESS' | 'UNVERIFIED' | 'VERIFIED' | 'FAILED' | 'ERROR' | 'APPROVED_AWAITING_USER', required
      - `statusUpdateTs` number, required
    - `createdOn` number, required
    - `updatedOn` number, required

## Other responses

- `400` — Bad request response
- `401` — Unauthorized response
- `404` — Not found response
- `500` — Internal server error response

---

[API](https://skmtc.dev/spinwheel/apis/discover.md) · [All operations](https://skmtc.dev/spinwheel/apis/discover/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/spinwheel/discover/revisions/55b90a2e1dd4/schema)