---
title: "Get payout details"
method: GET
path: "/payments/v2/payouts/{id}"
tags: ["Payouts"]
---

# Get payout details

`GET /payments/v2/payouts/{id}`

## Request

- Base URL: `https://api-sandbox.payretailers.com`
- URL: `https://api-sandbox.payretailers.com/payments/v2/payouts/{id}`
- Auth: one of:
  - HTTP basic
  - API key in header `X-API-Key`

Retrieve detailed information about a specific payout transaction including FX breakdown

## Path parameters

- `id` string, uuid, required

## Response `200`

Payout details retrieved successfully

- object: New fields added to response
  - `id` string, uuid
  - `status` 'PENDING' | 'PROCESSING' | 'COMPLETED' | 'FAILED' | 'CANCELLED'
  - `amount` number, double
  - `currency` string
  - `payoutQuoteId` string, uuid: Associated quote ID if quote was used
  - `fxBreakdown` FxBreakdown
    - `exchangeRate` number, double, required: Final exchange rate applied
    - `components` FxComponents, required
      - `merchantSpreadPercent` number, double, required: Merchant's FX spread percentage
      - `pspSpreadPercent` number, double, required: PSP's FX spread percentage
      - `localTaxPercent` number, double, required: Local tax percentage
      - `operationFeePercent` number, double, required: Operation fee percentage
    - `contexts` FxContexts, required
      - `base` object, required: Amounts in the request/base currency
        - `currency` string, required: ISO 4217 currency code for this context
        - `payoutAmount` number, double, required: Gross payout amount before fees
        - `merchantSpreadAmount` number, double, required: Merchant spread fee amount
        - `pspSpreadAmount` number, double, required: PSP spread fee amount
        - `localTaxAmount` number, double, required: Local tax amount
        - `operationFee` number, double, required: Operation fee amount
        - `netPayoutAmount` number, double, required: Net amount after all fees and taxes
      - `local` object, required: Amounts in the target/local currency
        - `currency` string, required: ISO 4217 currency code for this context
        - `payoutAmount` number, double, required: Gross payout amount before fees
        - `merchantSpreadAmount` number, double, required: Merchant spread fee amount
        - `pspSpreadAmount` number, double, required: PSP spread fee amount
        - `localTaxAmount` number, double, required: Local tax amount
        - `operationFee` number, double, required: Operation fee amount
        - `netPayoutAmount` number, double, required: Net amount after all fees and taxes

## Other responses

- `401`: Unauthorized
- `404`: Payout not found
- `500`: Internal server error

---

[API](https://skmtc.dev/payretailers/apis/payretailers-payout-api.md) - [All operations](https://skmtc.dev/payretailers/apis/payretailers-payout-api/llms.txt) - [OpenAPI document](https://skmtc.dev/payretailers/apis/payretailers-payout-api/revisions/68f20160e615?raw)
