GET
/
api
/
v1
/
transactions
/
List Transactions
curl --request GET \
  --url https://hpay-api.host-sl.com/api/v1/transactions/ \
  --header 'api-key: <api-key>'
[
  {
    "id": "trans_123...",
    "wallet_id": "wall_789...",
    "amount": 50.0,
    "currency": "USD",
    "transaction_type": "deposit",
    "status": "completed",
    "created_at": "2025-01-16T10:00:00Z"
  },
  {
    "id": "trans_456...",
    "wallet_id": "wall_012...",
    "amount": 25.0,
    "currency": "SLE",
    "transaction_type": "transfer",
    "status": "completed",
    "created_at": "2025-01-16T11:00:00Z"
  }
]
This endpoint returns a list of all transactions associated with your application. You can filter the results by status, type, date, or search for specific transaction identifiers.

​
Query Parameters

​
status
string
Filter by transaction status (e.g., all, pending, completed, failed).
​
transaction_type
string
Filter by transaction type (e.g., all, deposit, withdrawal, transfer).
​
start_date
string
Filter by start date in ISO format (e.g., 2025-01-01).
​
end_date
string
Filter by end date in ISO format (e.g., 2025-01-31).
​
search
string
Search by transaction ID or reference ID.
​
limit
number
default:"100"
Maximum number of transactions to return (max 1000).
​
offset
number
default:"0"
Number of transactions to skip for pagination.

​
Response

The response is an array of transaction objects.
​
id
string
The unique identifier for the transaction.
​
transaction_type
string
The type of transaction.
​
amount
number
The transaction amount.
​
currency
string
The currency code.
​
status
string
The final or current status.
[
  {
    "id": "trans_123...",
    "wallet_id": "wall_789...",
    "amount": 50.0,
    "currency": "USD",
    "transaction_type": "deposit",
    "status": "completed",
    "created_at": "2025-01-16T10:00:00Z"
  },
  {
    "id": "trans_456...",
    "wallet_id": "wall_012...",
    "amount": 25.0,
    "currency": "SLE",
    "transaction_type": "transfer",
    "status": "completed",
    "created_at": "2025-01-16T11:00:00Z"
  }
]

curl --request GET \
  --url 'https://hpay-api.host-sl.com/api/v1/transactions/?limit=10&status=completed' \
  --header 'api-key: YOUR_API_KEY' \
  --header 'secret-key: YOUR_SECRET_KEY'