MinatPay API Documentation

Introduction

Welcome to the MinatPay API. You can use our API to access MinatPay endpoints, allowing you to automate data purchases and integrate our services into your application.

With the MinatPay API you can:

Get User Details & wallet balance
Purchase Airtime for all networks
Fetch available Data Plans
Purchase Data Bundles programmatically
Automate transactions for your platform or reseller business

🔑 Authentication & API Access

To use the MinatPay API, you need your API credentials. Here's how to get them:

Login to your MinatPay account
Go to Profile
Navigate to the API tab
Copy your API credentials

Include your API key in the header of every request:

Authorization: Bearer YOUR_API_KEY Content-Type: application/json

🌐 Base URL

All API requests must be made to the following base URL over HTTPS:

https://api.minatpay.com/

Requests made over plain HTTP will be rejected. All responses are returned in JSON format.

Get User Details

Retrieve your account details including wallet balance, username, and API key.

GET https://api.minatpay.com/user Fetch account details

Headers

Authorization: Bearer YOUR_API_KEY Content-Type: application/json

Response

            
{
  "status": "true",
  "message": "USER DETAILS FETCHED",
  "data": {
    "balance": "10,500",
    "username": "Saheed",
    "apikey": "SGFya29uZTokMnkkMTAkd..."
  }
}

Response Fields

Field	Type	Description
balance	string	User wallet balance in Naira
username	string	Your MinatPay account username
apikey	string	Your API key for authentication

Buy Airtime

Purchase airtime for all supported Nigerian networks instantly.

POST https://api.minatpay.com/airtime Purchase airtime

Headers

Authorization: Bearer YOUR_API_KEY Content-Type: application/json

Request Parameters

Parameter	Type	Description
amount	number	Amount to recharge (100 – 5,000)
phone	string	11-digit recipient phone number
airtime_type	string	Must be vtu
network_id	number	1 = MTN, 2 = GLO, 3 = Airtel, 4 = 9mobile

Request Body

            
{
  "amount": 100,
  "phone": "09036155265",
  "airtime_type": "vtu",
  "network_id": 1
}

Success Response

            
{
  "status": "true",
  "message": "Airtime of N100 sent to 09132918811 was successful.",
  "network": "MTN",
  "trx_id": "TRXAPI123456",
  "amount": 100,
  "airtime_type": "VTU",
  "phone": "09132918811"
}

Failed Response

            
{
  "status": "false",
  "message": "Transaction failed. Please try again later."
}

Get Data Plans

Retrieve all available data plans, or filter by a specific network.

GET https://api.minatpay.com/getplans Fetch available plans

Optional Query Parameters

Parameter	Values	Description
network	mtn, glo, airtel, 9mobile	Filter plans by network (optional)

Example Requests

// Get all plans GET https://api.minatpay.com/getplans // Filter by network (MTN) GET https://api.minatpay.com/getplans?network=mtn

Response

            
{
  "status": "true",
  "data": [
    {
      "public_id": "101",
      "network": "mtn",
      "plan": "1GB",
      "type": "SME2",
      "amount_api": "280"
    }
  ]
}

Buy Data

Purchase a data bundle for any supported network. Use the public_id from the Get Data Plans endpoint as your plan_id.

POST https://api.minatpay.com/data Purchase data bundle

Headers

Authorization: Bearer YOUR_API_KEY Content-Type: application/json

Request Parameters

Parameter	Type	Description
plan_id	string	Plan's `public_id` from /getplans
phone	string	11-digit recipient phone number
network	string	Network: mtn, glo, airtel, 9mobile
data_type	string	Plan type e.g. SME2, Gifting, etc.
trx_id	string	Your unique transaction reference

Request Body

            
{
  "plan_id": "10078",
  "phone": "09036155265",
  "network": "mtn",
  "data_type": "SME2",
  "trx_id": "TRX123456"
}

Success Response

            
{
  "status": "true",
  "message": "You have successfully sent 1GB (SME2) to 09036155265"
}

Coming Soon

MinatPay is continuously expanding its API. The following endpoints are in development:

📺

Cable TV API

DSTV, GOtv, Startimes

⚡

Electricity API

All DISCOs supported

💳

Wallet Funding

Top up via API

Want early access? Contact our developer team →

API Documentation

Getting Started

Endpoints

Coming Soon

Support

Introduction

🔑 Authentication & API Access

🌐 Base URL

Get User Details

Buy Airtime

Get Data Plans

Buy Data

Coming Soon