---
title: "List recipients"
method: GET
path: "/recipients"
tags: ["Recipients"]
---

# List recipients

`GET /recipients`

Returns a paginated list of recipients for your organization. Each recipient includes lifetime earnings totals (paid, pending, held, in cents) and a summary of their current payment method.

## Query parameters

- `limit` integer
- `offset` integer

## Response `200`

A paginated list of recipients.

- object
  - `data` Recipient[]
    - `id` string, uuid
    - `firstName` string
    - `lastName` string
    - `email` string, email
    - `nickname` string, nullable
    - `createdAt` string, date-time
    - `onboardingUrl` string, uri, nullable — URL the recipient can use to complete onboarding, or null if already onboarded.
    - `status` 'created' | 'active' | 'missing_tax_form' | 'pending_review' | 'approved_w9' | 'approved_w8' | 'approved_1099_exempt' | 'approved_no_tax_collection' — Lifecycle status of a recipient.
    - `earnings` RecipientEarnings — Lifetime earnings totals for this recipient. Amounts are in cents.
      - `paid` integer — Total paid to date: completed payments plus recorded external payments.
      - `pending` integer — Total on the way: payments created, processing, or in review.
      - `held` integer — Total waiting on recipient action, such as accepting the payout or completing tax info.
    - `paymentMethod` RecipientPaymentMethod — Basic summary of the recipient's current active payout method.
      - `method` 'ACH' | 'PAYPAL' | 'CRYPTOCURRENCY' | 'INTERNATIONAL_BANK' | 'SWIFT' | 'KARAT' — Payout rail used to pay this recipient.
      - `currency` string — ISO currency code the recipient is paid in.
  - `meta` PaginationMeta
    - `total` integer — Total number of matching records.
    - `limit` integer
    - `offset` integer

## Other responses

- `401` — Missing or invalid API key.

---

[API](https://skmtc.net/trykarat/apis/karat-payout-api.md) · [All operations](https://skmtc.net/trykarat/apis/karat-payout-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/trykarat/karat-payout-api/revisions/8941916e3707/schema)