Automate SMS verification with our API
REST JSON API covering 200+ countries and 5000+ popular services. Allocate virtual numbers and verify SMS codes with a few lines of code.
curl -X POST "https://anindasms.com/api/v1/order" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{"service":"wa","country":"62"}'<?php
$ch = curl_init('https://anindasms.com/api/v1/order');
curl_setopt_array($ch, [
CURLOPT_RETURNTRANSFER => true,
CURLOPT_POST => true,
CURLOPT_HTTPHEADER => [
'Authorization: Bearer YOUR_API_KEY',
'Content-Type: application/json',
],
CURLOPT_POSTFIELDS => json_encode(['service' => 'wa', 'country' => '62']),
]);
$response = json_decode(curl_exec($ch), true);
curl_close($ch);
print_r($response);import requests
response = requests.post(
"https://anindasms.com/api/v1/order",
headers={"Authorization": "Bearer YOUR_API_KEY"},
json={"service": "wa", "country": "62"},
)
print(response.json())const res = await fetch("https://anindasms.com/api/v1/order", {
method: "POST",
headers: {
"Authorization": "Bearer YOUR_API_KEY",
"Content-Type": "application/json",
},
body: JSON.stringify({ service: "wa", country: "62" }),
});
console.log(await res.json());using var client = new HttpClient();
client.DefaultRequestHeaders.Add("Authorization", "Bearer YOUR_API_KEY");
var body = new StringContent("{\"service\":\"wa\",\"country\":\"62\"}", Encoding.UTF8, "application/json");
var res = await client.PostAsync("https://anindasms.com/api/v1/order", body);
Console.WriteLine(await res.Content.ReadAsStringAsync());package main
import (
"fmt"
"io"
"net/http"
"strings"
)
func main() {
body := strings.NewReader(`{"service":"wa","country":"62"}`)
req, _ := http.NewRequest("POST", "https://anindasms.com/api/v1/order", body)
req.Header.Set("Authorization", "Bearer YOUR_API_KEY")
req.Header.Set("Content-Type", "application/json")
res, err := http.DefaultClient.Do(req)
if err != nil {
panic(err)
}
defer res.Body.Close()
out, _ := io.ReadAll(res.Body)
fmt.Println(string(out))
}{
"success": true,
"data": {
"order_id": 58231,
"phone": "+905551234567",
"status": "waiting"
}
}Authentication
Send your API key in an HTTP header with every request. You can use either method:
| Header | Value |
|---|---|
Authorization | Bearer YOUR_API_KEY |
X-API-Key | YOUR_API_KEY |
?api_key=) or the request body; such requests are rejected with 401. You can define an IP allowlist on your profile page and regenerate the key with one click if it leaks.GET /api/v1/balance HTTP/1.1
Host: anindasms.com
Authorization: Bearer YOUR_API_KEY{
"success": false,
"error": "Geçersiz API key."
}Response format
All responses are JSON and share the same envelope. Successful requests return success: true with the result inside data; errors return success: false with a message in error. The HTTP status code reflects the outcome as well.
| Field | Type | Description |
|---|---|---|
success | boolean | Whether the request succeeded |
data | object | Result data (may hold extra details on errors) |
error | string | Error message (errors only) |
{
"success": true,
"data": {
"balance": 152.4,
"currency": "TRY",
"formatted": "₺152,40"
}
}{
"success": false,
"error": "Yetersiz bakiye.",
"data": {
"balance": 12.5,
"required": 38.82
}
}Rate limits
Requests are limited per minute for fair use. When exceeded, 429 is returned; wait for the number of seconds in the Retry-After header and retry.
| Scope | Limit |
|---|---|
| All requests | 120 / minute |
POST /order | 30 / minute |
Response headers
X-RateLimit-Limit | Total allowance per minute |
X-RateLimit-Remaining | Remaining requests |
X-RateLimit-Reset | When the counter resets (unix time) |
HTTP/1.1 429 Too Many Requests
Retry-After: 18
X-RateLimit-Limit: 30
X-RateLimit-Remaining: 0
X-RateLimit-Reset: 1792850400Account summary
Returns a summary of the account linked to your API key. Ideal for checking that your key works when testing an integration for the first time.
Response fields (data)
| Field | Type | Description |
|---|---|---|
id | integer | User ID |
username | string | Username |
email | string | E-mail address |
balance | number | Current balance |
currency | string | Currency (always TRY) |
api_key_prefix | string | First characters of the key (for identification) |
api_key_created_at | datetime | Key creation time |
api_key_last_used_at | datetime|null | Last time the key was used |
curl "https://anindasms.com/api/v1/me" \
-H "Authorization: Bearer YOUR_API_KEY"<?php
$ch = curl_init('https://anindasms.com/api/v1/me');
curl_setopt_array($ch, [
CURLOPT_RETURNTRANSFER => true,
CURLOPT_HTTPHEADER => [
'Authorization: Bearer YOUR_API_KEY',
],
]);
$response = json_decode(curl_exec($ch), true);
curl_close($ch);
print_r($response);import requests
response = requests.get(
"https://anindasms.com/api/v1/me",
headers={"Authorization": "Bearer YOUR_API_KEY"},
)
print(response.json())const res = await fetch("https://anindasms.com/api/v1/me", {
headers: {
"Authorization": "Bearer YOUR_API_KEY",
},
});
console.log(await res.json());using var client = new HttpClient();
client.DefaultRequestHeaders.Add("Authorization", "Bearer YOUR_API_KEY");
var res = await client.GetAsync("https://anindasms.com/api/v1/me");
Console.WriteLine(await res.Content.ReadAsStringAsync());package main
import (
"fmt"
"io"
"net/http"
)
func main() {
req, _ := http.NewRequest("GET", "https://anindasms.com/api/v1/me", nil)
req.Header.Set("Authorization", "Bearer YOUR_API_KEY")
res, err := http.DefaultClient.Do(req)
if err != nil {
panic(err)
}
defer res.Body.Close()
out, _ := io.ReadAll(res.Body)
fmt.Println(string(out))
}{
"success": true,
"data": {
"id": 1024,
"username": "demo",
"email": "[email protected]",
"balance": 152.4,
"currency": "TRY",
"api_key_prefix": "a1b2c3d4",
"api_key_created_at": "2026-10-01 12:00:00",
"api_key_last_used_at": "2026-10-24 14:05:11"
}
}Current balance
Returns your current account balance. Check it before ordering to avoid insufficient-balance errors.
Response fields (data)
| Field | Type | Description |
|---|---|---|
balance | number | Current balance |
currency | string | Currency (TRY) |
formatted | string | Display-ready balance |
curl "https://anindasms.com/api/v1/balance" \
-H "Authorization: Bearer YOUR_API_KEY"<?php
$ch = curl_init('https://anindasms.com/api/v1/balance');
curl_setopt_array($ch, [
CURLOPT_RETURNTRANSFER => true,
CURLOPT_HTTPHEADER => [
'Authorization: Bearer YOUR_API_KEY',
],
]);
$response = json_decode(curl_exec($ch), true);
curl_close($ch);
print_r($response);import requests
response = requests.get(
"https://anindasms.com/api/v1/balance",
headers={"Authorization": "Bearer YOUR_API_KEY"},
)
print(response.json())const res = await fetch("https://anindasms.com/api/v1/balance", {
headers: {
"Authorization": "Bearer YOUR_API_KEY",
},
});
console.log(await res.json());using var client = new HttpClient();
client.DefaultRequestHeaders.Add("Authorization", "Bearer YOUR_API_KEY");
var res = await client.GetAsync("https://anindasms.com/api/v1/balance");
Console.WriteLine(await res.Content.ReadAsStringAsync());package main
import (
"fmt"
"io"
"net/http"
)
func main() {
req, _ := http.NewRequest("GET", "https://anindasms.com/api/v1/balance", nil)
req.Header.Set("Authorization", "Bearer YOUR_API_KEY")
res, err := http.DefaultClient.Do(req)
if err != nil {
panic(err)
}
defer res.Body.Close()
out, _ := io.ReadAll(res.Body)
fmt.Println(string(out))
}{
"success": true,
"data": {
"balance": 152.4,
"currency": "TRY",
"formatted": "₺152,40"
}
}Active service list
Lists every service you can currently get a number for. Use the returned code as the service parameter when querying prices and placing orders.
Response fields (data)
| Field | Type | Description |
|---|---|---|
services[].code | string | Service code (e.g. wa = WhatsApp) |
services[].name | string | Service name |
curl "https://anindasms.com/api/v1/services" \
-H "Authorization: Bearer YOUR_API_KEY"<?php
$ch = curl_init('https://anindasms.com/api/v1/services');
curl_setopt_array($ch, [
CURLOPT_RETURNTRANSFER => true,
CURLOPT_HTTPHEADER => [
'Authorization: Bearer YOUR_API_KEY',
],
]);
$response = json_decode(curl_exec($ch), true);
curl_close($ch);
print_r($response);import requests
response = requests.get(
"https://anindasms.com/api/v1/services",
headers={"Authorization": "Bearer YOUR_API_KEY"},
)
print(response.json())const res = await fetch("https://anindasms.com/api/v1/services", {
headers: {
"Authorization": "Bearer YOUR_API_KEY",
},
});
console.log(await res.json());using var client = new HttpClient();
client.DefaultRequestHeaders.Add("Authorization", "Bearer YOUR_API_KEY");
var res = await client.GetAsync("https://anindasms.com/api/v1/services");
Console.WriteLine(await res.Content.ReadAsStringAsync());package main
import (
"fmt"
"io"
"net/http"
)
func main() {
req, _ := http.NewRequest("GET", "https://anindasms.com/api/v1/services", nil)
req.Header.Set("Authorization", "Bearer YOUR_API_KEY")
res, err := http.DefaultClient.Do(req)
if err != nil {
panic(err)
}
defer res.Body.Close()
out, _ := io.ReadAll(res.Body)
fmt.Println(string(out))
}{
"success": true,
"data": {
"services": [
{
"code": "wa",
"name": "WhatsApp"
},
{
"code": "tg",
"name": "Telegram"
},
{
"code": "go",
"name": "Google / Gmail"
}
]
}
}Country prices / stock
Returns per-country price and stock for a service. If you send country, only that country's price is returned.
Parameters
| Field | Type | Description | |
|---|---|---|---|
service |
string | required | Service code (from /services) |
country |
string | optional | Country ID. When sent, a single-country price is returned. |
Response fields (data)
| Field | Type | Description |
|---|---|---|
prices[].country | string | Country ID (used when ordering) |
prices[].name | string | Country name |
prices[].price | number | Your price (TRY) |
prices[].stock | integer | Available number stock |
prices[].available | boolean | Whether it can be ordered right now |
curl "https://anindasms.com/api/v1/prices?service=wa" \
-H "Authorization: Bearer YOUR_API_KEY"<?php
$ch = curl_init('https://anindasms.com/api/v1/prices?service=wa');
curl_setopt_array($ch, [
CURLOPT_RETURNTRANSFER => true,
CURLOPT_HTTPHEADER => [
'Authorization: Bearer YOUR_API_KEY',
],
]);
$response = json_decode(curl_exec($ch), true);
curl_close($ch);
print_r($response);import requests
response = requests.get(
"https://anindasms.com/api/v1/prices?service=wa",
headers={"Authorization": "Bearer YOUR_API_KEY"},
)
print(response.json())const res = await fetch("https://anindasms.com/api/v1/prices?service=wa", {
headers: {
"Authorization": "Bearer YOUR_API_KEY",
},
});
console.log(await res.json());using var client = new HttpClient();
client.DefaultRequestHeaders.Add("Authorization", "Bearer YOUR_API_KEY");
var res = await client.GetAsync("https://anindasms.com/api/v1/prices?service=wa");
Console.WriteLine(await res.Content.ReadAsStringAsync());package main
import (
"fmt"
"io"
"net/http"
)
func main() {
req, _ := http.NewRequest("GET", "https://anindasms.com/api/v1/prices?service=wa", nil)
req.Header.Set("Authorization", "Bearer YOUR_API_KEY")
res, err := http.DefaultClient.Do(req)
if err != nil {
panic(err)
}
defer res.Body.Close()
out, _ := io.ReadAll(res.Body)
fmt.Println(string(out))
}{
"success": true,
"data": {
"service": "wa",
"prices": [
{
"country": "62",
"name": "Turkey",
"price": 38.82,
"formatted": "₺38,82",
"stock": 412,
"available": true
},
{
"country": "16",
"name": "United Kingdom",
"price": 24.5,
"formatted": "₺24,50",
"stock": 1280,
"available": true
}
]
}
}Create a number order
Buys a number for the selected service and country. The fee is deducted from your balance and the number is returned instantly. Then poll the order status to receive the SMS code.
Body parameters (JSON)
| Field | Type | Description | |
|---|---|---|---|
service |
string | required | Service code |
country |
string | required | Country ID |
operator |
string | optional | Operator (default: any). Ignored where not supported. |
Response fields (data)
| Field | Type | Description |
|---|---|---|
order_id | integer | Order ID — required for status, cancel and complete |
phone | string | Purchased phone number |
cost | number | Charged amount (TRY) |
balance | number | Balance after the order |
status | string | Initial status: waiting |
expires_at | datetime | Number expiry (10 min) |
402 is returned with balance and required inside data. If there is no stock, 409 is returned.curl -X POST "https://anindasms.com/api/v1/order" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{"service":"wa","country":"62"}'<?php
$ch = curl_init('https://anindasms.com/api/v1/order');
curl_setopt_array($ch, [
CURLOPT_RETURNTRANSFER => true,
CURLOPT_POST => true,
CURLOPT_HTTPHEADER => [
'Authorization: Bearer YOUR_API_KEY',
'Content-Type: application/json',
],
CURLOPT_POSTFIELDS => json_encode(['service' => 'wa', 'country' => '62']),
]);
$response = json_decode(curl_exec($ch), true);
curl_close($ch);
print_r($response);import requests
response = requests.post(
"https://anindasms.com/api/v1/order",
headers={"Authorization": "Bearer YOUR_API_KEY"},
json={"service": "wa", "country": "62"},
)
print(response.json())const res = await fetch("https://anindasms.com/api/v1/order", {
method: "POST",
headers: {
"Authorization": "Bearer YOUR_API_KEY",
"Content-Type": "application/json",
},
body: JSON.stringify({ service: "wa", country: "62" }),
});
console.log(await res.json());using var client = new HttpClient();
client.DefaultRequestHeaders.Add("Authorization", "Bearer YOUR_API_KEY");
var body = new StringContent("{\"service\":\"wa\",\"country\":\"62\"}", Encoding.UTF8, "application/json");
var res = await client.PostAsync("https://anindasms.com/api/v1/order", body);
Console.WriteLine(await res.Content.ReadAsStringAsync());package main
import (
"fmt"
"io"
"net/http"
"strings"
)
func main() {
body := strings.NewReader(`{"service":"wa","country":"62"}`)
req, _ := http.NewRequest("POST", "https://anindasms.com/api/v1/order", body)
req.Header.Set("Authorization", "Bearer YOUR_API_KEY")
req.Header.Set("Content-Type", "application/json")
res, err := http.DefaultClient.Do(req)
if err != nil {
panic(err)
}
defer res.Body.Close()
out, _ := io.ReadAll(res.Body)
fmt.Println(string(out))
}{
"success": true,
"data": {
"order_id": 58231,
"phone": "+905551234567",
"service": "wa",
"country": "62",
"operator": null,
"cost": 38.82,
"balance": 113.58,
"status": "waiting",
"expires_at": "2026-10-24 14:12:10"
}
}Order status + OTP
Returns the current status of the order. When the SMS arrives, status becomes received and the code is in the code field. Polling every 3–5 seconds until the code arrives is enough.
Parameters
| Field | Type | Description | |
|---|---|---|---|
id |
integer | required | Order ID (in the URL) |
Response fields (data)
| Field | Type | Description |
|---|---|---|
status | string | waiting · received · done · cancelled · expired |
code | string|null | Verification code (when received) |
sms_text | string|null | Full SMS text |
remaining | integer | Remaining waiting time (seconds) |
expires_at | datetime | Number expiry |
curl "https://anindasms.com/api/v1/order/58231" \
-H "Authorization: Bearer YOUR_API_KEY"<?php
$ch = curl_init('https://anindasms.com/api/v1/order/58231');
curl_setopt_array($ch, [
CURLOPT_RETURNTRANSFER => true,
CURLOPT_HTTPHEADER => [
'Authorization: Bearer YOUR_API_KEY',
],
]);
$response = json_decode(curl_exec($ch), true);
curl_close($ch);
print_r($response);import requests
response = requests.get(
"https://anindasms.com/api/v1/order/58231",
headers={"Authorization": "Bearer YOUR_API_KEY"},
)
print(response.json())const res = await fetch("https://anindasms.com/api/v1/order/58231", {
headers: {
"Authorization": "Bearer YOUR_API_KEY",
},
});
console.log(await res.json());using var client = new HttpClient();
client.DefaultRequestHeaders.Add("Authorization", "Bearer YOUR_API_KEY");
var res = await client.GetAsync("https://anindasms.com/api/v1/order/58231");
Console.WriteLine(await res.Content.ReadAsStringAsync());package main
import (
"fmt"
"io"
"net/http"
)
func main() {
req, _ := http.NewRequest("GET", "https://anindasms.com/api/v1/order/58231", nil)
req.Header.Set("Authorization", "Bearer YOUR_API_KEY")
res, err := http.DefaultClient.Do(req)
if err != nil {
panic(err)
}
defer res.Body.Close()
out, _ := io.ReadAll(res.Body)
fmt.Println(string(out))
}{
"success": true,
"data": {
"order_id": 58231,
"phone": "+905551234567",
"service": "wa",
"country": "62",
"status": "received",
"cost": 38.82,
"code": "482913",
"sms_text": "Your WhatsApp code: 482-913",
"remaining": 0,
"created_at": "2026-10-24 14:02:10",
"expires_at": "2026-10-24 14:12:10"
}
}Cancel and refund
Cancels an order that has not received an SMS and refunds the fee to your balance. Orders cannot be cancelled after the SMS arrives.
Parameters
| Field | Type | Description | |
|---|---|---|---|
id |
integer | required | Order ID (in the URL) |
Response fields (data)
| Field | Type | Description |
|---|---|---|
order_id | integer | Order ID |
status | string | cancelled |
balance | number | Balance after the refund |
400 is returned with data.wait_left (seconds).curl -X POST "https://anindasms.com/api/v1/order/58231/cancel" \
-H "Authorization: Bearer YOUR_API_KEY"<?php
$ch = curl_init('https://anindasms.com/api/v1/order/58231/cancel');
curl_setopt_array($ch, [
CURLOPT_RETURNTRANSFER => true,
CURLOPT_POST => true,
CURLOPT_HTTPHEADER => [
'Authorization: Bearer YOUR_API_KEY',
],
]);
$response = json_decode(curl_exec($ch), true);
curl_close($ch);
print_r($response);import requests
response = requests.post(
"https://anindasms.com/api/v1/order/58231/cancel",
headers={"Authorization": "Bearer YOUR_API_KEY"},
)
print(response.json())const res = await fetch("https://anindasms.com/api/v1/order/58231/cancel", {
method: "POST",
headers: {
"Authorization": "Bearer YOUR_API_KEY",
},
});
console.log(await res.json());using var client = new HttpClient();
client.DefaultRequestHeaders.Add("Authorization", "Bearer YOUR_API_KEY");
var res = await client.PostAsync("https://anindasms.com/api/v1/order/58231/cancel", null);
Console.WriteLine(await res.Content.ReadAsStringAsync());package main
import (
"fmt"
"io"
"net/http"
)
func main() {
req, _ := http.NewRequest("POST", "https://anindasms.com/api/v1/order/58231/cancel", nil)
req.Header.Set("Authorization", "Bearer YOUR_API_KEY")
res, err := http.DefaultClient.Do(req)
if err != nil {
panic(err)
}
defer res.Body.Close()
out, _ := io.ReadAll(res.Body)
fmt.Println(string(out))
}{
"success": true,
"data": {
"order_id": 58231,
"status": "cancelled",
"balance": 152.4
}
}Mark order done
Marks the order as completed after you have received the code. Works on waiting or received orders.
Parameters
| Field | Type | Description | |
|---|---|---|---|
id |
integer | required | Order ID (in the URL) |
Response fields (data)
| Field | Type | Description |
|---|---|---|
order_id | integer | Order ID |
status | string | done |
curl -X POST "https://anindasms.com/api/v1/order/58231/done" \
-H "Authorization: Bearer YOUR_API_KEY"<?php
$ch = curl_init('https://anindasms.com/api/v1/order/58231/done');
curl_setopt_array($ch, [
CURLOPT_RETURNTRANSFER => true,
CURLOPT_POST => true,
CURLOPT_HTTPHEADER => [
'Authorization: Bearer YOUR_API_KEY',
],
]);
$response = json_decode(curl_exec($ch), true);
curl_close($ch);
print_r($response);import requests
response = requests.post(
"https://anindasms.com/api/v1/order/58231/done",
headers={"Authorization": "Bearer YOUR_API_KEY"},
)
print(response.json())const res = await fetch("https://anindasms.com/api/v1/order/58231/done", {
method: "POST",
headers: {
"Authorization": "Bearer YOUR_API_KEY",
},
});
console.log(await res.json());using var client = new HttpClient();
client.DefaultRequestHeaders.Add("Authorization", "Bearer YOUR_API_KEY");
var res = await client.PostAsync("https://anindasms.com/api/v1/order/58231/done", null);
Console.WriteLine(await res.Content.ReadAsStringAsync());package main
import (
"fmt"
"io"
"net/http"
)
func main() {
req, _ := http.NewRequest("POST", "https://anindasms.com/api/v1/order/58231/done", nil)
req.Header.Set("Authorization", "Bearer YOUR_API_KEY")
res, err := http.DefaultClient.Do(req)
if err != nil {
panic(err)
}
defer res.Body.Close()
out, _ := io.ReadAll(res.Body)
fmt.Println(string(out))
}{
"success": true,
"data": {
"order_id": 58231,
"status": "done"
}
}Proxy Types
Lists all available proxy types (datacenter, residential, ipv6, mobile) and their features.
Response fields (data)
| Field | Type | Description |
|---|---|---|
types[].type | string | Proxy type key (datacenter, residential, ipv6, mobile) |
types[].name | string | Display name |
types[].protocol | string | Protocol (HTTP / SOCKS5) |
types[].description | string | Description |
curl "https://anindasms.com/api/v1/proxy/types" \
-H "Authorization: Bearer YOUR_API_KEY"<?php
$ch = curl_init('https://anindasms.com/api/v1/proxy/types');
curl_setopt_array($ch, [
CURLOPT_RETURNTRANSFER => true,
CURLOPT_HTTPHEADER => [
'Authorization: Bearer YOUR_API_KEY',
],
]);
$response = json_decode(curl_exec($ch), true);
curl_close($ch);
print_r($response);import requests
response = requests.get(
"https://anindasms.com/api/v1/proxy/types",
headers={"Authorization": "Bearer YOUR_API_KEY"},
)
print(response.json())const res = await fetch("https://anindasms.com/api/v1/proxy/types", {
headers: {
"Authorization": "Bearer YOUR_API_KEY",
},
});
console.log(await res.json());using var client = new HttpClient();
client.DefaultRequestHeaders.Add("Authorization", "Bearer YOUR_API_KEY");
var res = await client.GetAsync("https://anindasms.com/api/v1/proxy/types");
Console.WriteLine(await res.Content.ReadAsStringAsync());package main
import (
"fmt"
"io"
"net/http"
)
func main() {
req, _ := http.NewRequest("GET", "https://anindasms.com/api/v1/proxy/types", nil)
req.Header.Set("Authorization", "Bearer YOUR_API_KEY")
res, err := http.DefaultClient.Do(req)
if err != nil {
panic(err)
}
defer res.Body.Close()
out, _ := io.ReadAll(res.Body)
fmt.Println(string(out))
}{
"success": true,
"data": {
"types": [
{
"type": "datacenter",
"name": "Statik Veri Merkezi",
"protocol": "HTTP/SOCKS5",
"description": "Yüksek hızlı, kesintisiz sunucu IP'leri."
},
{
"type": "residential",
"name": "Konut (Residential)",
"protocol": "HTTP/SOCKS5",
"description": "Gerçek ev interneti IP'leri, bloklanma riski en düşük."
},
{
"type": "ipv6",
"name": "IPv6 Proxy",
"protocol": "HTTP/SOCKS5",
"description": "Ekonomik ve modern IPv6 havuzu."
},
{
"type": "mobile",
"name": "Mobil 4G/5G",
"protocol": "HTTP/SOCKS5",
"description": "Gerçek mobil operatör IP havuzu, rotasyonlu."
}
]
}
}Proxy Countries
Lists available countries for the specified proxy type.
Parameters
| Field | Type | Description | |
|---|---|---|---|
type |
string | optional | Proxy type. If empty, all supported countries are returned. |
Response fields (data)
| Field | Type | Description |
|---|---|---|
countries[].code | string | 2-letter ISO country code |
countries[].name | string | Country name |
curl "https://anindasms.com/api/v1/proxy/countries?type=datacenter" \
-H "Authorization: Bearer YOUR_API_KEY"<?php
$ch = curl_init('https://anindasms.com/api/v1/proxy/countries?type=datacenter');
curl_setopt_array($ch, [
CURLOPT_RETURNTRANSFER => true,
CURLOPT_HTTPHEADER => [
'Authorization: Bearer YOUR_API_KEY',
],
]);
$response = json_decode(curl_exec($ch), true);
curl_close($ch);
print_r($response);import requests
response = requests.get(
"https://anindasms.com/api/v1/proxy/countries?type=datacenter",
headers={"Authorization": "Bearer YOUR_API_KEY"},
)
print(response.json())const res = await fetch("https://anindasms.com/api/v1/proxy/countries?type=datacenter", {
headers: {
"Authorization": "Bearer YOUR_API_KEY",
},
});
console.log(await res.json());using var client = new HttpClient();
client.DefaultRequestHeaders.Add("Authorization", "Bearer YOUR_API_KEY");
var res = await client.GetAsync("https://anindasms.com/api/v1/proxy/countries?type=datacenter");
Console.WriteLine(await res.Content.ReadAsStringAsync());package main
import (
"fmt"
"io"
"net/http"
)
func main() {
req, _ := http.NewRequest("GET", "https://anindasms.com/api/v1/proxy/countries?type=datacenter", nil)
req.Header.Set("Authorization", "Bearer YOUR_API_KEY")
res, err := http.DefaultClient.Do(req)
if err != nil {
panic(err)
}
defer res.Body.Close()
out, _ := io.ReadAll(res.Body)
fmt.Println(string(out))
}{
"success": true,
"data": {
"countries": [
{
"code": "TR",
"name": "Türkiye"
},
{
"code": "US",
"name": "United States"
},
{
"code": "DE",
"name": "Germany"
},
{
"code": "GB",
"name": "United Kingdom"
}
]
}
}Proxy Price Calculation
Calculates the proxy cost before purchase.
Parameters
| Field | Type | Description | |
|---|---|---|---|
type |
string | required | Proxy type |
country |
string | optional | Country code (optional) |
period |
integer | optional | Duration in days (default: 30) |
quantity |
integer | optional | Quantity (default: 1) |
Response fields (data)
| Field | Type | Description |
|---|---|---|
unit_price | number | Unit price (TRY) |
total_price | number | Total price (TRY) |
currency | string | Currency (TRY) |
curl "https://anindasms.com/api/v1/proxy/price?type=datacenter&country=TR&period=30&quantity=1" \
-H "Authorization: Bearer YOUR_API_KEY"<?php
$ch = curl_init('https://anindasms.com/api/v1/proxy/price?type=datacenter&country=TR&period=30&quantity=1');
curl_setopt_array($ch, [
CURLOPT_RETURNTRANSFER => true,
CURLOPT_HTTPHEADER => [
'Authorization: Bearer YOUR_API_KEY',
],
]);
$response = json_decode(curl_exec($ch), true);
curl_close($ch);
print_r($response);import requests
response = requests.get(
"https://anindasms.com/api/v1/proxy/price?type=datacenter&country=TR&period=30&quantity=1",
headers={"Authorization": "Bearer YOUR_API_KEY"},
)
print(response.json())const res = await fetch("https://anindasms.com/api/v1/proxy/price?type=datacenter&country=TR&period=30&quantity=1", {
headers: {
"Authorization": "Bearer YOUR_API_KEY",
},
});
console.log(await res.json());using var client = new HttpClient();
client.DefaultRequestHeaders.Add("Authorization", "Bearer YOUR_API_KEY");
var res = await client.GetAsync("https://anindasms.com/api/v1/proxy/price?type=datacenter&country=TR&period=30&quantity=1");
Console.WriteLine(await res.Content.ReadAsStringAsync());package main
import (
"fmt"
"io"
"net/http"
)
func main() {
req, _ := http.NewRequest("GET", "https://anindasms.com/api/v1/proxy/price?type=datacenter&country=TR&period=30&quantity=1", nil)
req.Header.Set("Authorization", "Bearer YOUR_API_KEY")
res, err := http.DefaultClient.Do(req)
if err != nil {
panic(err)
}
defer res.Body.Close()
out, _ := io.ReadAll(res.Body)
fmt.Println(string(out))
}{
"success": true,
"data": {
"unit_price": 45,
"total_price": 45,
"currency": "TRY"
}
}Buy Proxy
Purchases a proxy, deducts the amount from your balance, and immediately delivers IP/port/username/password credentials.
Body parameters (JSON)
| Field | Type | Description | |
|---|---|---|---|
type |
string | required | Proxy type |
country |
string | required | Country code (e.g. TR, US) |
period |
integer | optional | Duration in days (default: 30) |
quantity |
integer | optional | Quantity (default: 1) |
rotation_interval |
integer | optional | Rotation interval in minutes for mobile/rotating proxies |
Response fields (data)
| Field | Type | Description |
|---|---|---|
order_id | integer | Proxy order ID |
proxy_type | string | Proxy type |
ip | string | Proxy host / IP address |
port | integer | Port number |
username | string | Auth username |
password | string | Auth password |
expires_at | datetime | Expiration datetime |
curl -X POST "https://anindasms.com/api/v1/proxy/buy" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{"type":"datacenter","country":"TR","period":30,"quantity":1}'<?php
$ch = curl_init('https://anindasms.com/api/v1/proxy/buy');
curl_setopt_array($ch, [
CURLOPT_RETURNTRANSFER => true,
CURLOPT_POST => true,
CURLOPT_HTTPHEADER => [
'Authorization: Bearer YOUR_API_KEY',
'Content-Type: application/json',
],
CURLOPT_POSTFIELDS => json_encode(['type' => 'datacenter', 'country' => 'TR', 'period' => '30', 'quantity' => '1']),
]);
$response = json_decode(curl_exec($ch), true);
curl_close($ch);
print_r($response);import requests
response = requests.post(
"https://anindasms.com/api/v1/proxy/buy",
headers={"Authorization": "Bearer YOUR_API_KEY"},
json={"type": "datacenter", "country": "TR", "period": "30", "quantity": "1"},
)
print(response.json())const res = await fetch("https://anindasms.com/api/v1/proxy/buy", {
method: "POST",
headers: {
"Authorization": "Bearer YOUR_API_KEY",
"Content-Type": "application/json",
},
body: JSON.stringify({ type: "datacenter", country: "TR", period: "30", quantity: "1" }),
});
console.log(await res.json());using var client = new HttpClient();
client.DefaultRequestHeaders.Add("Authorization", "Bearer YOUR_API_KEY");
var body = new StringContent("{\"type\":\"datacenter\",\"country\":\"TR\",\"period\":30,\"quantity\":1}", Encoding.UTF8, "application/json");
var res = await client.PostAsync("https://anindasms.com/api/v1/proxy/buy", body);
Console.WriteLine(await res.Content.ReadAsStringAsync());package main
import (
"fmt"
"io"
"net/http"
"strings"
)
func main() {
body := strings.NewReader(`{"type":"datacenter","country":"TR","period":30,"quantity":1}`)
req, _ := http.NewRequest("POST", "https://anindasms.com/api/v1/proxy/buy", body)
req.Header.Set("Authorization", "Bearer YOUR_API_KEY")
req.Header.Set("Content-Type", "application/json")
res, err := http.DefaultClient.Do(req)
if err != nil {
panic(err)
}
defer res.Body.Close()
out, _ := io.ReadAll(res.Body)
fmt.Println(string(out))
}{
"success": true,
"data": {
"order_id": 1042,
"proxy_type": "datacenter",
"ip": "185.193.124.50",
"port": 8080,
"username": "user_1042",
"password": "sec_984f2b",
"expires_at": "2026-11-24 14:00:00"
}
}Proxy Orders
Lists all your proxy orders.
Parameters
| Field | Type | Description | |
|---|---|---|---|
page |
integer | optional | Page number (default: 1) |
limit |
integer | optional | Page limit (default: 20) |
Response fields (data)
| Field | Type | Description |
|---|---|---|
orders[].order_id | integer | Order ID |
orders[].proxy_type | string | Type |
orders[].ip | string | Host / IP |
orders[].status | string | Status (active, expired) |
orders[].expires_at | datetime | Expiration date |
curl "https://anindasms.com/api/v1/proxy/orders" \
-H "Authorization: Bearer YOUR_API_KEY"<?php
$ch = curl_init('https://anindasms.com/api/v1/proxy/orders');
curl_setopt_array($ch, [
CURLOPT_RETURNTRANSFER => true,
CURLOPT_HTTPHEADER => [
'Authorization: Bearer YOUR_API_KEY',
],
]);
$response = json_decode(curl_exec($ch), true);
curl_close($ch);
print_r($response);import requests
response = requests.get(
"https://anindasms.com/api/v1/proxy/orders",
headers={"Authorization": "Bearer YOUR_API_KEY"},
)
print(response.json())const res = await fetch("https://anindasms.com/api/v1/proxy/orders", {
headers: {
"Authorization": "Bearer YOUR_API_KEY",
},
});
console.log(await res.json());using var client = new HttpClient();
client.DefaultRequestHeaders.Add("Authorization", "Bearer YOUR_API_KEY");
var res = await client.GetAsync("https://anindasms.com/api/v1/proxy/orders");
Console.WriteLine(await res.Content.ReadAsStringAsync());package main
import (
"fmt"
"io"
"net/http"
)
func main() {
req, _ := http.NewRequest("GET", "https://anindasms.com/api/v1/proxy/orders", nil)
req.Header.Set("Authorization", "Bearer YOUR_API_KEY")
res, err := http.DefaultClient.Do(req)
if err != nil {
panic(err)
}
defer res.Body.Close()
out, _ := io.ReadAll(res.Body)
fmt.Println(string(out))
}{
"success": true,
"data": {
"orders": [
{
"order_id": 1042,
"proxy_type": "datacenter",
"ip": "185.193.124.50",
"status": "active",
"expires_at": "2026-11-24 14:00:00"
}
]
}
}Proxy Order Detail
Fetches credentials and connection details of a proxy order.
Parameters
| Field | Type | Description | |
|---|---|---|---|
id |
integer | required | Proxy order ID (in URL) |
Response fields (data)
| Field | Type | Description |
|---|---|---|
order_id | integer | Order ID |
proxy_type | string | Proxy type |
ip | string | IP |
port | integer | Port |
username | string | Username |
password | string | Password |
status | string | Status |
expires_at | datetime | Expiration |
curl "https://anindasms.com/api/v1/proxy/orders/1042" \
-H "Authorization: Bearer YOUR_API_KEY"<?php
$ch = curl_init('https://anindasms.com/api/v1/proxy/orders/1042');
curl_setopt_array($ch, [
CURLOPT_RETURNTRANSFER => true,
CURLOPT_HTTPHEADER => [
'Authorization: Bearer YOUR_API_KEY',
],
]);
$response = json_decode(curl_exec($ch), true);
curl_close($ch);
print_r($response);import requests
response = requests.get(
"https://anindasms.com/api/v1/proxy/orders/1042",
headers={"Authorization": "Bearer YOUR_API_KEY"},
)
print(response.json())const res = await fetch("https://anindasms.com/api/v1/proxy/orders/1042", {
headers: {
"Authorization": "Bearer YOUR_API_KEY",
},
});
console.log(await res.json());using var client = new HttpClient();
client.DefaultRequestHeaders.Add("Authorization", "Bearer YOUR_API_KEY");
var res = await client.GetAsync("https://anindasms.com/api/v1/proxy/orders/1042");
Console.WriteLine(await res.Content.ReadAsStringAsync());package main
import (
"fmt"
"io"
"net/http"
)
func main() {
req, _ := http.NewRequest("GET", "https://anindasms.com/api/v1/proxy/orders/1042", nil)
req.Header.Set("Authorization", "Bearer YOUR_API_KEY")
res, err := http.DefaultClient.Do(req)
if err != nil {
panic(err)
}
defer res.Body.Close()
out, _ := io.ReadAll(res.Body)
fmt.Println(string(out))
}{
"success": true,
"data": {
"order_id": 1042,
"proxy_type": "datacenter",
"ip": "185.193.124.50",
"port": 8080,
"username": "user_1042",
"password": "sec_984f2b",
"status": "active",
"expires_at": "2026-11-24 14:00:00"
}
}eSIM Countries
Lists countries where eSIM data packages are available.
Response fields (data)
| Field | Type | Description |
|---|---|---|
countries[].code | string | 2-letter ISO country code |
countries[].name | string | Country name |
curl "https://anindasms.com/api/v1/esim/countries" \
-H "Authorization: Bearer YOUR_API_KEY"<?php
$ch = curl_init('https://anindasms.com/api/v1/esim/countries');
curl_setopt_array($ch, [
CURLOPT_RETURNTRANSFER => true,
CURLOPT_HTTPHEADER => [
'Authorization: Bearer YOUR_API_KEY',
],
]);
$response = json_decode(curl_exec($ch), true);
curl_close($ch);
print_r($response);import requests
response = requests.get(
"https://anindasms.com/api/v1/esim/countries",
headers={"Authorization": "Bearer YOUR_API_KEY"},
)
print(response.json())const res = await fetch("https://anindasms.com/api/v1/esim/countries", {
headers: {
"Authorization": "Bearer YOUR_API_KEY",
},
});
console.log(await res.json());using var client = new HttpClient();
client.DefaultRequestHeaders.Add("Authorization", "Bearer YOUR_API_KEY");
var res = await client.GetAsync("https://anindasms.com/api/v1/esim/countries");
Console.WriteLine(await res.Content.ReadAsStringAsync());package main
import (
"fmt"
"io"
"net/http"
)
func main() {
req, _ := http.NewRequest("GET", "https://anindasms.com/api/v1/esim/countries", nil)
req.Header.Set("Authorization", "Bearer YOUR_API_KEY")
res, err := http.DefaultClient.Do(req)
if err != nil {
panic(err)
}
defer res.Body.Close()
out, _ := io.ReadAll(res.Body)
fmt.Println(string(out))
}{
"success": true,
"data": {
"countries": [
{
"code": "TR",
"name": "Turkey"
},
{
"code": "US",
"name": "United States"
},
{
"code": "DE",
"name": "Germany"
},
{
"code": "FR",
"name": "France"
}
]
}
}eSIM Packages
Lists available data packages (GB, validity and price) for a country.
Parameters
| Field | Type | Description | |
|---|---|---|---|
country |
string | optional | Country code (e.g. TR). If empty, popular packages are returned. |
Response fields (data)
| Field | Type | Description |
|---|---|---|
packages[].package_id | string | Package code / ID (used when purchasing) |
packages[].name | string | Package name |
packages[].data_mb | integer | Data quota (MB) |
packages[].duration_days | integer | Validity (days) |
packages[].price | number | Price (TRY) |
curl "https://anindasms.com/api/v1/esim/packages?country=TR" \
-H "Authorization: Bearer YOUR_API_KEY"<?php
$ch = curl_init('https://anindasms.com/api/v1/esim/packages?country=TR');
curl_setopt_array($ch, [
CURLOPT_RETURNTRANSFER => true,
CURLOPT_HTTPHEADER => [
'Authorization: Bearer YOUR_API_KEY',
],
]);
$response = json_decode(curl_exec($ch), true);
curl_close($ch);
print_r($response);import requests
response = requests.get(
"https://anindasms.com/api/v1/esim/packages?country=TR",
headers={"Authorization": "Bearer YOUR_API_KEY"},
)
print(response.json())const res = await fetch("https://anindasms.com/api/v1/esim/packages?country=TR", {
headers: {
"Authorization": "Bearer YOUR_API_KEY",
},
});
console.log(await res.json());using var client = new HttpClient();
client.DefaultRequestHeaders.Add("Authorization", "Bearer YOUR_API_KEY");
var res = await client.GetAsync("https://anindasms.com/api/v1/esim/packages?country=TR");
Console.WriteLine(await res.Content.ReadAsStringAsync());package main
import (
"fmt"
"io"
"net/http"
)
func main() {
req, _ := http.NewRequest("GET", "https://anindasms.com/api/v1/esim/packages?country=TR", nil)
req.Header.Set("Authorization", "Bearer YOUR_API_KEY")
res, err := http.DefaultClient.Do(req)
if err != nil {
panic(err)
}
defer res.Body.Close()
out, _ := io.ReadAll(res.Body)
fmt.Println(string(out))
}{
"success": true,
"data": {
"packages": [
{
"package_id": "pkg_tr_1gb_7d",
"name": "Turkey 1 GB - 7 Gün",
"data_mb": 1024,
"duration_days": 7,
"price": 85
},
{
"package_id": "pkg_tr_3gb_30d",
"name": "Turkey 3 GB - 30 Gün",
"data_mb": 3072,
"duration_days": 30,
"price": 175
},
{
"package_id": "pkg_tr_5gb_30d",
"name": "Turkey 5 GB - 30 Gün",
"data_mb": 5120,
"duration_days": 30,
"price": 250
}
]
}
}Buy eSIM
Purchases the selected eSIM package. Returns the QR code URL and LPA activation string instantly.
Body parameters (JSON)
| Field | Type | Description | |
|---|---|---|---|
package_id |
string | required | Package ID or code |
quantity |
integer | optional | Quantity (default: 1) |
Response fields (data)
| Field | Type | Description |
|---|---|---|
order_id | integer | eSIM order ID |
iccid | string | eSIM ICCID number |
qr_code_url | string | QR code installation image URL |
lpa_string | string | LPA string for manual setup |
status | string | Initial status (active) |
curl -X POST "https://anindasms.com/api/v1/esim/buy" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{"package_id":"pkg_tr_1gb_7d"}'<?php
$ch = curl_init('https://anindasms.com/api/v1/esim/buy');
curl_setopt_array($ch, [
CURLOPT_RETURNTRANSFER => true,
CURLOPT_POST => true,
CURLOPT_HTTPHEADER => [
'Authorization: Bearer YOUR_API_KEY',
'Content-Type: application/json',
],
CURLOPT_POSTFIELDS => json_encode(['package_id' => 'pkg_tr_1gb_7d']),
]);
$response = json_decode(curl_exec($ch), true);
curl_close($ch);
print_r($response);import requests
response = requests.post(
"https://anindasms.com/api/v1/esim/buy",
headers={"Authorization": "Bearer YOUR_API_KEY"},
json={"package_id": "pkg_tr_1gb_7d"},
)
print(response.json())const res = await fetch("https://anindasms.com/api/v1/esim/buy", {
method: "POST",
headers: {
"Authorization": "Bearer YOUR_API_KEY",
"Content-Type": "application/json",
},
body: JSON.stringify({ package_id: "pkg_tr_1gb_7d" }),
});
console.log(await res.json());using var client = new HttpClient();
client.DefaultRequestHeaders.Add("Authorization", "Bearer YOUR_API_KEY");
var body = new StringContent("{\"package_id\":\"pkg_tr_1gb_7d\"}", Encoding.UTF8, "application/json");
var res = await client.PostAsync("https://anindasms.com/api/v1/esim/buy", body);
Console.WriteLine(await res.Content.ReadAsStringAsync());package main
import (
"fmt"
"io"
"net/http"
"strings"
)
func main() {
body := strings.NewReader(`{"package_id":"pkg_tr_1gb_7d"}`)
req, _ := http.NewRequest("POST", "https://anindasms.com/api/v1/esim/buy", body)
req.Header.Set("Authorization", "Bearer YOUR_API_KEY")
req.Header.Set("Content-Type", "application/json")
res, err := http.DefaultClient.Do(req)
if err != nil {
panic(err)
}
defer res.Body.Close()
out, _ := io.ReadAll(res.Body)
fmt.Println(string(out))
}{
"success": true,
"data": {
"order_id": 329,
"iccid": "8985231024829102481",
"qr_code_url": "https://anindasms.com/uploads/esim/qr_329.png",
"lpa_string": "LPA:1$rsp.example.com$MATCHING_ID_329",
"status": "active"
}
}eSIM Orders
Lists all your eSIM orders.
Parameters
| Field | Type | Description | |
|---|---|---|---|
page |
integer | optional | Page |
limit |
integer | optional | Limit |
Response fields (data)
| Field | Type | Description |
|---|---|---|
orders[].order_id | integer | Order ID |
orders[].iccid | string | ICCID |
orders[].status | string | Status |
curl "https://anindasms.com/api/v1/esim/orders" \
-H "Authorization: Bearer YOUR_API_KEY"<?php
$ch = curl_init('https://anindasms.com/api/v1/esim/orders');
curl_setopt_array($ch, [
CURLOPT_RETURNTRANSFER => true,
CURLOPT_HTTPHEADER => [
'Authorization: Bearer YOUR_API_KEY',
],
]);
$response = json_decode(curl_exec($ch), true);
curl_close($ch);
print_r($response);import requests
response = requests.get(
"https://anindasms.com/api/v1/esim/orders",
headers={"Authorization": "Bearer YOUR_API_KEY"},
)
print(response.json())const res = await fetch("https://anindasms.com/api/v1/esim/orders", {
headers: {
"Authorization": "Bearer YOUR_API_KEY",
},
});
console.log(await res.json());using var client = new HttpClient();
client.DefaultRequestHeaders.Add("Authorization", "Bearer YOUR_API_KEY");
var res = await client.GetAsync("https://anindasms.com/api/v1/esim/orders");
Console.WriteLine(await res.Content.ReadAsStringAsync());package main
import (
"fmt"
"io"
"net/http"
)
func main() {
req, _ := http.NewRequest("GET", "https://anindasms.com/api/v1/esim/orders", nil)
req.Header.Set("Authorization", "Bearer YOUR_API_KEY")
res, err := http.DefaultClient.Do(req)
if err != nil {
panic(err)
}
defer res.Body.Close()
out, _ := io.ReadAll(res.Body)
fmt.Println(string(out))
}{
"success": true,
"data": {
"orders": [
{
"order_id": 329,
"iccid": "8985231024829102481",
"status": "active"
}
]
}
}eSIM Order Detail
Fetches details, data usage, and installation info of an eSIM order.
Parameters
| Field | Type | Description | |
|---|---|---|---|
id |
integer | required | eSIM order ID (in URL) |
Response fields (data)
| Field | Type | Description |
|---|---|---|
order_id | integer | Order ID |
iccid | string | ICCID |
qr_code_url | string | QR code URL |
lpa_string | string | LPA string |
data_total_mb | integer | Total data (MB) |
data_used_mb | integer | Used data (MB) |
status | string | Status |
curl "https://anindasms.com/api/v1/esim/orders/329" \
-H "Authorization: Bearer YOUR_API_KEY"<?php
$ch = curl_init('https://anindasms.com/api/v1/esim/orders/329');
curl_setopt_array($ch, [
CURLOPT_RETURNTRANSFER => true,
CURLOPT_HTTPHEADER => [
'Authorization: Bearer YOUR_API_KEY',
],
]);
$response = json_decode(curl_exec($ch), true);
curl_close($ch);
print_r($response);import requests
response = requests.get(
"https://anindasms.com/api/v1/esim/orders/329",
headers={"Authorization": "Bearer YOUR_API_KEY"},
)
print(response.json())const res = await fetch("https://anindasms.com/api/v1/esim/orders/329", {
headers: {
"Authorization": "Bearer YOUR_API_KEY",
},
});
console.log(await res.json());using var client = new HttpClient();
client.DefaultRequestHeaders.Add("Authorization", "Bearer YOUR_API_KEY");
var res = await client.GetAsync("https://anindasms.com/api/v1/esim/orders/329");
Console.WriteLine(await res.Content.ReadAsStringAsync());package main
import (
"fmt"
"io"
"net/http"
)
func main() {
req, _ := http.NewRequest("GET", "https://anindasms.com/api/v1/esim/orders/329", nil)
req.Header.Set("Authorization", "Bearer YOUR_API_KEY")
res, err := http.DefaultClient.Do(req)
if err != nil {
panic(err)
}
defer res.Body.Close()
out, _ := io.ReadAll(res.Body)
fmt.Println(string(out))
}{
"success": true,
"data": {
"order_id": 329,
"iccid": "8985231024829102481",
"qr_code_url": "https://anindasms.com/uploads/esim/qr_329.png",
"lpa_string": "LPA:1$rsp.example.com$MATCHING_ID_329",
"data_total_mb": 1024,
"data_used_mb": 140,
"status": "active"
}
}eSIM Topup
Adds a topup data package to an existing eSIM order.
Body parameters (JSON)
| Field | Type | Description | |
|---|---|---|---|
id |
integer | required | eSIM order ID (in URL) |
package_id |
string | required | Topup package ID |
Response fields (data)
| Field | Type | Description |
|---|---|---|
order_id | integer | Order ID |
status | string | success |
balance | number | Balance after topup |
curl -X POST "https://anindasms.com/api/v1/esim/orders/329/topup" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{"package_id":"pkg_tr_1gb_7d"}'<?php
$ch = curl_init('https://anindasms.com/api/v1/esim/orders/329/topup');
curl_setopt_array($ch, [
CURLOPT_RETURNTRANSFER => true,
CURLOPT_POST => true,
CURLOPT_HTTPHEADER => [
'Authorization: Bearer YOUR_API_KEY',
'Content-Type: application/json',
],
CURLOPT_POSTFIELDS => json_encode(['package_id' => 'pkg_tr_1gb_7d']),
]);
$response = json_decode(curl_exec($ch), true);
curl_close($ch);
print_r($response);import requests
response = requests.post(
"https://anindasms.com/api/v1/esim/orders/329/topup",
headers={"Authorization": "Bearer YOUR_API_KEY"},
json={"package_id": "pkg_tr_1gb_7d"},
)
print(response.json())const res = await fetch("https://anindasms.com/api/v1/esim/orders/329/topup", {
method: "POST",
headers: {
"Authorization": "Bearer YOUR_API_KEY",
"Content-Type": "application/json",
},
body: JSON.stringify({ package_id: "pkg_tr_1gb_7d" }),
});
console.log(await res.json());using var client = new HttpClient();
client.DefaultRequestHeaders.Add("Authorization", "Bearer YOUR_API_KEY");
var body = new StringContent("{\"package_id\":\"pkg_tr_1gb_7d\"}", Encoding.UTF8, "application/json");
var res = await client.PostAsync("https://anindasms.com/api/v1/esim/orders/329/topup", body);
Console.WriteLine(await res.Content.ReadAsStringAsync());package main
import (
"fmt"
"io"
"net/http"
"strings"
)
func main() {
body := strings.NewReader(`{"package_id":"pkg_tr_1gb_7d"}`)
req, _ := http.NewRequest("POST", "https://anindasms.com/api/v1/esim/orders/329/topup", body)
req.Header.Set("Authorization", "Bearer YOUR_API_KEY")
req.Header.Set("Content-Type", "application/json")
res, err := http.DefaultClient.Do(req)
if err != nil {
panic(err)
}
defer res.Body.Close()
out, _ := io.ReadAll(res.Body)
fmt.Println(string(out))
}{
"success": true,
"data": {
"order_id": 329,
"status": "success",
"balance": 115
}
}Mail Domains
Lists active domains available for temporary email creation.
Response fields (data)
| Field | Type | Description |
|---|---|---|
domains[].domain | string | Domain name (e.g. mailtemp.me) |
domains[].is_active | boolean | Whether active |
curl "https://anindasms.com/api/v1/mail/domains" \
-H "Authorization: Bearer YOUR_API_KEY"<?php
$ch = curl_init('https://anindasms.com/api/v1/mail/domains');
curl_setopt_array($ch, [
CURLOPT_RETURNTRANSFER => true,
CURLOPT_HTTPHEADER => [
'Authorization: Bearer YOUR_API_KEY',
],
]);
$response = json_decode(curl_exec($ch), true);
curl_close($ch);
print_r($response);import requests
response = requests.get(
"https://anindasms.com/api/v1/mail/domains",
headers={"Authorization": "Bearer YOUR_API_KEY"},
)
print(response.json())const res = await fetch("https://anindasms.com/api/v1/mail/domains", {
headers: {
"Authorization": "Bearer YOUR_API_KEY",
},
});
console.log(await res.json());using var client = new HttpClient();
client.DefaultRequestHeaders.Add("Authorization", "Bearer YOUR_API_KEY");
var res = await client.GetAsync("https://anindasms.com/api/v1/mail/domains");
Console.WriteLine(await res.Content.ReadAsStringAsync());package main
import (
"fmt"
"io"
"net/http"
)
func main() {
req, _ := http.NewRequest("GET", "https://anindasms.com/api/v1/mail/domains", nil)
req.Header.Set("Authorization", "Bearer YOUR_API_KEY")
res, err := http.DefaultClient.Do(req)
if err != nil {
panic(err)
}
defer res.Body.Close()
out, _ := io.ReadAll(res.Body)
fmt.Println(string(out))
}{
"success": true,
"data": {
"domains": [
{
"domain": "tempmail.com.tr",
"is_active": true
},
{
"domain": "fastinbox.net",
"is_active": true
}
]
}
}Create Temporary Mailbox
Creates a temporary email inbox. Incoming messages can be read via API during its lifetime.
Body parameters (JSON)
| Field | Type | Description | |
|---|---|---|---|
duration |
integer | optional | Validity in minutes (default: 60) |
domain |
string | optional | Preferred domain. Auto-selected if empty. |
prefix |
string | optional | Preferred username prefix. Randomly generated if empty. |
Response fields (data)
| Field | Type | Description |
|---|---|---|
order_id | integer | Mail order ID |
email | string | Generated email address |
cost | number | Charged amount (TRY) |
expires_at | datetime | Expiration datetime |
curl -X POST "https://anindasms.com/api/v1/mail/create" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{"duration":60}'<?php
$ch = curl_init('https://anindasms.com/api/v1/mail/create');
curl_setopt_array($ch, [
CURLOPT_RETURNTRANSFER => true,
CURLOPT_POST => true,
CURLOPT_HTTPHEADER => [
'Authorization: Bearer YOUR_API_KEY',
'Content-Type: application/json',
],
CURLOPT_POSTFIELDS => json_encode(['duration' => '60']),
]);
$response = json_decode(curl_exec($ch), true);
curl_close($ch);
print_r($response);import requests
response = requests.post(
"https://anindasms.com/api/v1/mail/create",
headers={"Authorization": "Bearer YOUR_API_KEY"},
json={"duration": "60"},
)
print(response.json())const res = await fetch("https://anindasms.com/api/v1/mail/create", {
method: "POST",
headers: {
"Authorization": "Bearer YOUR_API_KEY",
"Content-Type": "application/json",
},
body: JSON.stringify({ duration: "60" }),
});
console.log(await res.json());using var client = new HttpClient();
client.DefaultRequestHeaders.Add("Authorization", "Bearer YOUR_API_KEY");
var body = new StringContent("{\"duration\":60}", Encoding.UTF8, "application/json");
var res = await client.PostAsync("https://anindasms.com/api/v1/mail/create", body);
Console.WriteLine(await res.Content.ReadAsStringAsync());package main
import (
"fmt"
"io"
"net/http"
"strings"
)
func main() {
body := strings.NewReader(`{"duration":60}`)
req, _ := http.NewRequest("POST", "https://anindasms.com/api/v1/mail/create", body)
req.Header.Set("Authorization", "Bearer YOUR_API_KEY")
req.Header.Set("Content-Type", "application/json")
res, err := http.DefaultClient.Do(req)
if err != nil {
panic(err)
}
defer res.Body.Close()
out, _ := io.ReadAll(res.Body)
fmt.Println(string(out))
}{
"success": true,
"data": {
"order_id": 892,
"email": "[email protected]",
"cost": 5,
"expires_at": "2026-10-24 15:00:00"
}
}My Mailboxes
Lists your temporary mailbox orders.
Parameters
| Field | Type | Description | |
|---|---|---|---|
page |
integer | optional | Page |
limit |
integer | optional | Limit |
Response fields (data)
| Field | Type | Description |
|---|---|---|
orders[].order_id | integer | Order ID |
orders[].email | string | |
orders[].status | string | Status (active, expired, cancelled) |
orders[].expires_at | datetime | Expiration |
curl "https://anindasms.com/api/v1/mail/orders" \
-H "Authorization: Bearer YOUR_API_KEY"<?php
$ch = curl_init('https://anindasms.com/api/v1/mail/orders');
curl_setopt_array($ch, [
CURLOPT_RETURNTRANSFER => true,
CURLOPT_HTTPHEADER => [
'Authorization: Bearer YOUR_API_KEY',
],
]);
$response = json_decode(curl_exec($ch), true);
curl_close($ch);
print_r($response);import requests
response = requests.get(
"https://anindasms.com/api/v1/mail/orders",
headers={"Authorization": "Bearer YOUR_API_KEY"},
)
print(response.json())const res = await fetch("https://anindasms.com/api/v1/mail/orders", {
headers: {
"Authorization": "Bearer YOUR_API_KEY",
},
});
console.log(await res.json());using var client = new HttpClient();
client.DefaultRequestHeaders.Add("Authorization", "Bearer YOUR_API_KEY");
var res = await client.GetAsync("https://anindasms.com/api/v1/mail/orders");
Console.WriteLine(await res.Content.ReadAsStringAsync());package main
import (
"fmt"
"io"
"net/http"
)
func main() {
req, _ := http.NewRequest("GET", "https://anindasms.com/api/v1/mail/orders", nil)
req.Header.Set("Authorization", "Bearer YOUR_API_KEY")
res, err := http.DefaultClient.Do(req)
if err != nil {
panic(err)
}
defer res.Body.Close()
out, _ := io.ReadAll(res.Body)
fmt.Println(string(out))
}{
"success": true,
"data": {
"orders": [
{
"order_id": 892,
"email": "[email protected]",
"status": "active",
"expires_at": "2026-10-24 15:00:00"
}
]
}
}Mailbox Detail
Returns status of a temporary mailbox.
Parameters
| Field | Type | Description | |
|---|---|---|---|
id |
integer | required | Order ID (URL) |
Response fields (data)
| Field | Type | Description |
|---|---|---|
order_id | integer | Order ID |
email | string | |
status | string | Status |
expires_at | datetime | Expiration |
curl "https://anindasms.com/api/v1/mail/orders/892" \
-H "Authorization: Bearer YOUR_API_KEY"<?php
$ch = curl_init('https://anindasms.com/api/v1/mail/orders/892');
curl_setopt_array($ch, [
CURLOPT_RETURNTRANSFER => true,
CURLOPT_HTTPHEADER => [
'Authorization: Bearer YOUR_API_KEY',
],
]);
$response = json_decode(curl_exec($ch), true);
curl_close($ch);
print_r($response);import requests
response = requests.get(
"https://anindasms.com/api/v1/mail/orders/892",
headers={"Authorization": "Bearer YOUR_API_KEY"},
)
print(response.json())const res = await fetch("https://anindasms.com/api/v1/mail/orders/892", {
headers: {
"Authorization": "Bearer YOUR_API_KEY",
},
});
console.log(await res.json());using var client = new HttpClient();
client.DefaultRequestHeaders.Add("Authorization", "Bearer YOUR_API_KEY");
var res = await client.GetAsync("https://anindasms.com/api/v1/mail/orders/892");
Console.WriteLine(await res.Content.ReadAsStringAsync());package main
import (
"fmt"
"io"
"net/http"
)
func main() {
req, _ := http.NewRequest("GET", "https://anindasms.com/api/v1/mail/orders/892", nil)
req.Header.Set("Authorization", "Bearer YOUR_API_KEY")
res, err := http.DefaultClient.Do(req)
if err != nil {
panic(err)
}
defer res.Body.Close()
out, _ := io.ReadAll(res.Body)
fmt.Println(string(out))
}{
"success": true,
"data": {
"order_id": 892,
"email": "[email protected]",
"status": "active",
"expires_at": "2026-10-24 15:00:00"
}
}Read Inbox Messages
Fetches all incoming messages (sender, subject, HTML and plain text bodies) received in the mailbox.
Parameters
| Field | Type | Description | |
|---|---|---|---|
id |
integer | required | Order ID (URL) |
Response fields (data)
| Field | Type | Description |
|---|---|---|
messages[].id | integer | Message ID |
messages[].from | string | Sender email |
messages[].subject | string | Subject |
messages[].body_text | string | Plain text body |
messages[].body_html | string | HTML body |
messages[].received_at | datetime | Received datetime |
curl "https://anindasms.com/api/v1/mail/orders/892/messages" \
-H "Authorization: Bearer YOUR_API_KEY"<?php
$ch = curl_init('https://anindasms.com/api/v1/mail/orders/892/messages');
curl_setopt_array($ch, [
CURLOPT_RETURNTRANSFER => true,
CURLOPT_HTTPHEADER => [
'Authorization: Bearer YOUR_API_KEY',
],
]);
$response = json_decode(curl_exec($ch), true);
curl_close($ch);
print_r($response);import requests
response = requests.get(
"https://anindasms.com/api/v1/mail/orders/892/messages",
headers={"Authorization": "Bearer YOUR_API_KEY"},
)
print(response.json())const res = await fetch("https://anindasms.com/api/v1/mail/orders/892/messages", {
headers: {
"Authorization": "Bearer YOUR_API_KEY",
},
});
console.log(await res.json());using var client = new HttpClient();
client.DefaultRequestHeaders.Add("Authorization", "Bearer YOUR_API_KEY");
var res = await client.GetAsync("https://anindasms.com/api/v1/mail/orders/892/messages");
Console.WriteLine(await res.Content.ReadAsStringAsync());package main
import (
"fmt"
"io"
"net/http"
)
func main() {
req, _ := http.NewRequest("GET", "https://anindasms.com/api/v1/mail/orders/892/messages", nil)
req.Header.Set("Authorization", "Bearer YOUR_API_KEY")
res, err := http.DefaultClient.Do(req)
if err != nil {
panic(err)
}
defer res.Body.Close()
out, _ := io.ReadAll(res.Body)
fmt.Println(string(out))
}{
"success": true,
"data": {
"messages": [
{
"id": 1,
"from": "[email protected]",
"subject": "Hesap Doğrulama Kodunuz: 938214",
"body_text": "Doğrulama kodunuz: 938214",
"body_html": "<p>Doğrulama kodunuz: <b>938214</b></p>",
"received_at": "2026-10-24 14:15:22"
}
]
}
}Extend Mailbox
Extends the validity of a temporary mailbox.
Body parameters (JSON)
| Field | Type | Description | |
|---|---|---|---|
id |
integer | required | Order ID (URL) |
duration |
integer | optional | Duration to add in minutes (default: 60) |
Response fields (data)
| Field | Type | Description |
|---|---|---|
order_id | integer | Order ID |
expires_at | datetime | New expiration datetime |
balance | number | Balance after operation |
curl -X POST "https://anindasms.com/api/v1/mail/orders/892/extend" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{"duration":60}'<?php
$ch = curl_init('https://anindasms.com/api/v1/mail/orders/892/extend');
curl_setopt_array($ch, [
CURLOPT_RETURNTRANSFER => true,
CURLOPT_POST => true,
CURLOPT_HTTPHEADER => [
'Authorization: Bearer YOUR_API_KEY',
'Content-Type: application/json',
],
CURLOPT_POSTFIELDS => json_encode(['duration' => '60']),
]);
$response = json_decode(curl_exec($ch), true);
curl_close($ch);
print_r($response);import requests
response = requests.post(
"https://anindasms.com/api/v1/mail/orders/892/extend",
headers={"Authorization": "Bearer YOUR_API_KEY"},
json={"duration": "60"},
)
print(response.json())const res = await fetch("https://anindasms.com/api/v1/mail/orders/892/extend", {
method: "POST",
headers: {
"Authorization": "Bearer YOUR_API_KEY",
"Content-Type": "application/json",
},
body: JSON.stringify({ duration: "60" }),
});
console.log(await res.json());using var client = new HttpClient();
client.DefaultRequestHeaders.Add("Authorization", "Bearer YOUR_API_KEY");
var body = new StringContent("{\"duration\":60}", Encoding.UTF8, "application/json");
var res = await client.PostAsync("https://anindasms.com/api/v1/mail/orders/892/extend", body);
Console.WriteLine(await res.Content.ReadAsStringAsync());package main
import (
"fmt"
"io"
"net/http"
"strings"
)
func main() {
body := strings.NewReader(`{"duration":60}`)
req, _ := http.NewRequest("POST", "https://anindasms.com/api/v1/mail/orders/892/extend", body)
req.Header.Set("Authorization", "Bearer YOUR_API_KEY")
req.Header.Set("Content-Type", "application/json")
res, err := http.DefaultClient.Do(req)
if err != nil {
panic(err)
}
defer res.Body.Close()
out, _ := io.ReadAll(res.Body)
fmt.Println(string(out))
}{
"success": true,
"data": {
"order_id": 892,
"expires_at": "2026-10-24 16:00:00",
"balance": 95
}
}Cancel / Delete Mailbox
Immediately closes and deletes the temporary mailbox.
Parameters
| Field | Type | Description | |
|---|---|---|---|
id |
integer | required | Order ID (URL) |
Response fields (data)
| Field | Type | Description |
|---|---|---|
order_id | integer | Order ID |
status | string | cancelled |
curl -X POST "https://anindasms.com/api/v1/mail/orders/892/cancel" \
-H "Authorization: Bearer YOUR_API_KEY"<?php
$ch = curl_init('https://anindasms.com/api/v1/mail/orders/892/cancel');
curl_setopt_array($ch, [
CURLOPT_RETURNTRANSFER => true,
CURLOPT_POST => true,
CURLOPT_HTTPHEADER => [
'Authorization: Bearer YOUR_API_KEY',
],
]);
$response = json_decode(curl_exec($ch), true);
curl_close($ch);
print_r($response);import requests
response = requests.post(
"https://anindasms.com/api/v1/mail/orders/892/cancel",
headers={"Authorization": "Bearer YOUR_API_KEY"},
)
print(response.json())const res = await fetch("https://anindasms.com/api/v1/mail/orders/892/cancel", {
method: "POST",
headers: {
"Authorization": "Bearer YOUR_API_KEY",
},
});
console.log(await res.json());using var client = new HttpClient();
client.DefaultRequestHeaders.Add("Authorization", "Bearer YOUR_API_KEY");
var res = await client.PostAsync("https://anindasms.com/api/v1/mail/orders/892/cancel", null);
Console.WriteLine(await res.Content.ReadAsStringAsync());package main
import (
"fmt"
"io"
"net/http"
)
func main() {
req, _ := http.NewRequest("POST", "https://anindasms.com/api/v1/mail/orders/892/cancel", nil)
req.Header.Set("Authorization", "Bearer YOUR_API_KEY")
res, err := http.DefaultClient.Do(req)
if err != nil {
panic(err)
}
defer res.Body.Close()
out, _ := io.ReadAll(res.Body)
fmt.Println(string(out))
}{
"success": true,
"data": {
"order_id": 892,
"status": "cancelled"
}
}Rental Durations
Lists supported rental duration options (in hours) available on the platform.
Response fields (data)
| Field | Type | Description |
|---|---|---|
durations[].hours | integer | Rental duration (hours) |
durations[].label | string | Display label (e.g. 24 Hours, 3 Days) |
curl "https://anindasms.com/api/v1/rent/durations" \
-H "Authorization: Bearer YOUR_API_KEY"<?php
$ch = curl_init('https://anindasms.com/api/v1/rent/durations');
curl_setopt_array($ch, [
CURLOPT_RETURNTRANSFER => true,
CURLOPT_HTTPHEADER => [
'Authorization: Bearer YOUR_API_KEY',
],
]);
$response = json_decode(curl_exec($ch), true);
curl_close($ch);
print_r($response);import requests
response = requests.get(
"https://anindasms.com/api/v1/rent/durations",
headers={"Authorization": "Bearer YOUR_API_KEY"},
)
print(response.json())const res = await fetch("https://anindasms.com/api/v1/rent/durations", {
headers: {
"Authorization": "Bearer YOUR_API_KEY",
},
});
console.log(await res.json());using var client = new HttpClient();
client.DefaultRequestHeaders.Add("Authorization", "Bearer YOUR_API_KEY");
var res = await client.GetAsync("https://anindasms.com/api/v1/rent/durations");
Console.WriteLine(await res.Content.ReadAsStringAsync());package main
import (
"fmt"
"io"
"net/http"
)
func main() {
req, _ := http.NewRequest("GET", "https://anindasms.com/api/v1/rent/durations", nil)
req.Header.Set("Authorization", "Bearer YOUR_API_KEY")
res, err := http.DefaultClient.Do(req)
if err != nil {
panic(err)
}
defer res.Body.Close()
out, _ := io.ReadAll(res.Body)
fmt.Println(string(out))
}{
"success": true,
"data": {
"durations": [
{
"hours": 4,
"label": "4 Saat"
},
{
"hours": 24,
"label": "24 Saat (1 Gün)"
},
{
"hours": 72,
"label": "3 Gün"
},
{
"hours": 168,
"label": "1 Hafta"
},
{
"hours": 720,
"label": "1 Ay (30 Gün)"
}
]
}
}Rental Countries
Lists countries available for rental under the specified duration.
Parameters
| Field | Type | Description | |
|---|---|---|---|
duration |
integer | optional | Duration in hours (default: 24) |
Response fields (data)
| Field | Type | Description |
|---|---|---|
countries[].id | string | Country ID |
countries[].code | string | 2-letter ISO country code |
countries[].name | string | Country name |
curl "https://anindasms.com/api/v1/rent/countries?duration=24" \
-H "Authorization: Bearer YOUR_API_KEY"<?php
$ch = curl_init('https://anindasms.com/api/v1/rent/countries?duration=24');
curl_setopt_array($ch, [
CURLOPT_RETURNTRANSFER => true,
CURLOPT_HTTPHEADER => [
'Authorization: Bearer YOUR_API_KEY',
],
]);
$response = json_decode(curl_exec($ch), true);
curl_close($ch);
print_r($response);import requests
response = requests.get(
"https://anindasms.com/api/v1/rent/countries?duration=24",
headers={"Authorization": "Bearer YOUR_API_KEY"},
)
print(response.json())const res = await fetch("https://anindasms.com/api/v1/rent/countries?duration=24", {
headers: {
"Authorization": "Bearer YOUR_API_KEY",
},
});
console.log(await res.json());using var client = new HttpClient();
client.DefaultRequestHeaders.Add("Authorization", "Bearer YOUR_API_KEY");
var res = await client.GetAsync("https://anindasms.com/api/v1/rent/countries?duration=24");
Console.WriteLine(await res.Content.ReadAsStringAsync());package main
import (
"fmt"
"io"
"net/http"
)
func main() {
req, _ := http.NewRequest("GET", "https://anindasms.com/api/v1/rent/countries?duration=24", nil)
req.Header.Set("Authorization", "Bearer YOUR_API_KEY")
res, err := http.DefaultClient.Do(req)
if err != nil {
panic(err)
}
defer res.Body.Close()
out, _ := io.ReadAll(res.Body)
fmt.Println(string(out))
}{
"success": true,
"data": {
"duration": 24,
"countries": [
{
"id": "62",
"code": "62",
"name": "Turkey"
},
{
"id": "16",
"code": "16",
"name": "United Kingdom"
},
{
"id": "187",
"code": "187",
"name": "United States"
}
]
}
}Rental Services & Prices
Returns rentable services, current stock, and TRY prices for the selected country and duration.
Parameters
| Field | Type | Description | |
|---|---|---|---|
country |
string | required | Country ID or code (e.g. 62) |
duration |
integer | optional | Duration in hours (default: 24) |
Response fields (data)
| Field | Type | Description |
|---|---|---|
services[].service | string | Service code (e.g. wa, tg, full) |
services[].name | string | Service name |
services[].stock | integer | Available stock |
services[].price | number | User price (TRY) |
services[].formatted | string | Formatted price |
curl "https://anindasms.com/api/v1/rent/services?country=62&duration=24" \
-H "Authorization: Bearer YOUR_API_KEY"<?php
$ch = curl_init('https://anindasms.com/api/v1/rent/services?country=62&duration=24');
curl_setopt_array($ch, [
CURLOPT_RETURNTRANSFER => true,
CURLOPT_HTTPHEADER => [
'Authorization: Bearer YOUR_API_KEY',
],
]);
$response = json_decode(curl_exec($ch), true);
curl_close($ch);
print_r($response);import requests
response = requests.get(
"https://anindasms.com/api/v1/rent/services?country=62&duration=24",
headers={"Authorization": "Bearer YOUR_API_KEY"},
)
print(response.json())const res = await fetch("https://anindasms.com/api/v1/rent/services?country=62&duration=24", {
headers: {
"Authorization": "Bearer YOUR_API_KEY",
},
});
console.log(await res.json());using var client = new HttpClient();
client.DefaultRequestHeaders.Add("Authorization", "Bearer YOUR_API_KEY");
var res = await client.GetAsync("https://anindasms.com/api/v1/rent/services?country=62&duration=24");
Console.WriteLine(await res.Content.ReadAsStringAsync());package main
import (
"fmt"
"io"
"net/http"
)
func main() {
req, _ := http.NewRequest("GET", "https://anindasms.com/api/v1/rent/services?country=62&duration=24", nil)
req.Header.Set("Authorization", "Bearer YOUR_API_KEY")
res, err := http.DefaultClient.Do(req)
if err != nil {
panic(err)
}
defer res.Body.Close()
out, _ := io.ReadAll(res.Body)
fmt.Println(string(out))
}{
"success": true,
"data": {
"country": "62",
"duration": 24,
"services": [
{
"service": "wa",
"name": "WhatsApp",
"stock": 54,
"price": 125,
"formatted": "₺125,00",
"duration": 24
},
{
"service": "tg",
"name": "Telegram",
"stock": 38,
"price": 110,
"formatted": "₺110,00",
"duration": 24
},
{
"service": "full",
"name": "Tüm Servisler (Full Rent)",
"stock": 18,
"price": 240,
"formatted": "₺240,00",
"duration": 24
}
]
}
}Rental Price Quote
Fetches the live quote and stock for a specific service, country, and duration.
Parameters
| Field | Type | Description | |
|---|---|---|---|
service |
string | required | Service code (e.g. wa) |
country |
string | required | Country code |
duration |
integer | optional | Duration in hours (default: 24) |
Response fields (data)
| Field | Type | Description |
|---|---|---|
service | string | Service code |
country | string | Country code |
duration | integer | Duration hours |
price | number | User price (TRY) |
formatted | string | Formatted price |
stock | integer | Available stock |
curl "https://anindasms.com/api/v1/rent/prices?service=wa&country=62&duration=24" \
-H "Authorization: Bearer YOUR_API_KEY"<?php
$ch = curl_init('https://anindasms.com/api/v1/rent/prices?service=wa&country=62&duration=24');
curl_setopt_array($ch, [
CURLOPT_RETURNTRANSFER => true,
CURLOPT_HTTPHEADER => [
'Authorization: Bearer YOUR_API_KEY',
],
]);
$response = json_decode(curl_exec($ch), true);
curl_close($ch);
print_r($response);import requests
response = requests.get(
"https://anindasms.com/api/v1/rent/prices?service=wa&country=62&duration=24",
headers={"Authorization": "Bearer YOUR_API_KEY"},
)
print(response.json())const res = await fetch("https://anindasms.com/api/v1/rent/prices?service=wa&country=62&duration=24", {
headers: {
"Authorization": "Bearer YOUR_API_KEY",
},
});
console.log(await res.json());using var client = new HttpClient();
client.DefaultRequestHeaders.Add("Authorization", "Bearer YOUR_API_KEY");
var res = await client.GetAsync("https://anindasms.com/api/v1/rent/prices?service=wa&country=62&duration=24");
Console.WriteLine(await res.Content.ReadAsStringAsync());package main
import (
"fmt"
"io"
"net/http"
)
func main() {
req, _ := http.NewRequest("GET", "https://anindasms.com/api/v1/rent/prices?service=wa&country=62&duration=24", nil)
req.Header.Set("Authorization", "Bearer YOUR_API_KEY")
res, err := http.DefaultClient.Do(req)
if err != nil {
panic(err)
}
defer res.Body.Close()
out, _ := io.ReadAll(res.Body)
fmt.Println(string(out))
}{
"success": true,
"data": {
"service": "wa",
"country": "62",
"duration": 24,
"price": 125,
"formatted": "₺125,00",
"stock": 54
}
}Rent Number
Rents a number for the selected service, country, and duration. Deducts balance and delivers the phone number instantly. You can receive unlimited SMS messages during the rental window.
Body parameters (JSON)
| Field | Type | Description | |
|---|---|---|---|
service |
string | required | Service code (e.g. wa or full) |
country |
string | required | Country ID (e.g. 62) |
duration |
integer | optional | Duration in hours (default: 24) |
Response fields (data)
| Field | Type | Description |
|---|---|---|
order_id | integer | Rental order ID |
phone | string | Rented phone number |
service | string | Service |
country | string | Country |
duration | integer | Duration in hours |
cost | number | Charged amount (TRY) |
balance | number | Balance after order |
status | string | Status: waiting |
expires_at | datetime | Rental expiration datetime |
curl -X POST "https://anindasms.com/api/v1/rent/buy" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{"service":"wa","country":"62","duration":24}'<?php
$ch = curl_init('https://anindasms.com/api/v1/rent/buy');
curl_setopt_array($ch, [
CURLOPT_RETURNTRANSFER => true,
CURLOPT_POST => true,
CURLOPT_HTTPHEADER => [
'Authorization: Bearer YOUR_API_KEY',
'Content-Type: application/json',
],
CURLOPT_POSTFIELDS => json_encode(['service' => 'wa', 'country' => '62', 'duration' => '24']),
]);
$response = json_decode(curl_exec($ch), true);
curl_close($ch);
print_r($response);import requests
response = requests.post(
"https://anindasms.com/api/v1/rent/buy",
headers={"Authorization": "Bearer YOUR_API_KEY"},
json={"service": "wa", "country": "62", "duration": "24"},
)
print(response.json())const res = await fetch("https://anindasms.com/api/v1/rent/buy", {
method: "POST",
headers: {
"Authorization": "Bearer YOUR_API_KEY",
"Content-Type": "application/json",
},
body: JSON.stringify({ service: "wa", country: "62", duration: "24" }),
});
console.log(await res.json());using var client = new HttpClient();
client.DefaultRequestHeaders.Add("Authorization", "Bearer YOUR_API_KEY");
var body = new StringContent("{\"service\":\"wa\",\"country\":\"62\",\"duration\":24}", Encoding.UTF8, "application/json");
var res = await client.PostAsync("https://anindasms.com/api/v1/rent/buy", body);
Console.WriteLine(await res.Content.ReadAsStringAsync());package main
import (
"fmt"
"io"
"net/http"
"strings"
)
func main() {
body := strings.NewReader(`{"service":"wa","country":"62","duration":24}`)
req, _ := http.NewRequest("POST", "https://anindasms.com/api/v1/rent/buy", body)
req.Header.Set("Authorization", "Bearer YOUR_API_KEY")
req.Header.Set("Content-Type", "application/json")
res, err := http.DefaultClient.Do(req)
if err != nil {
panic(err)
}
defer res.Body.Close()
out, _ := io.ReadAll(res.Body)
fmt.Println(string(out))
}{
"success": true,
"data": {
"order_id": 74102,
"phone": "+905559876543",
"service": "wa",
"country": "62",
"duration": 24,
"cost": 125,
"balance": 250,
"status": "waiting",
"expires_at": "2026-10-25 14:00:00"
}
}My Rental Orders
Lists all active and concluded rental orders in your account.
Response fields (data)
| Field | Type | Description |
|---|---|---|
orders[].order_id | integer | Order ID |
orders[].phone | string | Phone number |
orders[].service | string | Service |
orders[].country | string | Country |
orders[].status | string | Status (waiting, received, done, expired, cancelled) |
orders[].cost | number | Cost (TRY) |
orders[].rent_time_hours | integer | Rental hours |
orders[].sms_count | integer | Received SMS count |
orders[].expires_at | datetime | Expiration datetime |
curl "https://anindasms.com/api/v1/rent/orders" \
-H "Authorization: Bearer YOUR_API_KEY"<?php
$ch = curl_init('https://anindasms.com/api/v1/rent/orders');
curl_setopt_array($ch, [
CURLOPT_RETURNTRANSFER => true,
CURLOPT_HTTPHEADER => [
'Authorization: Bearer YOUR_API_KEY',
],
]);
$response = json_decode(curl_exec($ch), true);
curl_close($ch);
print_r($response);import requests
response = requests.get(
"https://anindasms.com/api/v1/rent/orders",
headers={"Authorization": "Bearer YOUR_API_KEY"},
)
print(response.json())const res = await fetch("https://anindasms.com/api/v1/rent/orders", {
headers: {
"Authorization": "Bearer YOUR_API_KEY",
},
});
console.log(await res.json());using var client = new HttpClient();
client.DefaultRequestHeaders.Add("Authorization", "Bearer YOUR_API_KEY");
var res = await client.GetAsync("https://anindasms.com/api/v1/rent/orders");
Console.WriteLine(await res.Content.ReadAsStringAsync());package main
import (
"fmt"
"io"
"net/http"
)
func main() {
req, _ := http.NewRequest("GET", "https://anindasms.com/api/v1/rent/orders", nil)
req.Header.Set("Authorization", "Bearer YOUR_API_KEY")
res, err := http.DefaultClient.Do(req)
if err != nil {
panic(err)
}
defer res.Body.Close()
out, _ := io.ReadAll(res.Body)
fmt.Println(string(out))
}{
"success": true,
"data": {
"orders": [
{
"order_id": 74102,
"phone": "+905559876543",
"service": "wa",
"country": "62",
"status": "waiting",
"cost": 125,
"rent_time_hours": 24,
"sms_count": 1,
"created_at": "2026-10-24 14:00:00",
"expires_at": "2026-10-25 14:00:00"
}
]
}
}Rental Order & SMS Log
Fetches the rental status, remaining time, and all SMS verification codes and texts received during the rental window.
Parameters
| Field | Type | Description | |
|---|---|---|---|
id |
integer | required | Rental order ID (URL) |
Response fields (data)
| Field | Type | Description |
|---|---|---|
order_id | integer | Order ID |
phone | string | Phone |
status | string | waiting · received · done · expired · cancelled |
remaining | integer | Remaining seconds |
can_cancel | boolean | Can cancel (first 20 min if no SMS) |
sms_list | array | All received SMS messages |
sms_list[].code | string | Verification code |
sms_list[].text | string | Full SMS text |
sms_list[].date | string | Received time |
curl "https://anindasms.com/api/v1/rent/orders/74102" \
-H "Authorization: Bearer YOUR_API_KEY"<?php
$ch = curl_init('https://anindasms.com/api/v1/rent/orders/74102');
curl_setopt_array($ch, [
CURLOPT_RETURNTRANSFER => true,
CURLOPT_HTTPHEADER => [
'Authorization: Bearer YOUR_API_KEY',
],
]);
$response = json_decode(curl_exec($ch), true);
curl_close($ch);
print_r($response);import requests
response = requests.get(
"https://anindasms.com/api/v1/rent/orders/74102",
headers={"Authorization": "Bearer YOUR_API_KEY"},
)
print(response.json())const res = await fetch("https://anindasms.com/api/v1/rent/orders/74102", {
headers: {
"Authorization": "Bearer YOUR_API_KEY",
},
});
console.log(await res.json());using var client = new HttpClient();
client.DefaultRequestHeaders.Add("Authorization", "Bearer YOUR_API_KEY");
var res = await client.GetAsync("https://anindasms.com/api/v1/rent/orders/74102");
Console.WriteLine(await res.Content.ReadAsStringAsync());package main
import (
"fmt"
"io"
"net/http"
)
func main() {
req, _ := http.NewRequest("GET", "https://anindasms.com/api/v1/rent/orders/74102", nil)
req.Header.Set("Authorization", "Bearer YOUR_API_KEY")
res, err := http.DefaultClient.Do(req)
if err != nil {
panic(err)
}
defer res.Body.Close()
out, _ := io.ReadAll(res.Body)
fmt.Println(string(out))
}{
"success": true,
"data": {
"order_id": 74102,
"phone": "+905559876543",
"service": "wa",
"country": "62",
"status": "received",
"remaining": 82400,
"can_cancel": false,
"expires_at": "2026-10-25 14:00:00",
"sms_list": [
{
"code": "948210",
"text": "WhatsApp verification code: 948-210",
"date": "2026-10-24 14:12:00"
}
]
}
}Cancel Rental Order
Cancels the rental order within the 20-minute window if no SMS was received, with full refund.
Parameters
| Field | Type | Description | |
|---|---|---|---|
id |
integer | required | Rental order ID (URL) |
Response fields (data)
| Field | Type | Description |
|---|---|---|
order_id | integer | Order ID |
status | string | cancelled |
balance | number | Balance after refund |
curl -X POST "https://anindasms.com/api/v1/rent/orders/74102/cancel" \
-H "Authorization: Bearer YOUR_API_KEY"<?php
$ch = curl_init('https://anindasms.com/api/v1/rent/orders/74102/cancel');
curl_setopt_array($ch, [
CURLOPT_RETURNTRANSFER => true,
CURLOPT_POST => true,
CURLOPT_HTTPHEADER => [
'Authorization: Bearer YOUR_API_KEY',
],
]);
$response = json_decode(curl_exec($ch), true);
curl_close($ch);
print_r($response);import requests
response = requests.post(
"https://anindasms.com/api/v1/rent/orders/74102/cancel",
headers={"Authorization": "Bearer YOUR_API_KEY"},
)
print(response.json())const res = await fetch("https://anindasms.com/api/v1/rent/orders/74102/cancel", {
method: "POST",
headers: {
"Authorization": "Bearer YOUR_API_KEY",
},
});
console.log(await res.json());using var client = new HttpClient();
client.DefaultRequestHeaders.Add("Authorization", "Bearer YOUR_API_KEY");
var res = await client.PostAsync("https://anindasms.com/api/v1/rent/orders/74102/cancel", null);
Console.WriteLine(await res.Content.ReadAsStringAsync());package main
import (
"fmt"
"io"
"net/http"
)
func main() {
req, _ := http.NewRequest("POST", "https://anindasms.com/api/v1/rent/orders/74102/cancel", nil)
req.Header.Set("Authorization", "Bearer YOUR_API_KEY")
res, err := http.DefaultClient.Do(req)
if err != nil {
panic(err)
}
defer res.Body.Close()
out, _ := io.ReadAll(res.Body)
fmt.Println(string(out))
}{
"success": true,
"data": {
"order_id": 74102,
"status": "cancelled",
"balance": 375
}
}Reactivate / Extend Rental
Reactivates or extends the same phone number for an additional duration.
Body parameters (JSON)
| Field | Type | Description | |
|---|---|---|---|
id |
integer | required | Previous rental order ID (URL) |
duration |
integer | optional | Duration in hours (default: 24) |
Response fields (data)
| Field | Type | Description |
|---|---|---|
order_id | integer | New order ID |
phone | string | Same phone number |
duration | integer | Duration in hours |
cost | number | Charged amount (TRY) |
expires_at | datetime | New expiration datetime |
curl -X POST "https://anindasms.com/api/v1/rent/orders/74102/reactivate" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{"duration":24}'<?php
$ch = curl_init('https://anindasms.com/api/v1/rent/orders/74102/reactivate');
curl_setopt_array($ch, [
CURLOPT_RETURNTRANSFER => true,
CURLOPT_POST => true,
CURLOPT_HTTPHEADER => [
'Authorization: Bearer YOUR_API_KEY',
'Content-Type: application/json',
],
CURLOPT_POSTFIELDS => json_encode(['duration' => '24']),
]);
$response = json_decode(curl_exec($ch), true);
curl_close($ch);
print_r($response);import requests
response = requests.post(
"https://anindasms.com/api/v1/rent/orders/74102/reactivate",
headers={"Authorization": "Bearer YOUR_API_KEY"},
json={"duration": "24"},
)
print(response.json())const res = await fetch("https://anindasms.com/api/v1/rent/orders/74102/reactivate", {
method: "POST",
headers: {
"Authorization": "Bearer YOUR_API_KEY",
"Content-Type": "application/json",
},
body: JSON.stringify({ duration: "24" }),
});
console.log(await res.json());using var client = new HttpClient();
client.DefaultRequestHeaders.Add("Authorization", "Bearer YOUR_API_KEY");
var body = new StringContent("{\"duration\":24}", Encoding.UTF8, "application/json");
var res = await client.PostAsync("https://anindasms.com/api/v1/rent/orders/74102/reactivate", body);
Console.WriteLine(await res.Content.ReadAsStringAsync());package main
import (
"fmt"
"io"
"net/http"
"strings"
)
func main() {
body := strings.NewReader(`{"duration":24}`)
req, _ := http.NewRequest("POST", "https://anindasms.com/api/v1/rent/orders/74102/reactivate", body)
req.Header.Set("Authorization", "Bearer YOUR_API_KEY")
req.Header.Set("Content-Type", "application/json")
res, err := http.DefaultClient.Do(req)
if err != nil {
panic(err)
}
defer res.Body.Close()
out, _ := io.ReadAll(res.Body)
fmt.Println(string(out))
}{
"success": true,
"data": {
"order_id": 74215,
"phone": "+905559876543",
"duration": 24,
"cost": 125,
"balance": 250,
"status": "waiting",
"expires_at": "2026-10-26 14:00:00"
}
}Order statuses
The status field in the GET /order/{id} response takes one of the following values.
| status | Description |
|---|---|
waiting | Number purchased, waiting for the SMS. |
received | SMS received, the code is in the code field. |
done | Order completed. |
cancelled | Cancelled, the fee was refunded. |
expired | No SMS within 10 minutes, the fee was refunded automatically. |
waiting ──► received ──► done
│
├──► cancelled (cancel + refund)
└──► expired (10 min · auto refund)Error codes
Failed requests return an appropriate HTTP status code and a descriptive error message.
| HTTP | Description |
|---|---|
400 | Missing / invalid parameter or action not allowed in this state |
401 | API key missing or invalid |
402 | Insufficient balance |
403 | Account suspended, e-mail not verified, IP not allowed or service disabled |
404 | Order or service/country not found |
409 | Out of stock |
413 | Request body too large |
429 | Rate limit exceeded — wait for the Retry-After header |
500 / 502 | Temporary server or provider error — retry |
{
"success": false,
"error": "Bu ülke/servis için stok bulunmuyor."
}{
"success": false,
"error": "Rate limit aşıldı. Dakikada en fazla 30 istek."
}Official SDKs
Use our open-source SDKs to speed up your integration. They all share the same methods, turn errors into clear exceptions and include a waitForCode helper that waits for the SMS code for you.
Shared methods
me() · balance() | Account and balance |
services() · prices(service, country?) | Services, prices and stock |
createOrder(service, country, operator?) | Create a number order |
getOrder(id) | Order status + OTP |
cancelOrder(id) · completeOrder(id) | Cancel and refund · Mark order done |
waitForCode(id) | Waits until the code arrives and returns it |
# No SDK needed for cURL — use the request examples above.composer config repositories.anindasms vcs https://github.com/anindasms-dev/anindasms-sdk
composer require anindasms/sdk:dev-mainpip install "git+https://github.com/anindasms-dev/anindasms-sdk.git#subdirectory=python"npm install github:anindasms-dev/anindasms-sdk# Add csharp/AnindaSms.cs to your project (.NET 6+)go get github.com/anindasms-dev/anindasms-sdk/gocurl "https://anindasms.com/api/v1/balance" \
-H "Authorization: Bearer YOUR_API_KEY"<?php
require 'vendor/autoload.php';
$client = new AnindaSms\Client('YOUR_API_KEY');
$order = $client->createOrder('wa', '62');
echo $order['phone'];
$sms = $client->waitForCode($order['order_id']);
echo $sms['code'];from anindasms import Client
client = Client("YOUR_API_KEY")
order = client.create_order("wa", "62")
print(order["phone"])
sms = client.wait_for_code(order["order_id"])
print(sms["code"])const { AnindaSMS } = require("anindasms");
const client = new AnindaSMS("YOUR_API_KEY");
const order = await client.createOrder("wa", "62");
console.log(order.phone);
const sms = await client.waitForCode(order.order_id);
console.log(sms.code);using AnindaSms;
var client = new AnindaSmsClient("YOUR_API_KEY");
var order = await client.CreateOrderAsync("wa", "62");
Console.WriteLine(order.GetProperty("phone").GetString());
var sms = await client.WaitForCodeAsync(order.GetProperty("order_id").GetInt32());
Console.WriteLine(sms.GetProperty("code").GetString());package main
import (
"fmt"
anindasms "github.com/anindasms-dev/anindasms-sdk/go"
)
func main() {
client := anindasms.NewClient("YOUR_API_KEY")
order, err := client.CreateOrder("wa", "62", "")
if err != nil {
panic(err)
}
fmt.Println(order.Phone)
sms, err := client.WaitForCode(order.OrderID, 0, 0)
if err != nil {
panic(err)
}
fmt.Println(*sms.Code)
}API FAQ
Common integration questions.
Where do I get an API key?
After signing up, create a key on the Profile page. The full key is shown only once when generated.
Which languages are supported?
Any language works with REST JSON: PHP, Python, Node.js, Go, C#… Curl samples are in the docs.
What if SMS never arrives?
Same as the panel: refunds apply on expiry or successful cancel. Status returns expired / cancelled.
Is there a rate limit?
Yes: 120 requests/min overall, 30 orders/min. Over limit returns HTTP 429 with X-RateLimit headers. Poll status every 2–5s.
How is the key protected?
Keys are stored hashed and accepted only via headers. You can set an IP allowlist on Profile and rotate if leaked.
Sign up, create an API key, and get your first number in a few lines. Contact →