Skip to main content
GET
/
transactions
Get all transactions
curl --request GET \
  --url https://api.orafi.app/v1/transactions \
  --header 'x-api-key: <api-key>'
{
  "success": true,
  "message": "Transactions retrieved successfully",
  "data": {
    "transactions": [
      {
        "id": "tx_abc123",
        "amount": 100,
        "currency": "USDC",
        "status": "CONFIRMED",
        "type": "PAYMENT",
        "fromAddress": "<string>",
        "toAddress": "<string>",
        "txDigest": "<string>",
        "createdAt": "2023-11-07T05:31:56Z",
        "updatedAt": "2023-11-07T05:31:56Z"
      }
    ],
    "count": 123,
    "nextCursor": "<string>",
    "hasNextPage": true
  }
}

Authorizations

​
x-api-key
string
header
required

API key for merchant authentication required for most endpoints

Query Parameters

​
mode
enum<string>

Filter by transaction mode

Available options:
test,
live
​
type
enum<string>

Filter by transaction type

Available options:
PAYMENT,
REFUND,
PAYOUT
​
status
enum<string>

Filter by transaction status

Available options:
COMPLETED,
PENDING,
FAILED
​
customerId
string

Filter by customer ID

​
paymentMethod
enum<string>

Filter by payment method used

Available options:
HOSTED_CHECKOUT,
PAYMENT_LINK
​
currency
string

Filter by currency used to intiate transaction

​
network
string

Filter by network used to initiate transaction

​
paymentLinkId
string

Filter by payment link ID(used only when status is set to PAYMENT)

​
limit
integer

Number of records to return

​
cursor
string

Pagination cursor

​
date
object

Filter transactions by date using either a preset interval or a custom date range.

Preset example: { "type": "preset", "interval": "last7days" }

Range example: { "type": "range", "startDate": "2026-05-01", "endDate": "2026-05-25" }

Response

List of transactions retrieved successfully

​
success
boolean
Example:

true

​
message
string
Example:

"Transactions retrieved successfully"

​
data
object