Skip to main content
GET
/
v1
/
transactions
/
{id}
Get a transaction by ID or reference
curl --request GET \
  --url https://api.railsfromthecrypt.com/v1/transactions/{id} \
  --header 'X-API-Key: <x-api-key>'
{
  "id": "c17d2777-e604-45e2-b6d5-7743652eadf1",
  "reference": "TXN-2Z82FVYO6BW22RC7",
  "amount_sent": 1000,
  "source_currency": "NGN",
  "amount_received": 0.64,
  "destination_currency": "USDC",
  "rate": "1560.63",
  "fee": "10.00",
  "status": "awaiting_payment",
  "created_at": "2024-01-15T10:30:00Z",
  "recipient": {
    "id": "rec_01J8V9ZP3A7",
    "type": "crypto",
    "name": "Vendor Payment",
    "active": true,
    "details": {
      "network": "Polygon",
      "wallet_address": "0x3fA91D6b84bE2c0BFD7647a92E5B1A2Ec6F8C91e",
      "symbol": "USDT"
    },
    "created_at": "2025-10-10T09:15:21Z"
  },
  "payment_account": {
    "account_number": "1234567890",
    "account_name": "John Doe",
    "bank_name": "Wema Bank"
  },
  "transaction_hash": "0x1234567890abcdef...",
  "failure_reason": "Insufficient funds"
}
Retrieve a specific transaction by its unique ID or reference. Returns detailed information about the transaction including status, amounts, recipient details, and account details.

Headers

​
X-API-Key
string
required

API key for authentication

Path Parameters

​
id
string
required

Transaction ID or reference

Example:

"TXN-4DU24WAE6YIXPM5J"

Response

Transaction retrieved

​
id
string
required

Transfer request ID

Example:

"c17d2777-e604-45e2-b6d5-7743652eadf1"

​
reference
string
required

Transfer request reference

Example:

"TXN-2Z82FVYO6BW22RC7"

​
amount_sent
number
required

Amount to transfer

Example:

1000

​
source_currency
string
required

Currency code

Example:

"NGN"

​
amount_received
number
required

Amount that will be received

Example:

0.64

​
destination_currency
string
required

Destination currency code

Example:

"USDC"

​
rate
string
required

Exchange rate used

Example:

"1560.63"

​
fee
string
required

Transaction fee

Example:

"10.00"

​
status
enum<string>
required

Transfer status

Available options:
awaiting_payment,
expired,
payment_confirmed,
transaction_completed,
cancelled,
refunded,
failed
Example:

"awaiting_payment"

​
created_at
string<date-time>
required

Creation timestamp

Example:

"2024-01-15T10:30:00Z"

​
recipient
object
required

Recipient information

​
payment_account
object
required

Bank account details for NGN payment. Transfer the specified amount to this account to initiate transaction processing. A webhook notification will be sent upon successful payment receipt.

​
transaction_hash
string

Transaction hash after the transaction has been completed.

Example:

"0x1234567890abcdef..."

​
failure_reason
string

Failure reason if the transaction is canceled or fails. This field will be updated with the reason when a transaction fails.

Example:

"Insufficient funds"