> For clean Markdown of any page, append .md to the page URL. > For a complete documentation index, see https://docs.shimi.cash/api-reference/shimi-api/airtime-data-bills-vtu/list-vtu-transactions/llms.txt. > For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.shimi.cash/_mcp/server. # List VTU Transactions GET https://shimi-waas-api-9493532b9281.herokuapp.com/api/v1/vtu/ Lists your airtime/data/utility/cable TV purchase history. **Query params** (all optional): | Param | Type | Notes | | -------- | ------- | -------------------------------------------------------------------------------- | | `page` | integer | default 1 | | `limit` | integer | default 20, max 100 | | `status` | enum | `PENDING`, `SUCCESS`, `FAILED`, `REVERSED` (case-sensitive; leave empty for all) | | `type` | enum | `AIRTIME`, `DATA`, `CABLE_TV`, `UTILITY` (case-sensitive) | Sorted newest first. `product` is `null` for airtime and utility. Invalid enum values or non-numeric `page`/`limit` are not validated and cause a server error. **Error format:** body validation failures (Joi) return `{ "status": "error", "message": "Validation error", "details": [ ... ] }`; all other errors return `{ "success": false, "message": "..." }`. Money fields (`amount`, `fee`) are Prisma Decimals and are serialized as **strings** (e.g. `"1000"`). Reference: https://docs.shimi.cash/api-reference/shimi-api/airtime-data-bills-vtu/list-vtu-transactions ## Authentication - `Authorization` header (bearer token, required) — Access token from Generate Access Token (valid 15 minutes). ## Request ### Query parameters - `page` (string, optional) - `limit` (string, optional) - `status` (string, optional) - `type` (string, optional) ## Response ### 200 OK - `success` (boolean, optional) - `data` (list of VtuGetResponsesContentApplicationJsonSchemaDataItems, optional) - `meta` (VtuGetResponsesContentApplicationJsonSchemaMeta, optional) ## Errors ### 401 Unauthorized Error Unauthorized - `message` (string, optional) ### 403 Forbidden Error Invalid or expired access token / KYB not approved / Account deactivated - `message` (string, optional) - `code` (string, optional) - `kybStatus` (string, optional) ## Types ### VtuGetResponsesContentApplicationJsonSchemaDataItems - `id` (string, optional) - `type` (string, optional) - `status` (string, optional) - `amount` (string, optional) - `fee` (string, optional) - `narration` (string, optional) - `phoneNumber` (string, optional, nullable) - `cardNumber` (string, optional, nullable) - `entityNumber` (string, optional, nullable) - `idempotencyKey` (string, optional) - `createdAt` (string, optional) - `updatedAt` (string, optional) - `vtuServiceCategory` (VtuGetResponsesContentApplicationJsonSchemaDataItemsVtuServiceCategory, optional) - `product` (VtuGetResponsesContentApplicationJsonSchemaDataItemsProduct, optional, nullable) ### VtuGetResponsesContentApplicationJsonSchemaMeta - `total` (integer, optional) - `page` (integer, optional) - `limit` (integer, optional) - `totalPages` (integer, optional) ### VtuGetResponsesContentApplicationJsonSchemaDataItemsVtuServiceCategory - `name` (string, optional) - `identifier` (string, optional) - `logo` (string, optional) ### VtuGetResponsesContentApplicationJsonSchemaDataItemsProduct - `name` (string, optional) - `validity` (string, optional) - `amount` (string, optional) ## Examples **Response** ```json { "success": true, "data": [ { "id": "cm2z9h1j20011vtx3ab45cd6", "type": "AIRTIME", "status": "SUCCESS", "amount": "1000", "fee": "0", "narration": "Airtime recharge - MTN - 08031234567", "phoneNumber": "08031234567", "cardNumber": null, "entityNumber": null, "idempotencyKey": "3b8e1f2a-6c4d-4a9e-8b7f-2d1c0e9a8b76", "createdAt": "2026-10-04T10:22:31.418Z", "updatedAt": "2026-10-04T10:22:33.105Z", "vtuServiceCategory": { "name": "MTN", "identifier": "MTN", "logo": "https://res.cloudinary.com/shimiwaas/image/upload/v1727700000/vtu/mtn.png" }, "product": null }, { "id": "cm2z9h1j20014vtx9mn01op2", "type": "CABLE_TV", "status": "SUCCESS", "amount": "19000", "fee": "0", "narration": "Cable TV - DStv - DStv Compact - 7034567812", "phoneNumber": null, "cardNumber": "7034567812", "entityNumber": null, "idempotencyKey": "c41d9e7a-0f2b-4d3c-a8e6-5b9f1c2d3e4a", "createdAt": "2026-10-03T16:05:12.330Z", "updatedAt": "2026-10-03T16:05:15.871Z", "vtuServiceCategory": { "name": "DStv", "identifier": "DSTV", "logo": "https://res.cloudinary.com/shimiwaas/image/upload/v1727700000/vtu/dstv.png" }, "product": { "name": "DStv Compact", "validity": "1 month", "amount": "19000" } } ], "meta": { "total": 2, "page": 1, "limit": 20, "totalPages": 1 } } ``` **SDK Code** ```python 200 Success import requests url = "https://shimi-waas-api-9493532b9281.herokuapp.com/api/v1/vtu/" querystring = {"limit":"20","page":"1","status":"SUCCESS","type":"AIRTIME"} headers = {"Authorization": "Bearer "} response = requests.get(url, headers=headers, params=querystring) print(response.json()) ``` ```javascript 200 Success const url = 'https://shimi-waas-api-9493532b9281.herokuapp.com/api/v1/vtu/?limit=20&page=1&status=SUCCESS&type=AIRTIME'; const options = {method: 'GET', headers: {Authorization: 'Bearer '}}; try { const response = await fetch(url, options); const data = await response.json(); console.log(data); } catch (error) { console.error(error); } ``` ```go 200 Success package main import ( "fmt" "net/http" "io" ) func main() { url := "https://shimi-waas-api-9493532b9281.herokuapp.com/api/v1/vtu/?limit=20&page=1&status=SUCCESS&type=AIRTIME" req, _ := http.NewRequest("GET", url, nil) req.Header.Add("Authorization", "Bearer ") res, _ := http.DefaultClient.Do(req) defer res.Body.Close() body, _ := io.ReadAll(res.Body) fmt.Println(res) fmt.Println(string(body)) } ``` ```ruby 200 Success require 'uri' require 'net/http' url = URI("https://shimi-waas-api-9493532b9281.herokuapp.com/api/v1/vtu/?limit=20&page=1&status=SUCCESS&type=AIRTIME") http = Net::HTTP.new(url.host, url.port) http.use_ssl = true request = Net::HTTP::Get.new(url) request["Authorization"] = 'Bearer ' response = http.request(request) puts response.read_body ``` ```java 200 Success import com.mashape.unirest.http.HttpResponse; import com.mashape.unirest.http.Unirest; HttpResponse response = Unirest.get("https://shimi-waas-api-9493532b9281.herokuapp.com/api/v1/vtu/?limit=20&page=1&status=SUCCESS&type=AIRTIME") .header("Authorization", "Bearer ") .asString(); ``` ```php 200 Success request('GET', 'https://shimi-waas-api-9493532b9281.herokuapp.com/api/v1/vtu/?limit=20&page=1&status=SUCCESS&type=AIRTIME', [ 'headers' => [ 'Authorization' => 'Bearer ', ], ]); echo $response->getBody(); ``` ```csharp 200 Success using RestSharp; var client = new RestClient("https://shimi-waas-api-9493532b9281.herokuapp.com/api/v1/vtu/?limit=20&page=1&status=SUCCESS&type=AIRTIME"); var request = new RestRequest(Method.GET); request.AddHeader("Authorization", "Bearer "); IRestResponse response = client.Execute(request); ``` ```swift 200 Success import Foundation let headers = ["Authorization": "Bearer "] let request = NSMutableURLRequest(url: NSURL(string: "https://shimi-waas-api-9493532b9281.herokuapp.com/api/v1/vtu/?limit=20&page=1&status=SUCCESS&type=AIRTIME")! as URL, cachePolicy: .useProtocolCachePolicy, timeoutInterval: 10.0) request.httpMethod = "GET" request.allHTTPHeaderFields = headers let session = URLSession.shared let dataTask = session.dataTask(with: request as URLRequest, completionHandler: { (data, response, error) -> Void in if (error != nil) { print(error as Any) } else { let httpResponse = response as? HTTPURLResponse print(httpResponse) } }) dataTask.resume() ```