---
title: "List Payouts"
method: GET
path: "/payouts"
tags: ["Payouts"]
---

# List Payouts

`GET /payouts`

## Request

- Base URL: `https://app-sandbox.resolvepay.com/api`
- URL: `https://app-sandbox.resolvepay.com/api/payouts`
- Auth: one of:
  - HTTP bearer
  - HTTP basic
- TypeScript: <https://skmtc.dev/resolvepay/apis/resolve-api-reference/docs/payouts/get.ts> (a function with typed inputs; its response is checked against the schema)

## Query parameters

- `filter` string
- `sort` string

## Response `200`

An object with an array of Payouts up to the specified limit.

- PayoutsLists
  - `limit` integer
  - `page` integer
  - `results` PayoutObject[]
    - `id` string: Unique identifier of the Payout.
    - `amount_gross` integer: Total gross amount of all payout transactions
    - `amount_fee` integer: Total fee amount of all payout transactions
    - `amount_net` integer: Total net amount of all payout transactions.
    - `status` 'pending' | 'in_transit' | 'paid' | 'failed' | 'canceled': Current status of the Payout. <br><br> `pending` = the payout is created by Resolve, pending to be sent to our bank. <br> `in_transit` = the payment or payout has been sent to our bank and is pending their execution. <br> `paid` = the payment or payout amount was successfully deposited. <br> `failed` = the payment or payout amount did not successfully deposit. <br> `canceled` = the payment or payout in Resolve's system was not sent to or executed by the bank. <br>
    - `retry_payout_id` string: Payout id being retried.
    - `failed_at` string: Date time of when the Payout failed.
    - `expected_by` string: Date time of when we expect the Payout to reach the participating entity's bank.
    - `transactions_starting_at` string: This value is the earliest value for payout_transaction.created_at AND payout_transaction.payout_id = payout.id.
    - `transactions_ending_at` string: This value is the latest value for payout_transaction.created_at AND payout_transaction.payout_id = payout.id.
    - `canceled_at` string: Date time of when the Payout was canceled.
    - `created_at` string: Date time of when the Payout was created.
    - `updated_at` string: Date time of when the Payout was last updated.

## Other responses

- `400`: Bad request error
- `401`: Unauthorized error
- `429`: Rate limit error

---

[API](https://skmtc.dev/resolvepay/apis/resolve-api-reference.md) - [All operations](https://skmtc.dev/resolvepay/apis/resolve-api-reference/llms.txt) - [OpenAPI document](https://skmtc.dev/resolvepay/apis/resolve-api-reference/revisions/c62edc454aaa?raw)