---
title: "Get payout"
method: GET
path: "/payment/v1/payouts/{transactionReference}"
tags: ["Fiat Payments"]
deprecated: true
---

# Get payout

`GET /payment/v1/payouts/{transactionReference}`

## Request

- Base URL: `https://api.sandbox.bvnk.com`
- URL: `https://api.sandbox.bvnk.com/payment/v1/payouts/{transactionReference}`
- Auth: API key in header `Authorization`
- TypeScript: <https://skmtc.dev/bvnk/apis/bvnk-api-endpoints/docs/payment/v1/payouts/:transactionReference/get.ts> (a function with typed inputs; its response is checked against the schema)

> **Deprecated.**

Retrieves a specific payout.

You can also use this endpoint to check the status of the crypto or fiat payout.

**Note**: The PENDING_APPROVAL status is only relevant for **fiat payouts**.

## Path parameters

- `transactionReference` string, uuid, required

## Response `200`

OK

- UnifiedPayoutResponse
  - `transactionReference` string, uuid: Unique identifier for the transaction.
  - `paymentReference` string: Unique payment reference used to link a transaction to a specific customer or use case. The value is visible to the beneficiary.
  - `amount` Money
    - `value` number, float, required: Transfer amount in major currency units.
    - `currency` 'USD' | 'EUR' | 'GBP', required: Three-letter ISO-4217 currency code.
  - `fee` Money
    - `value` number, float, required: Transfer amount in major currency units.
    - `currency` 'USD' | 'EUR' | 'GBP', required: Three-letter ISO-4217 currency code.
  - `walletId` string: Identifier for your debit wallet associated with the transaction.
  - `status` 'PENDING_APPROVAL' | 'PROCESSING' | 'COMPLETED' | 'FAILED' | 'CANCELLED' | 'RETURNED' | 'ON_HOLD': The status of the transaction. The PENDING_APPROVAL status is only relevant for **fiat payouts**.
  - `createdAt` string, date-time: Timestamp when the transaction was created.
  - `details` UnifiedPayoutDetails
    - `type` 'FIAT' | 'CRYPTO': Type of the payout.
    - `beneficiary` object
      - `entityType` 'INDIVIDUAL' | 'COMPANY': The type of entity, either INDIVIDUAL or COMPANY.
      - `companyDetails` CompanyDetails: Details of the company
        - `name` string, required: Name of the company.
      - `individualDetails` IndividualDetails
        - `firstName` string, required: First name of the individual.
        - `lastName` string, required: Last name of the individual.
        - `dateOfBirth` string, required: Date of birth in the 'dd/MM/yyyy' format.
      - `address` object: Address of the recipient.
        - `addressLine1` string: Recipient's primary address line. Typically contains the street name and building number. Do not include the city, country, region/state, or postal code in this field; these values must be provided in their respective dedicated fields.
        - `addressLine2` string: Recipient's secondary address line. Typically contains additional details such as apartment, suite, or floor number. Do not include the city, country, region/state, or postal code in this field; these values must be provided in their respective dedicated fields.
        - `region` string: State or region of the address.
        - `city` string: City of the recipient's address.
        - `countryCode` string: Country code of the recipient's address.
        - `postCode` string: Postal or ZIP code of the recipient's address.
        - `fullAddress` string: Full address.
      - `bankAccount` BankAccount
        - `format` 'SCAN' | 'IBAN' | 'SWIFT' | 'ABA' | 'CUBIX': Format of the bank account number.
        - `bankName` string: Name of the bank associated with the account.
        - `accountNumber` string: Bank account number.
        - `bankCode` string: Bank or branch SWIFT/BIC code.
        - `bankAddress` object: Address of the bank.
          - `addressLine1` string: Primary address line.
          - `addressLine2` string: Secondary address line.
          - `region` string: State or region of the address.
          - `city` string: City of the address.
          - `countryCode` string: Country code.
          - `postCode` string: Postal or ZIP code of the address.
          - `fullAddress` string: Full address.
      - `correspondentBic` string: Correspondent bank BIC code.
  - `metadata` Metadata: Custom metadata key-value pairs. Structure: key: value. Restrictions: - Maximum five keys. - Each key maximum length 50 characters. - Each value maximum length 100 characters. - Keys and values must be simple strings.

## Other responses

- `404`: Not found.

## Changes

- **2026-06-16** `97d6c0d2fe2e`: 1 breaking, 1 warning, 1 info
  - the `details/errors` response's property type changed from `object` to `array` for status `404`
  - removed the optional property `details/errors/requestBody` from the response with the `404` status
  - added the required property `traceId` to the response with the `404` status

[Operation history](https://skmtc.dev/bvnk/apis/bvnk-api-endpoints/changes/payment/v1/payouts/:transactionReference/get.md)

---

[API](https://skmtc.dev/bvnk/apis/bvnk-api-endpoints.md) - [All operations](https://skmtc.dev/bvnk/apis/bvnk-api-endpoints/llms.txt) - [OpenAPI document](https://skmtc.dev/bvnk/apis/bvnk-api-endpoints/revisions/c386d436bf2c?raw)