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://vtunaija.com.ng/api/queryDataTransaction/index.php?datarequest_id=4904949180089" \
-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."
}
datarequest_id: This is the unique identifier of the transaction you want to query. It represents the request-id you included in the purchase data request to Vtunaija when you wanted to purchase that specific data transaction via API. This parameter is required and must be included in the URL as a query string (e.g., ?datarequest_id=4904949180089). Remember to replace "4904949180089" with the actual Request-ID that you sent in the purchase data request of the specific data 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.