API Documentation

Programmatic OTP Interception

Welcome to the premium developer reference of the MINO SMS OTP platform. Our APIs are designed to be fast, and resilient, allowing developers to query virtual numbers, read signal logs, and fetch success metrics programmatically.

Production Endpoint Base URL: https://minosms.com/

Authentication Credentials

Every endpoint request must verify authentication credentials using your private API access key. Generate, copy, or refresh your access token directly inside your user profile dashboard.

Credentials can be verified through either of these standard transmission methods:

Method A: URL Parameter

Append credentials directly as a query parameter in your URL stream.

?api_key=your_private_api_key

Method B: HTTP Headers

Transmit credentials securely within your HTTP request headers.

X-MINO-API-KEY: your_private_api_key

API Rate Limiting & Cooldowns

To prevent server resource exhaustion and spam behaviors, unapproved API keys are strictly rate-limited:

8-Second Cooldown Rule: Unapproved developer keys must observe an 8.0-second delay between phone number request allocations. Approved API keys are exempt from this limitation.

POST

/getnumber

Request and allocate a fresh virtual number from targeted mobile operator ranges instantly.

Request Parameters:

Field	Type	Required	Description
api_key	string	Yes	Your private developer API authentication key.
rid	string	Yes	Target operator range code (e.g. 2250789XXX).
national_format	string	Optional	Set to `1` for local local formatting. (Default: 1)
remove_plus	string	Optional	Set to `1` to strip the (+) country code prefix. (Default: 1)

GET

/check

Check active virtual booking details to capture and intercept the incoming SMS confirmation token code.

Recommended Polling Practice: Developers are suggested to poll this endpoint once every 3.0 to 5.0 seconds until allocation_status completes or expires (18m lifetime timeout).

Query Parameters:

Field	Type	Required	Description
api_key	string	Yes	Your private developer API authentication key.
number	string	Yes	Allocated virtual phone number associated with your profile.

GET

/liveaccess

Query active gateway channels, available pricing structures, and routing configurations globally.

GET

/success_otp

Get the latest completed OTP transactions and payout rate records successfully logged under your developer profile.

GET

/console

Monitor active system logging, intercepted signal packets, and newly routing channels online.

curl -X POST "https://minosms.com/getnumber" \ -H "Content-Type: application/json" \ -d '{ "api_key": "your_private_api_key", "rid": "2250789XXX", "national_format": 1, "remove_plus": 1 }'

import requests url = "https://minosms.com/getnumber" payload = { "api_key": "your_private_api_key", "rid": "2250789XXX", "national_format": 1, "remove_plus": 1 } response = requests.post(url, json=payload) print(response.json())

<?php $url = "https://minosms.com/getnumber"; $payload = [ "api_key" => "your_private_api_key", "rid" => "2250789XXX", "national_format" => 1, "remove_plus" => 1 ]; $ch = curl_init($url); curl_setopt($ch, CURLOPT_RETURNTRANSFER, true); curl_setopt($ch, CURLOPT_POST, true); curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode($payload)); curl_setopt($ch, CURLOPT_HTTPHEADER, ['Content-Type: application/json']); $response = curl_exec($ch); curl_close($ch); echo $response; ?>

const fetch = require('node-fetch'); const apiKey = "your_private_api_key"; const number = "22462XXXXXX"; const url = `https://minosms.com/check?api_key=${apiKey}&number=${number}`; fetch(url) .then(res => res.json()) .then(json => console.log(json));

{ "status": "success", "number": "22462XXXXXX", "allocation_status": "completed", "otp_code": "186835", "full_sms": "Your confirmation code is 186835. Use this to verify.", "created_at": "2026-07-14T19:54:00+00:00" }

const fetch = require('node-fetch'); const apiKey = "your_private_api_key"; const url = `https://minosms.com/liveaccess?api_key=${apiKey}`; fetch(url) .then(res => res.json()) .then(json => console.log(json));

const fetch = require('node-fetch'); const apiKey = "your_private_api_key"; const url = `https://minosms.com/success_otp?api_key=${apiKey}`; fetch(url) .then(res => res.json()) .then(json => console.log(json));