API Documentation

Integrate SMS-Host virtual numbers directly into your application using our simple and powerful API.

All API requests should be sent using HTTPS. Keep your API key private and never expose it inside client-side code.

Authentication

Every API request requires your API key.

Request Header

Authorization: Bearer YOUR_API_KEY

Purchase a virtual number for the selected service and country.

GET/api/get-number

Parameter	Type	Required	Description
api_key	string	Required	Your API key
service	string	Required	Service name
country	string	Required	Country code

Example Request

GET /api/get-number?api_key=YOUR_API_KEY
&service=whatsapp
&country=92

JSON Response

{
    "status": "success",
    "id": "123456",
    "number": "+923001234567",
    "country": "Pakistan",
    "service": "whatsapp"
}

Retrieve the latest SMS received on an active number.

GET/api/get-sms

Parameter	Type	Required	Description
api_key	string	Required	Your API key
id	string	Required	Activation ID

Example Request

GET /api/get-sms?api_key=YOUR_API_KEY
&id=123456

Cancel an active number and release the activation.

POST/api/cancel

Example Request

POST /api/cancel
api_key=YOUR_API_KEY
id=123456

Check your current account balance.

GET/api/balance

Example Request

GET /api/balance?api_key=YOUR_API_KEY

JSON Response

{
    "status": "success",
    "balance": 25.50,
    "currency": "USD"
}

Code	Status	Description
200	Success	Request completed successfully.
400	Bad Request	Invalid parameters.
401	Unauthorized	Invalid API key.
404	Not Found	Requested resource was not found.
429	Too Many Requests	Rate limit exceeded.
500	Server Error	Internal server error.