---
title: "List payouts"
method: POST
path: "/payouts/list"
tags: ["Reporting"]
---

# List payouts

`POST /payouts/list`

## Request

- Base URL: `https://www.sandbox.striga.com/api/v1/grid`
- URL: `https://www.sandbox.striga.com/api/v1/grid/payouts/list`
- Auth: API key in header `api-key` and API key in header `Authorization`

Lists cross-border payouts for your application, newest first.

Drafts that were never confirmed (`PENDING_2FA_CONFIRMATION`) are excluded by default — pass that status explicitly if you want to see them. Join `beneficiaryId` against `POST /beneficiaries/list` to resolve recipient details.

All amounts are strings in the smallest unit of their currency: `sendingAmount` in USDC cents, `receivingAmount` in the recipient currency's minor unit (for example centavos for MXN).

## Request body

- object
  - `status` 'PENDING' | 'PROCESSING' | 'COMPLETED' | 'FAILED' | 'EXPIRED' | 'REFUNDED' | 'PENDING_2FA_CONFIRMATION': Lifecycle state of a payout. `PENDING_2FA_CONFIRMATION` payouts are drafts that were never confirmed and are excluded unless you filter for them explicitly.
  - `limit` integer: Page size, 1-100.
  - `offset` integer: Number of records to skip.

## Response `200`

A page of payouts.

- object
  - `payouts` Payout[]
    - `id` string, uuid
    - `status` 'PENDING' | 'PROCESSING' | 'COMPLETED' | 'FAILED' | 'EXPIRED' | 'REFUNDED' | 'PENDING_2FA_CONFIRMATION': Lifecycle state of a payout. `PENDING_2FA_CONFIRMATION` payouts are drafts that were never confirmed and are excluded unless you filter for them explicitly.
    - `beneficiaryId` string, uuid: Recipient this payout was sent to — join against `POST /beneficiaries/list`.
    - `sendingAmount` string: USDC debited from your account, in cents.
    - `sendingCurrency` string
    - `receivingAmount` string: Amount delivered to the recipient, in the smallest unit of `receivingCurrency`.
    - `receivingCurrency` string
    - `exchangeRate` number
    - `fees` number: Fees included in the quote, in USD cents.
    - `feeEstimate` object: Striga fee breakdown applied on top of the quote.
    - `rateDetails` object
    - `amount` string: Original requested amount in ledger cents.
    - `accountId` string: Funding USDC account.
    - `parentWalletId` string
    - `parentApplicationId` string
    - `syncedOwnerId` string
    - `gridCustomerId` string: Grid customer the payout was sent as.
    - `source` object
    - `destination` object
    - `description` string
    - `txHash` string: On-chain funding transaction hash, once available.
    - `expiresAt` string, date-time: Quote expiry. A payout not funded before this time ends up `EXPIRED`.
    - `settledAt` string, date-time: When Grid settled the payout to the recipient.
    - `createdAt` string, date-time
  - `total` integer
  - `limit` integer
  - `offset` integer

## Other responses

- `400`: Invalid `status`, `limit` or `offset`.
- `401`: Missing or invalid `api-key` / HMAC signature.
- `403`: Your application does not have the `LIST_PAYOUTS` permission.

---

[API](https://skmtc.dev/striga/apis/lightspark-grid-global-payments.md) - [All operations](https://skmtc.dev/striga/apis/lightspark-grid-global-payments/llms.txt) - [OpenAPI document](https://skmtc.dev/striga/apis/lightspark-grid-global-payments/revisions/7b0a8cde82ff?raw)