List transactions
Get a paginated transaction list with filtering
Retrieves a paginated list of your payment transactions.
Search parameter to use while filtering the list
The target page to retrieve if available. Minimum value is 1.
Required page size. Acceptable range is from 1 to 100.
Id of the transaction to retrieve
The transaction reference to find
Transaction currency to filter with
The gateway codes used to complete payment
Id of the sale that was made using the transaction
Id of the invoice that was raised for the transaction
Reference of the Dedicated Virtual Account the payment was made to
Flag to only retrieve transactions made via dedicated virtual accounts
Id of the customer used for filtering
The email of the customer used for filtering
Returns 200 and a paged response containing the transactions
Returns 400 if the query is invalid
Returns 401 when authorization details is invalid
GET /v1/transactions HTTP/1.1
Host:
Authorization: YOUR_API_KEY
Accept: */*
{
"status": "success",
"message": "text",
"data": {
"id": "text",
"is_live": true,
"gateway_code": "text",
"tx_ref": "text",
"dedicated_virtual_account_reference": "text",
"currency": "text",
"amount": 1,
"charged_amount": 1,
"amount_settled": 1,
"app_fee": 1,
"merchant_fee": 1,
"bearer": "customer",
"status": "successful",
"metadata": "text",
"redirect_url": "text",
"payment_type": "text",
"is_direct_card_charge": true,
"is_virtual_account_checkout": true,
"is_dedicated_virtual_account_checkout": true,
"device_fingerprint": "text",
"ip": "text",
"narration": "text",
"processor_response": "text",
"auth_model": "text",
"card_pan": "text",
"card_issuer": "text",
"card_country": "text",
"card_type": "text",
"card_expiry": "text",
"bank_trsf_country": "text",
"bank_trsf_bank_code": "text",
"bank_trsf_bank_name": "text",
"bank_trsf_account_number": "text",
"bank_trsf_account_name": "text",
"bank_trsf_swift": "text",
"bank_trsf_iban": "text",
"bank_trsf_session_id": "text",
"title": "text",
"logo_url": "text",
"description": "text",
"customer": {
"id": "text",
"full_name": "text",
"email": "text",
"phone_number": "text",
"address": "text",
"status": "active",
"created_at": "2025-09-10T05:23:48.568Z",
"edited_at": "2025-09-10T05:23:48.568Z"
},
"paid_at": "2025-09-10T05:23:48.568Z",
"created_at": "2025-09-10T05:23:48.568Z",
"edited_at": "2025-09-10T05:23:48.568Z"
},
"meta": {
"page_meta": {
"page_count": 1,
"item_count": 1,
"search": "text",
"page": 1,
"page_size": 1
}
},
"errors": {
"ANY_ADDITIONAL_PROPERTY": [
"text"
]
},
"is_error": true
}
curl -G https://api.switchappgo.com/v1/transactions \
-H "authorization: 'bearer sk_test_nTgS42KNdKr6Ts798DT'" \
-d page='3' \
Last updated