API Documentation - securedeal.website

📖 Introduction

This API provides virtual phone numbers for receiving SMS verification codes. Compatible with SMS-Activate protocol and software.

💡 Compatibility: If your software supports SMS-Activate, simply replace the host URL with securedeal.website

Key Features

✅ 180+ Countries

✅ 1000+ Services

✅ Instant SMS Delivery

✅ Competitive Pricing

✅ REST API & SMS-Activate

✅ Number Rental Available

🔗 Base URLs

URLhttps://securedeal.website/stubs/handler_api.php

SMS-Activate compatible endpoint

URLhttps://securedeal.website/api/v1

REST API endpoint

🔑 Authentication

All API requests require an API Key passed as query parameter api_key.

GET /stubs/handler_api.php?api_key=YOUR_API_KEY&action=getBalance

✅ Quick Test:
https://securedeal.website/stubs/handler_api.php?api_key=YOUR_KEY&action=getBalance

💻 Software Setup Instructions

Step 1: Choose any software that supports SMS-Activate.

Step 2: Select SMS-Activate as the SMS reception service.

Step 3: Replace host: https://api.sms-activate.ae → https://securedeal.website

Step 4: Enter your API Key from your account.

💰 Check Balance

GET?action=getBalance

Returns your current account balance.

Parameter	Required	Description
api_key	Yes	Your API key
action	Yes	getBalance

# Request
GET /stubs/handler_api.php?api_key=KEY&action=getBalance

# Response
ACCESS_BALANCE:100.50

📱 Get Phone Number

GET?action=getNumber

Request a phone number for SMS verification.

Parameter	Required	Description	Example
api_key	Yes	API key	-
action	Yes	getNumber	-
service	Yes	Service code	go
country	Yes	Country code	0
operator	No	Mobile operator	any
maxPrice	No	Maximum price	0.50
fixedPrice	No	Use exact maxPrice	true
ref	No	Reference ID	123456
phoneException	No	Exclude prefixes (max 20)	7934,7900

Popular Service Codes

go = Google

wa = WhatsApp

tg = Telegram

fb = Facebook

ig = Instagram

tw = Twitter

ds = Discord

am = Amazon

ms = Microsoft

ap = Apple

Popular Country Codes

0 = USA

1 = Russia

2 = Ukraine

3 = Germany

4 = UK

6 = India

12 = Canada

22 = France

# Request
GET /stubs/handler_api.php?api_key=KEY&action=getNumber&service=go&country=0

# Success
ACCESS_NUMBER:123456789:+1234567890

# No numbers available
NO_NUMBERS

📱 Get Phone Number V2

GET?action=getNumberV2

Same as getNumber but returns JSON with more details.

# Response
{
  "activationId": "123456789",
  "phoneNumber": "+1234567890",
  "activationCost": "0.50",
  "countryCode": "0",
  "canGetAnotherSms": true,
  "timeLeft": 1200
}

📩 Get Activation Status

GET?action=getStatus

Check current activation status and get SMS code.

Parameter	Required	Description
api_key	Yes	API key
action	Yes	getStatus
id	Yes	Activation ID

Possible Responses

Response	Meaning
STATUS_WAIT_CODE	Waiting for SMS
STATUS_WAIT_RETRY:id	Waiting, can use another number
STATUS_WAIT_RESEND:id	Waiting for re-sent SMS
STATUS_OK:123456	✅ SMS received! Code: 123456
STATUS_CANCEL	Activation cancelled

📩 Get Activation Status V2

GET?action=getStatusV2

Returns activation status in JSON format with SMS details and call information.

# Response
{
  "status": "STATUS_OK",
  "sms": {
    "code": "12345",
    "text": "Your verification code is 12345",
    "dateTime": "2025-01-15 10:30:00"
  }
}

⚙️ Change Activation Status

GET?action=setStatus

Manage activation lifecycle.

Parameter	Required	Description
id	Yes	Activation ID
status	Yes	New status code

Status Codes

Code	Action	Description
3	Retry	Request another SMS
6	Complete	Activation successful (code received)
8	Cancel	Cancel activation (refund)

# Cancel activation
GET /stubs/handler_api.php?api_key=KEY&action=setStatus&id=123&status=8

# Response: ACCESS_CANCEL

✅ Finish Activation

GET?action=finishActivation

Complete work with activation.

Parameter	Required	Description
id	Yes	Activation ID

❌ Cancel Activation

GET?action=cancelActivation

Cancel activation purchase.

Parameter	Required	Description
id	Yes	Activation ID

🔄 Reactivate Number

POST?action=reactivate

Reuse a previously successful phone number.

Parameter	Required	Description
id	Yes	Activation ID

💲 Reactivation Price

GET?action=reactivationPrice

Get cost of reactivating a number.

Parameter	Required	Description
id	Yes	Activation ID

📋 Active Activations

GET?action=getActiveActivations

Returns list of all active activations.

📜 Activation History

GET?action=getHistory

Returns activation history with optional filters.

Parameter	Required	Description
start	No	Start timestamp (Unix)
end	No	End timestamp (Unix)
offset	No	Offset (default 0)
size	No	Limit (max 100)

📨 Get All SMS

GET?action=getAllSms

Get all SMS messages for an activation.

Parameter	Required	Description
id	Yes	Activation ID
size	No	Page size
page	No	Page number

📋 Rent Services & Countries

GET?action=getRentServicesAndCountries

Get available services and prices for number rental.

Parameter	Required	Description
country	Yes	Country code
duration	Yes	Rental hours

GET?action=serviceCountRent

Get rental prices and quantities by service.

📱 Get Rent Number

GET?action=getRentNumber

Request phone number for rental.

Parameter	Required	Description
service	Yes	Service code
country	Yes	Country code
duration	Yes	Rental hours

⏱️ Prolong/Extend Number

POST?action=prolong

Extend phone number session (Rent type only).

Parameter	Required	Description
id	Yes	Activation ID
duration	Yes	Extension hours

💲 Prolong Price

GET?action=prolongPrice

Get cost of extending a number.

📜 Prolong History

GET?action=prolongHistory

Get extension history for a number.

🌍 Available Countries

GET?action=getCountries

Returns list of all available countries.

📋 Available Services

GET?action=getServicesList

Returns list of all available services.

Parameter	Required	Description
country	No	Filter by country
lang	No	Language (cn,de,en,es,fr,pt,ru)

📶 Available Operators

GET?action=getOperators

Returns list of available mobile operators.

Parameter	Required	Description
country	No	Filter by country

💲 Current Prices

GET?action=getPrices

Returns prices and available numbers by country/service.

Parameter	Required	Description
service	No	Filter by service
country	No	Filter by country

🏆 Top Countries by Service (Deprecated)

GET?action=getTopCountriesByService

Use /api/v1/activations/offers instead.

📊 Activation Offers (REST API)

GET/api/v1/activations/offers

Services in random order, countries sorted by popularity.

Parameter	Required	Description	Example
services	No	Service codes	tg,go
countries	No	Country IDs	6,50

📧 Email Activations

GET/api/v1/emails

Get list of active email activations.

Parameter	Required	Description
search	No	Search query
status	No	Filter by status (3,4,5,6)
from/to	No	Date range (ISO 8601)
size/page	No	Pagination
sort	No	Sort order (asc/desc)

POST/api/v1/emails

Purchase an email activation.

{
  "site": "telegram.com",
  "domain": "gmail.com"
}

GET/api/v1/emails/domains

Get available email domains.

Parameter	Description
site	Website (e.g., telegram.com)

POST/api/v1/emails/batch

Bulk purchase (1-10 emails).

{
  "site": "telegram.com",
  "domain": "gmail.com",
  "count": 5
}

⚠️ Error Codes Reference

HTTP Status Codes

Code	Status	Description	Example
400	Bad Request	Invalid request parameters	BAD_ACTION, BAD_STATUS, BAD_KEY
401	Unauthorized	Invalid or missing API key	BAD_KEY, ERROR_SQL
402	Payment Required	Insufficient balance	NO_BALANCE
403	Forbidden	Access denied, account banned or restricted	BANNED, NO_ACTIVATION
404	Not Found	Activation/method not found	NO_ACTIVATION
409	Conflict	Cannot complete operation on activation	New SMS received, early cancellation
422	Unprocessable	Invalid request parameters	Wrong service/country/currency
429	Too Many Requests	Rate limit exceeded	-
500	Server Error	Internal server error	ERROR_SQL

Common Error Messages

Error	Meaning
BAD_KEY	Invalid API key
NO_BALANCE	Insufficient funds
NO_NUMBERS	No numbers available
NO_ACTIVATION	Activation not found
BAD_ACTION	Invalid action
BAD_STATUS	Invalid status code
BANNED	Account temporarily banned
ERROR_SQL	Server database error - try again
WRONG_SERVICE	Service not available
WRONG_COUNTRY	Country not available
EARLY_CANCEL	Too early to cancel activation
FREE_CANCEL_EXPIRED	Free cancellation period expired
MAX_HOURS_EXCEED	Maximum rental hours exceeded

Conflict Errors (409)

Error	Description
New OTP received	Cannot cancel/complete - new code arrived
Activation not active	Activation already completed/cancelled
Free cancellation expired	Time window for free cancellation passed
Early cancellation	Must wait before cancelling

Forbidden Errors (403)

Error	Description
Max threads reached	Too many concurrent activations
Service restricted	Service not available for your account
Global ban	Account globally banned
Specific ban	Account banned for specific service
Inactive account	Account deactivated

🛡️ SMS Verification API Documentation