---
title: "Get Single Payer Details"
method: GET
path: "/v1/payments/payers/{payerId}"
tags: ["Payers"]
---

# Get Single Payer Details

`GET /v1/payments/payers/{payerId}`

This API will allow you to get a single payer account details with a given payerId if it exists.

## Path parameters

- `payerId` string, required

## Response `200`

- GetPayerResponse
  - `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)