# 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.

  - `bankReference` (string,null)
    A bank-generated reference that enables your customers to track their payout within the payment network. This feature is only available for specific routes. For details on availability, please contact your Relationship Manager.

  - `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)