VTUGATEVTUGATE
ServicesHow It WorksPricingAPI Docs
Sign inGet started free

API Documentation

VTUGATE API Reference

Integrate airtime, data bundles, cable TV subscriptions, electricity bills, and education pins into your app or business with one unified Nigerian VTU API. Every endpoint uses HTTPS, accepts application/x-www-form-urlencoded bodies, and returns JSON. Authenticate with a Bearer API key from your dashboard.

Get an API keySee pricing

Account Details

Retrieve your account profile, current wallet balance, KYC status, and any virtual bank accounts assigned to you for wallet funding.

POST/api/v1/accountdetails

Headers

Content-Type: application/x-www-form-urlencoded

Authorization: Bearer {YOUR_API_KEY}

Body Parameters

No body parameters. Send an empty POST.
JSON
{
  "status": true,
  "message": "Account details fetched successfully",
  "data": {
    "business_name": "Acme Ventures",
    "email": "ops@acmeventures.com",
    "phone": "08012345678",
    "wallet_balance": 5240.5,
    "account_status": "active",
    "kyc_status": "approved",
    "date_registered": "2026-01-15 10:32:11",
    "virtual_accounts": [
      {
        "provider": "paystack",
        "bank_name": "wema",
        "acct_num": "1234567890",
        "acct_name": "ACME VENTURES / VTUGATE"
      },
      {
        "provider": "paymentpoint",
        "bank_name": "palmpay",
        "acct_num": "9876543210",
        "acct_name": "ACME VENTURES / VTUGATE"
      }
    ]
  }
}
const response = await fetch('https://api.vtugate.com/api/v1/accountdetails', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/x-www-form-urlencoded',
    'Authorization': 'Bearer YOUR_API_KEY'
  },
  body: new URLSearchParams({

  })
});

const data = await response.json();
console.log(data);

Auth: Include your API key in the Authorization header as a Bearer token.

Rate limit: 60 requests per minute per API key.

HTTPS: All requests must use HTTPS in production.

Sandbox: Swap in your Test API Key (API Keys page) on any endpoint — buy, bulk, status, history, gift cards — to get the same checks and the same responses as live, with no real transactions, no wallet impact and nothing sent to a provider. A sandbox transaction can be looked up afterwards with Transaction Status and Transaction History (using the test key). End a phone / meter / smartcard number in 1111 to simulate a failure (education: the phone number; gift cards: the card code, or the recharge account); anything else simulates success.

Ready to integrate?

Create a free VTUGATE account, activate the services you need, and start making live calls in minutes. No setup fees, no minimum volume commitments.

Create Free Account