---
title: "List saved Venmo and PayPal recipients (free)"
method: GET
path: "/payment-recipients"
---

# List saved Venmo and PayPal recipients (free)

`GET /payment-recipients`

## Request

- Base URL: `https://laso.finance`
- URL: `https://laso.finance/payment-recipients`
- Auth: API key in header `Authorization`

Lists the Venmo or PayPal recipients this account has paid before, so you can resolve a name your human said ("send $20 to Jane") into the `handle` that `GET /send-payment` takes as its `recipient_id`. Free — only the payout itself is a paid action.

Two different ids are in play. Each entry's `recipient_id` is an opaque saved-entry id: pass it to `POST` and `DELETE /payment-recipients`. Its `handle` is the phone number or email you actually pay: pass that as `recipient_id` to `GET /send-payment`. Passing the saved-entry id to `GET /send-payment` does not send to the saved person.

Use `total_sent` and `last_sent_timestamp` to disambiguate similar names, and confirm with your human rather than guessing between two entries.

Requires a Bearer token from `/auth` or `/get-card`.

## Query parameters

- `platform` 'venmo' | 'paypal', required
- `include_archived` 'true' | 'false'

## Response `200`

The saved recipients for that platform.

- object
  - `user_id` string
  - `platform` 'venmo' | 'paypal'
  - `recipients` object[]
    - `recipient_id` string: Opaque id of this saved entry (for example `aQ3xK9mZpL2vB7nR4tYw`). Pass it as `recipient_id` to `POST` and `DELETE /payment-recipients`. It is not what `GET /send-payment` takes; use `handle` there.
    - `handle` string: What to pay them at: a 10-digit phone number for Venmo, an email address for PayPal. Pass this as `recipient_id` to `GET /send-payment`.
    - `name` string: The recipient's own name on the platform.
    - `display_name` string: The label the account owner chose. Prefer it when confirming a payment back to a human.
    - `status` string
    - `total_sent` number: Total dollars sent to this recipient from this account.
    - `send_count` integer
    - `last_sent_timestamp` integer: Milliseconds since the epoch.

---

[API](https://skmtc.dev/laso/apis/laso-finance-x402-api.md) · [All operations](https://skmtc.dev/laso/apis/laso-finance-x402-api/llms.txt) · [OpenAPI document](https://skmtc.dev/laso/apis/laso-finance-x402-api/revisions/ff8ce20b49ba?raw)