Skip to main content
GET
/
customers
/
transactions
/
by_ref_id
/
{reference_id}
Fetch transactions by reference ID
curl --request GET \
  --url https://api-staging.stablestack.com/api/customers/transactions/by_ref_id/{reference_id} \
  --header 'x-api-key: <x-api-key>'
{
  "status": "success",
  "data": [
    {
      "id": "790ddbf6-b145-4d43-bd13-93b05cc202a2",
      "sender_wallet_id": "6684cc88-7434-4a0e-bc2c-abee383368b7",
      "receiver_wallet_id": null,
      "transaction_id": "X2APAWCOE6",
      "asset_code": "USDC",
      "amount": "1.00000000",
      "reference_id": "980ddbf6-b145-4d43-bd13-93b05cc202a2",
      "status": "COMPLETED",
      "created_at": "2025-04-02T22:06:03.507Z",
      "updated_at": "2025-04-02T22:06:03.507Z",
      "crypto_transaction_id": null,
      "network": null,
      "transaction_type": "INTERNAL TRANSFER",
      "transaction_mode": "DEBIT",
      "exchange_rate": null,
      "withdrawal_recipient_name": null,
      "fee": null,
      "balance": "0.00000000",
      "reason": null,
      "customer_id": null,
      "recipient_currency": null,
      "recipient_country": null,
      "bank_name": null,
      "bank_code": null,
      "address": null,
      "bank_account": null
    }
  ]
}
Retrieves detailed information about a specific transaction using its unique reference ID.

​
Key Features:

  • Returns complete transaction details including sender/receiver information
  • Provides status and timestamp information
  • Includes all relevant financial details (amount, fees, exchange rate)
  • Shows transaction type and mode
  • Returns bank details for payout transactions

​
Path Parameters:

  • reference_id: The unique reference ID to retrieve (string, required). e.g 980ddbf6-b145-4d43-bd13-93b05cc202a2

Headers

​
x-api-key
string
required

Path Parameters

​
reference_id
string
required

Response

Transactions retrieved successfully

​
status
string
Example:

"success"

​
data
object[]