# Retrieve payout details

Endpoint: GET /accountPayouts/{payoutRequestId}
Version: 2025-01-01
Security: BasicAuth

## Path parameters:

  - `payoutRequestId` (string, required)
    Unique payout request ID associated with the original payout. We have returned this in the payout response. PN/PZ/PO prefix plus 6 characters.
    Example: "PZ000N65"

## Header parameters:

  - `WP-CorrelationId` (string)
    A unique identifier used to trace and correlate a request across systems. Must be a GUID.
    Example: "15cd16b2-7b82-41cb-9b11-21be9dacad88"

  - `WP-Timestamp` (string)

  - `WP-Api-Version` (string)
    The version of the API you are using.
    Example: "2025-01-01"

  - `Idempotency-Key` (string)
    A unique key to identify the request. This is used to prevent duplicate processing of the same request.
    Example: "1234567890"

  - `Accept` (string)
    Example: "application/json"

## Response 200 fields (application/json):

  - `paymentId` (string,null)
    Unique identifier associated with the payment. GUID.

  - `paymentDatetime` (string,null)
    Date and time of the payment submission. DateTime ISO 8601.

  - `payeeName` (string,null)
    Complete payee name for the payout. This will be one of (depending on the beneficiary type):
fullName- concatenated value from title + firstName + middleName + lastName
companyName.

  - `sourceCurrency` (string,null)
    ISO 4217 alpha-3 currency code for the remitter account.

  - `sourceAmount` (number)
    Source amount. 18 digit precision including 2 decimal places.

  - `targetCurrency` (string,null)
    Target ISO 4217 alpha-3 currency codes for the payout.

  - `targetAmount` (number)
    Target amount.

  - `paymentState` (string,null)
    State of the payout.
    Enum: "AWAITING_EXECUTION", "NEW", "VALID", "REJECTED", "EXECUTED", "IN_REVIEW", "RFI_IN_PROGRESS", "AWAITING_LIQUIDITY", "COMPLETED", "REVERSED", "FAILED", "INVALID"

  - `bankName` (string,null)
    Name of the payee (beneficiary) bank which the payout is being made to.

  - `bankCode` (string,null)
    Beneficiary bank account bank code.

  - `iban` (string,null)
    Beneficiary IBAN.

  - `estimatedDeliveryDate` (string,null)

  - `outcomeReason` (string,null)

  - `channel` (string,null)
    List of the channels that were sent in the request for this payout.

  - `routedChannel` (string,null)
    The channel that was used to process this payout.

  - `payoutRequestId` (string, required)
    Unique payout request ID associated with a payout submitted through our Account Payouts API. PN/PZ/PO prefix plus 6 characters.

  - `narrative` (string,null)
    Reference that may appear on beneficiary statements.

  - `transactionReference` (string,null)
    Unique reference provided by you.

  - `accountNumber` (string,null)
    Bank Account number.

  - `swiftBic` (string,null)
    Beneficiary bank account SWIFT/BIC.

  - `countryCode` (string,null)
    ISO 3166-1 Alpha-2 country code of the payout destination.

## Response 401 fields (application/json):

  - `errorName` (string,null)

  - `message` (string,null)

  - `validationErrors` (array,null)

  - `validationErrors.jsonPath` (string,null)

## Response 403 fields (application/json):

  - `errorName` (string,null)

  - `message` (string,null)

  - `validationErrors` (array,null)

  - `validationErrors.jsonPath` (string,null)

## Response 404 fields (application/json):

  - `errorName` (string,null)

  - `message` (string,null)

  - `validationErrors` (array,null)

  - `validationErrors.jsonPath` (string,null)

## Response 500 fields (application/json):

  - `errorName` (string,null)

  - `message` (string,null)

  - `validationErrors` (array,null)

  - `validationErrors.jsonPath` (string,null)