Skip to main content
GET
Get all transactions for the current client
Retrieve all transactions for your account. You can filter transactions by status and date range using query parameters.

Authorizations

Authorization
string
header
required

JWT access token from POST /v1/auth/token/issue. Send as: Authorization: Bearer <access_token>

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"