Skip to main content
GET
/
v1
/
transactions
Get all transactions for the current client
curl --request GET \
  --url https://api.railsfromthecrypt.com/v1/transactions \
  --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 all transactions for your account. You can filter transactions by status and date range using query parameters.

Headers

​
X-API-Key
string
required

API key for authentication

Query Parameters

​
status
enum<string>

Filter transactions by status. pending returns transactions with status: awaiting_payment. completed returns all other statuses: expired, payment_confirmed, transaction_completed, cancelled, refunded, failed

Available options:
pending,
completed
​
startDate
string

Filter transactions created on or after this date. Must be in YYYY-MM-DD format (e.g., 2025-11-01)

Example:

"2025-11-01"

​
endDate
string

Filter transactions created on or before this date. Must be in YYYY-MM-DD format (e.g., 2025-11-10). Required if startDate is provided. Must be after startDate.

Example:

"2025-11-10"

​
limit
number

The number of items per page

Example:

10

​
page
number

The page number

Example:

1

Response

Transactions 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"