---
title: "Get a recipient"
method: GET
path: "/recipients/{recipient_id}"
tags: ["Recipients"]
---

# Get a recipient

`GET /recipients/{recipient_id}`

Retrieves a single recipient by its ID, including lifetime earnings totals (paid, pending, held, in cents) and a summary of their current payment method.

## Path parameters

- `recipient_id` string, uuid, required

## Response `200`

The recipient.

- 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.

## Other responses

- `401` — Missing or invalid API key.
- `404` — The requested resource was not found.

---

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