---
title: "Check Venmo and PayPal payout status (free)"
method: GET
path: "/get-payment-status"
---

# Check Venmo and PayPal payout status (free)

`GET /get-payment-status`

## Request

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

Reports the state of the Venmo and PayPal payouts this account has sent with `GET /send-payment`. Free: only the payout itself is a paid action.

Three ways to call it: with `payment_id` to fetch one payout, with `recipient_id` (from `GET /payment-recipients`) to list every payout to that saved recipient, or with neither to list every payout this account has sent, newest first.

`state` is `queued` (waiting on account balance), `awaiting-funding` (debited and accepted, but delayed on our side before it reaches the platform, usually until the next business day), `in-process` (dispatched to the platform), `complete`, `failed`, or `cancelled`. `queued`, `awaiting-funding` and `in-process` are the states still in flight; poll every few minutes, or register a webhook with `POST /register-webhook` to be told when a payout completes instead. A payout that has been `in-process` for more than an hour is worth raising with the account owner. `state` is absent on payouts sent before state tracking existed.

Bank payouts are not listed here: follow those with `listBankingTransactions`. Push-to-card transfers are completed by the recipient in the browser and have no server-side state.

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

## Query parameters

- `payment_id` string
- `recipient_id` string

## Response `200`

Returns `{ "payment": PaymentStatus }` when `payment_id` is provided, or `{ "payments": PaymentStatus[] }` (newest first) otherwise.

- union
  - object
    - `payment` PaymentStatus: One Venmo or PayPal payout sent from this account.
      - `id` string: Pass as `payment_id` to fetch this payout on its own.
      - `amount_pre_fees` number: Dollars the recipient receives.
      - `amount_with_fees` number: Dollars debited from the account balance, fee included.
      - `fees_paid` number
      - `platform` 'venmo' | 'paypal'
      - `state` 'queued' | 'awaiting-funding' | 'in-process' | 'complete' | 'failed' | 'cancelled': `queued`, `awaiting-funding` and `in-process` are still in flight. `awaiting-funding` means the payout was debited and accepted but is delayed on our side before it reaches Venmo or PayPal, usually until the next business day. Absent on payouts sent before state tracking existed.
      - `state_updated_at` integer: Milliseconds since the epoch when `state` last changed.
      - `recipient_id` string: The saved recipient this went to, as returned by `GET /payment-recipients`.
      - `recipient_first_name` string
      - `recipient_last_name` string
      - `timestamp` integer: Milliseconds since the epoch when the payout was sent.
      - `timestamp_readable` string
  - object
    - `payments` PaymentStatus[]
      - `id` string: Pass as `payment_id` to fetch this payout on its own.
      - `amount_pre_fees` number: Dollars the recipient receives.
      - `amount_with_fees` number: Dollars debited from the account balance, fee included.
      - `fees_paid` number
      - `platform` 'venmo' | 'paypal'
      - `state` 'queued' | 'awaiting-funding' | 'in-process' | 'complete' | 'failed' | 'cancelled': `queued`, `awaiting-funding` and `in-process` are still in flight. `awaiting-funding` means the payout was debited and accepted but is delayed on our side before it reaches Venmo or PayPal, usually until the next business day. Absent on payouts sent before state tracking existed.
      - `state_updated_at` integer: Milliseconds since the epoch when `state` last changed.
      - `recipient_id` string: The saved recipient this went to, as returned by `GET /payment-recipients`.
      - `recipient_first_name` string
      - `recipient_last_name` string
      - `timestamp` integer: Milliseconds since the epoch when the payout was sent.
      - `timestamp_readable` string

## Other responses

- `401`: Missing or invalid Bearer token
- `403`: Account is frozen. The response includes a `frozen_message` field explaining why.
- `404`: `payment_id` was given and no Venmo or PayPal payout with that id belongs to this account.

---

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