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 key See pricing

API Reference

Base URL: api.vtugate.com

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 buy/verify endpoint to get fully mocked responses — no real transactions, no wallet impact. End a phone/meter/smartcard number in 1111 to simulate a failure (education: set quantity to 999+); 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