Developer API

Integrate our SMS verification services directly into your applications using our simple and powerful REST API.

Authentication

Use this API Key to authenticate your requests. Pass it as a query parameter <code class='bg-gray-100 dark:bg-gray-900 px-1.5 py-0.5 rounded text-sm font-mono text-primary-600 dark:text-primary-400'>api_key</code> or header <code class='bg-gray-100 dark:bg-gray-900 px-1.5 py-0.5 rounded text-sm font-mono text-primary-600 dark:text-primary-400'>X-API-KEY</code>.

API Status: Online

Endpoint: https://api.authsms.net/api

Your Balance: $0

Endpoints

GET/api/auth/me

Get User Profile

Retrieve your account details and current balance.

Parameters

Name	Type	Required	Description
api_key	string	Required	Your unique API key

Example Request

curl -X GET "https://api.authsms.net/api/auth/me?api_key=YOUR_API_KEY"

Example Response

{
  "success": true,
  "user": {
    "username": "johndoe",
    "email": "john@example.com",
    "balance": 150.5,
    "role": "user"
  }
}

GET/api/sms/services

Get Services List

Get a list of all available services (e.g., WhatsApp, Telegram).

Parameters

Name	Type	Required	Description
country	string	Optional	Filter by country code (e.g., us, gb)
api_key	string	Required	Your unique API key

Example Request

curl -X GET "https://api.authsms.net/api/sms/services?api_key=YOUR_API_KEY&country=value"

Example Response

{
  "success": true,
  "services": [
    {
      "id": "wa",
      "name": "WhatsApp"
    },
    {
      "id": "tg",
      "name": "Telegram"
    }
  ]
}

GET/api/sms/prices

Get Prices

Get price list for a specific service.

Parameters

Name	Type	Required	Description
service	string	Optional	Service code (e.g., wa)
country	string	Optional	Country code (e.g., us)
api_key	string	Required	Your unique API key

Example Request

curl -X GET "https://api.authsms.net/api/sms/prices?api_key=YOUR_API_KEY&service=value&country=value"

Example Response

{
  "success": true,
  "prices": {
    "us": {
      "cost": 1.5,
      "count": 500
    }
  }
}

POST/api/sms/purchase

Purchase Number

Order a new virtual number for verification.

Parameters

Name	Type	Required	Description
serviceCode	string	Required	Service code (e.g., wa)
countryCode	string	Required	Country code (e.g., us)
api_key	string	Required	Your unique API key

Example Request

curl -X POST "https://api.authsms.net/api/sms/purchase?api_key=YOUR_API_KEY" \ 
 -H "Content-Type: application/json" \ 
 -d '{ "serviceCode": "value", "countryCode": "value" }'

Example Response

{
  "success": true,
  "message": "Number purchased successfully",
  "activation": {
    "id": "65a...",
    "activationId": "123456",
    "phoneNumber": "+15551234567",
    "status": "waiting"
  }
}

GET/api/sms/check-status/:activationId

Check/Get SMS

Check the status of an activation and get the received SMS code.

Parameters

Name	Type	Required	Description
activationId	string	Required	ID received from purchase (e.g., 123456)
api_key	string	Required	Your unique API key

Example Request

curl -X GET "https://api.authsms.net/api/sms/check-status/:activationId?api_key=YOUR_API_KEY&activationId=value"

Example Response

{
  "success": true,
  "status": "received",
  "code": "123456",
  "activation": {
    "smsCode": "123456"
  }
}

GET/api/sms/activations

Get Active Orders

List your current active or past number orders.

Parameters

Name	Type	Required	Description
status	string	Optional	Filter status (waiting, received)
page	number	Optional	Page number
api_key	string	Required	Your unique API key

Example Request

curl -X GET "https://api.authsms.net/api/sms/activations?api_key=YOUR_API_KEY&status=value&page=value"

Example Response

{
  "success": true,
  "activations": [
    {
      "id": "...",
      "phoneNumber": "+123...",
      "status": "waiting"
    }
  ]
}

POST/api/sms/cancel/:id

Cancel Order

Cancel an activation and get a refund (within allowed time).

Parameters

Name	Type	Required	Description
id	string	Required	Internal ID of the activation (not activationId)
api_key	string	Required	Your unique API key

Example Request

curl -X POST "https://api.authsms.net/api/sms/cancel/:id?api_key=YOUR_API_KEY" \ 
 -H "Content-Type: application/json" \ 
 -d '{ "id": "value" }'

Example Response

{
  "success": true,
  "message": "Activation cancelled and refunded",
  "refund": 1.5
}