Skip to main content
GET
/
bank-transfers
/
{paymentId}
Retrieves a specific bank transfer payment by ID for the authenticated entity.
curl --request GET \
  --url https://api.nuvion.tech/bank-transfers/{paymentId} \
  --header 'Authorization: <authorization>'
{
  "message": "Bank transfer payment retrieved successfully",
  "status": 200,
  "data": {
    "id": "01HJ5G6R7MXW5ZK2QD6YA8N9F3",
    "amount": 150000,
    "currency": "NGN",
    "unique_reference": "TRANS-REF-123456",
    "counterparty_id": "01HJ5G6R7MXW5ZK2QD6YA8N9F4",
    "account_id": "01HJ5G6R7MXW5ZK2QD6YA8N9F5",
    "entity_id": "01HJ5G6R7MXW5ZK2QD6YA8N9F6",
    "status": "successful",
    "status_reason": "payment_completed",
    "narration": "Salary payment for June 2025",
    "type": "outflow",
    "applicable_fee": 1500,
    "meta": {},
    "created": 1692799432000,
    "updated": 1692799532000,
    "initiator": {
      "type": "account",
      "id": "01HJ5G6R7MXW5ZK2QD6YA8N9F5",
      "name": "Operations Account"
    },
    "recipient": {
      "type": "counterparty",
      "id": "01HJ5G6R7MXW5ZK2QD6YA8N9F4",
      "name": "John Doe",
      "issuer": {
        "code": "057"
      },
      "details": {
        "account_number": "1234567890"
      }
    }
  }
}

Headers

​
Authorization
string
required

Authorization header: Bearer {jwt or Secretkey}

Path Parameters

​
paymentId
string
required

The unique identifier (ULID) of the bank transfer payment to retrieve

Query Parameters

​
include_details
string

Flag to include additional details about the initiator and recipient

Response

Successful operation

​
message
string
required

A descriptive message indicating the result of the operation

​
status
string
required

The status of the API operation (successful, error, failed, pending)

​
data
object
required

Contains the details of the retrieved bank transfer