Retrieve Transaction
Retrieve transactions when you need to process them
Retrieve a previously created transaction using its id
.
This returns the same response as a transaction verification except that the transaction id
generated by SwitchApp is used in this case to retrieve the transaction record instead of your payment reference.
Authorizations
Path parameters
idstringRequired
The id of the transaction to retrieve
Responses
200
Returns 200 and the requested transaction
application/json
400
Returns 400 if the query is invalid
401
Returns 401 when authorization details is invalid
404
Returns 404 if a transaction with the specified id is not found
get
GET /v1/transactions/{id} 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-07-06T01:36:29.595Z",
"edited_at": "2025-07-06T01:36:29.595Z"
},
"paid_at": "2025-07-06T01:36:29.595Z",
"created_at": "2025-07-06T01:36:29.595Z",
"edited_at": "2025-07-06T01:36:29.595Z",
"transaction_payout_tags": [
{
"payout_tag": "text",
"amount": 1,
"description": "text",
"metadata": "text"
}
],
"virtual_account_transfer_timeline_entries": [
{
"id": "text",
"action_type": "awaitingProviderResponse",
"action": "text",
"description": "text",
"gateway_code": "text",
"is_live": true,
"created_at": "2025-07-06T01:36:29.595Z",
"edited_at": "2025-07-06T01:36:29.595Z"
}
]
},
"meta": {},
"errors": {
"ANY_ADDITIONAL_PROPERTY": [
"text"
]
},
"is_error": true
}
curl https://api.switchappgo.com/v1/transactions/:transactionId \
-H "authorization: 'bearer sk_test_nTgS42KNdKr6Ts798DT'"
-X GET
Last updated