Welcome to the Query Transaction API Integration page. This guide will help you integrate our Query Transaction API and see details of transactions you have performed via API or directly on our platform.
curl -X GET "https://sandbox.vtunaija.com.ng/api/queryTransaction/index.php?transaction_id=209129180089" \
-H "Authorization: Token YOUR_API_KEY" \
-H "Content-Type: application/json"
{
"status": "success",
"Status": "successful",
"message": "Transaction retrieved successfully.",
"data": {
"transaction_id": "209129180089",
"transaction_name": "DATA",
"transaction_type": "DataShare3",
"size": "2GB Datashare",
"number": "07011123485",
"network": "MTN",
"amount": "970.00",
"usercommission": "0.00",
"status": "successful",
"api_response": "Y'ello! You have gifted 2GB to 2347011123485...",
"description": "Successful Data Purchase for 07011123485",
"date": "2025-11-20 09:16:36"
}
{
"Status": "failed",
"status": "fail",
"message": "API key provided in the API request does not exist on our platform. Check the api key you provided, make sure it is your correct api key and try again."
}
transaction_id: This is the unique identifier of the transaction you want to query. It represents the Sandbox Vtunaija transaction ID for that specific transaction. The transaction_id is usually sent to you through API messages whenever you purchase any service via the API, and you can also find it in your Sandbox Vtunaija transaction history. This parameter is required and must be included in the URL as a query string (e.g., ?transaction_id=209129180089). Remember to replace "209129180089" with the actual transaction ID of the transaction you wish to query.
Authorization Header: You must include your API key in the request header as Authorization: Token YOUR_API_KEY. Without a valid API key, the request will fail with a 401 Unauthorized response.
Content-Type Header: Always set Content-Type: application/json in your request headers.
transaction_id is required as a GET parameter. All other transaction details are returned in the response JSON.status/Status indicate success or failure, and message provides context.