InstaOTP API Documentation

Introduction

The InstaOTP API allows developers to programmatically access virtual phone numbers for OTP verification services. This RESTful API returns responses in plain text format for easy integration.

All API requests are made as HTTP GET requests to the base URL with required parameters. The API uses API key authentication passed as a query parameter.

Response Format

Successful API responses follow a specific format with a status prefix:

ACCESS_NUMBER:12345:+1234567890
ACCESS_BALANCE:54.00
STATUS_OK:54321

Error responses typically begin with "ERROR_" or "BAD_" prefixes.

Authentication

All API requests require authentication using your API key. The API key should be included as a query parameter in every request.

API Key Parameter

Parameter	Type	Required	Description
`api_key`	String	Yes	Your unique API key for authentication

Example Request

https://instaotp.in/api/v1/handler_api.php?api_key=YOUR_API_KEY&action=getBalance

API Endpoints

GET /?action=getBalance

Check Wallet Balance

Retrieve the current balance of your InstaOTP account.

Parameters

Parameter	Type	Required	Description
`api_key`	String	Yes	Your API key

Response

Returns your current balance in the format: ACCESS_BALANCE:XX.XX

Example Request

Example Response

https://instaotp.in/api/v1/handler_api.php?api_key=abc123def456&action=getBalance

ACCESS_BALANCE:54.00

GET /?action=getService

Get Available Services

Retrieve a list of available services with their prices and availability.

Parameters

Parameter	Type	Required	Description
`api_key`	String	Yes	Your API key
`server`	String	No	Filter by server
`country`	String	No	Filter by country

Response

Returns a JSON object with available services and their details.

Example Request

Example Response

https://instaotp.in/api/v1/handler_api.php?api_key=abc123def456&action=getService&country=India

{
  "1": [
    {
      "id": "vk",
      "service": "Вконтакте/VKConnect",
      "price": "3.12",
      "qty": "1052",
      "country": "India",
      "provider": "Tempnum"
    }
  ]
}

GET /?action=getNumber

Get a Virtual Number

Request a virtual number for a specific service.

Parameters

Parameter	Type	Required	Description
`api_key`	String	Yes	Your API key
`service`	String	Yes	The service ID (e.g., "vk")
`country`	String	Yes	The country code (e.g., "India")
`server`	String	Yes	The server identifier

Response

Returns the order ID and phone number in the format: ACCESS_NUMBER:ORDER_ID:PHONE_NUMBER

Example Request

Example Response

https://instaotp.in/api/v1/handler_api.php?api_key=abc123def456&action=getNumber&service=vk&country=India&server=tempnum

ACCESS_NUMBER:12345:+1234567890