---
title: "Get a Payout"
method: GET
path: "/payouts/{payout_id}"
tags: ["Payouts"]
---

# Get a Payout

`GET /payouts/{payout_id}`

## Request

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

## Path parameters

- `payout_id` string, required

## Response `200`

An object representing the created Payout.

- PayoutObject
  - `id` string: Unique identifier of the Payout.
  - `merchant_id` string: ID of the sub-merchant or partner this payout belongs to.
  - `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 sub-merchant'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
- `404`: Not found error
- `429`: Rate limit error

---

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