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.

NOTE: Transactions provide a source of truth for reconciliations. As such, they cannot be deleted. But you may hide or archive them.

Retrieves a transaction with the specified id.

get

Authorizations

Bearer

AuthorizationstringRequired

API Key as Bearer Token

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

/v1/transactions/{id}

HTTPcURLJavaScriptPython

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": "2026-01-17T17:24:05.948Z",
      "edited_at": "2026-01-17T17:24:05.948Z"
    },
    "paid_at": "2026-01-17T17:24:05.948Z",
    "created_at": "2026-01-17T17:24:05.948Z",
    "edited_at": "2026-01-17T17:24:05.948Z",
    "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": "2026-01-17T17:24:05.948Z",
        "edited_at": "2026-01-17T17:24:05.948Z"
      }
    ]
  },
  "meta": {},
  "errors": {
    "ANY_ADDITIONAL_PROPERTY": [
      "text"
    ]
  },
  "is_error": true
}

curl

curl https://api.switchappgo.com/v1/transactions/:transactionId \
    -H "authorization: 'bearer sk_test_nTgS42KNdKr6Ts798DT'"
    -X GET

node