Introduction Get User Airtime Get Plans Buy Data Coming Soon

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.

  • Get User Details
  • Purchase Airtime
  • Purchase Data
  • Fetch Available Plans
  • Automate Transactions

🔑 Authentication & API Access

To use the MinatPay API, you need your API credentials.

👉 Where to get your API details:

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

These credentials will be used to authenticate all API requests.

🌐 Base URL

All API requests must be made using the base URL below:

https://api.minatpay.com/

🧠 How It Works

MinatPay API endpoints allow you to:

  • Fetch available data plans (/getplans)
  • Purchase data (/data)

All requests must include proper authentication headers.

Get User Details

This endpoint allows you to retrieve your account details including balance, username, and API key.

Endpoint:

GET https://api.minatpay.com/user

Headers

Authorization: Bearer YOUR_API_KEY Content-Type: application/json

Response

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

Response Fields

Field Description
balance User wallet balance
username Account username
apikey User API key

Buy Airtime

This endpoint allows you to purchase airtime for all supported networks.

Endpoint

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

Headers

Authorization: Bearer YOUR_API_KEY Content-Type: application/json

Request Body

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

Request Parameters

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

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

This endpoint allows you to retrieve available data plans. You can fetch all plans or filter by a specific network.

Endpoint:

GET https://api.minatpay.com/getplans

Optional Query Parameters

You can filter results by network:

Parameter Description
network Filter by network mtn, glo, airtel, 9mobile

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

Endpoint:

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

Headers

Authorization: Bearer YOUR_API_KEY Content-Type: application/json

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

  • Airtime API
  • Cable TV API
  • Electricity API
  • Wallet Funding

MinatPay is continuously expanding its API capabilities.