Skip to main content
GET
Fetch transactions by customer ID
Retrieves a paginated list of transactions for a specific customer with filtering options.

Key Features:

  • Returns all transactions associated with a customer ID
  • Supports filtering by status, type, mode, currency, and date range
  • Includes search functionality by transaction ID
  • Provides pagination metadata
  • Returns complete transaction details including merchant information

Path Parameters:

  • customer_id: The customer’s unique identifier (UUID, required)

Query Parameters:

  • search: Search by transaction ID (partial or full match)
  • status: Filter by transaction status (PENDING, COMPLETED, FAILED, REVERSED)
  • transaction_type: Filter by type (DEPOSIT, PAYOUT, INTERNAL TRANSFER)
  • transaction_mode: Filter by mode (CREDIT, DEBIT)
  • currency: Filter by currency (USDC, USDT)
  • start_date: Filter by start date (format: YYYY-MM-DD)
  • end_date: Filter by end date (format: YYYY-MM-DD)
  • page: Page number (default: 1)
  • limit: Items per page (default: 20, max: 100)

Headers

x-api-key
string
required

Path Parameters

customer_id
string<uuid>
required

Query Parameters

status
enum<string>
Available options:
PENDING,
COMPLETED,
FAILED,
REVERSED
transaction_type
enum<string>
Available options:
DEPOSIT,
PAYOUT,
INTERNAL TRANSFER
transaction_mode
enum<string>
Available options:
CREDIT,
DEBIT
currency
string
start_date
string<date>
end_date
string<date>
page
integer
Required range: x >= 1
limit
integer
Required range: 1 <= x <= 100

Response

Transactions retrieved successfully

status
string
Example:

"success"

data
any[]
pagination
any