1. Autentikasi
Dapatkan kunci API Anda di pengaturan dasbor. Semua permintaan API harus menyertakan header:
X-API-KEY: your_api_key_here2. URL dasar
Semua permintaan API menggunakan URL dasar ini:
https://api.smsactivate.ukContoh permintaan
Permintaan ini membuat pesanan dan dapat menagih dompet Anda. Ganti layanan dan negara contoh dengan pilihan yang tersedia di akun Anda.
curl -X POST https://api.smsactivate.uk/get_numbers -H "X-API-KEY: YOUR_API_KEY" -H "Content-Type: application/json" -d '{"service":"tg","country":2}'Referensi API
Setiap operasi mencantumkan inputnya, contoh permintaan, respons representatif, dan error utama. Integrasi API yang sudah ada dapat terus memakai endpoint sebelumnya; endpoint berbasis produk di bawah direkomendasikan untuk integrasi baru. Contoh memakai ID dan nilai placeholder. Kirim permintaan terautentikasi dari server Anda dengan header kunci API.
Mulai di sini
GET/balanceBaca saldo dompet Anda saat ini.
Kunci API diperlukan.
Parameter
- Tidak ada
- Tidak ada parameter query.
Contoh permintaan
curl https://api.smsactivate.uk/balance -H "X-API-KEY: YOUR_API_KEY"Respons
{ "balance": "10.0000" }Errors
Endpoint ini mengembalikan saldo akun terautentikasi saat ini.
Mendapatkan dan mengelola nomor
POST/get_numbersBuat pesanan aktivasi.
Kunci API diperlukan.
Parameter
- service
- String wajib. Kode layanan, misalnya tg.
- country
- Integer wajib. ID negara numerik.
- operator
- String opsional. Default-nya any.
- max_price
- Angka opsional. Harga maksimum; maxPrice juga diterima.
- min_price
- Angka opsional; minPrice juga diterima.
- any_price
- Boolean opsional; anyPrice juga diterima.
- product
- Opsional: standard (default) atau api_links. API Links adalah pembelian inventaris penjualan final.
- idempotency_key
- UUID opsional untuk aktivasi standar. Gunakan kembali kunci yang sama hanya untuk permintaan pembelian yang sama saat hasilnya sedang diperiksa.
- quantity
- Integer opsional dari 1 sampai 100 untuk pesanan inventaris API Links; default 1. Pesanan aktivasi standar hanya satu nomor.
Contoh permintaan
curl -X POST https://api.smsactivate.uk/get_numbers \
-H "X-API-KEY: YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{"service":"tg","country":2}'Respons
{
"id": "ORDER_ID",
"phone": "10000000000",
"price": "0.2500",
"balance_remaining": "9.7500"
}Errors
HTTP 400: pilihan tidak tersedia, batas harga, atau saldo tidak cukup. HTTP 409: pesanan sebelumnya masih diperiksa. HTTP 503: kegagalan sementara atau pesanan tidak pasti; jika respons menyatakan rekonsiliasi diperlukan, jangan coba lagi dan hubungi dukungan.
GET/sms/{order_id}Minta pengecekan status baru untuk pesanan aktif.
Kunci API diperlukan. Endpoint ini memiliki batas permintaan.
Parameter
- order_id
- Nilai path wajib yang dikembalikan saat pesanan dibuat.
Contoh permintaan
curl https://api.smsactivate.uk/sms/ORDER_ID -H "X-API-KEY: YOUR_API_KEY"Respons
{
"status": "received",
"sms_code": "123456",
"raw_sms": "Your verification code is 123456"
}Errors
HTTP 400: pengecekan SMS tidak tersedia untuk pesanan ini. HTTP 404: pesanan tidak ditemukan. HTTP 502: kegagalan pengecekan sementara. Pesanan kedaluwarsa mengembalikan status tersimpan tanpa pengecekan eksternal baru.
GET/status/{order_id}Baca status pesanan dan SMS yang diterima.
Kunci API diperlukan.
Parameter
- order_id
- Nilai path wajib yang dikembalikan saat pesanan dibuat.
Contoh permintaan
curl https://api.smsactivate.uk/status/ORDER_ID -H "X-API-KEY: YOUR_API_KEY"Respons
{
"status": "received",
"sms_code": "123456",
"raw_sms": "Your verification code is 123456"
}Errors
Respons dibatasi pada pesanan akun terautentikasi. Jika pencarian status gagal, API mengembalikan error; periksa ID pesanan dan coba lagi nanti jika layanan sementara tidak tersedia.
POST/resend/{order_id}Minta SMS lain untuk aktivasi aktif yang didukung.
Kunci API diperlukan.
Parameter
- order_id
- Nilai path wajib. Tanpa body permintaan.
Contoh permintaan
curl -X POST https://api.smsactivate.uk/resend/ORDER_ID -H "X-API-KEY: YOUR_API_KEY"Respons
{ "message": "Resend request successful. Waiting for new SMS." }Errors
HTTP 400: kirim ulang tidak diterima atau pesanan kedaluwarsa. HTTP 409: kirim ulang tidak tersedia untuk pesanan ini. HTTP 500: kirim ulang tidak dapat diselesaikan.
POST/cancel/{order_id}Ajukan pembatalan aktivasi yang memenuhi syarat.
Kunci API diperlukan.
Parameter
- order_id
- Nilai path wajib. Tanpa body permintaan.
Contoh permintaan
curl -X POST https://api.smsactivate.uk/cancel/ORDER_ID -H "X-API-KEY: YOUR_API_KEY"Respons
{
"message": "Number cancelled and balance refunded",
"refunded_amount": "0.2500",
"new_balance": "10.0000"
}Errors
Pembatalan hanya tersedia untuk aktivasi aktif yang memenuhi syarat, 2 sampai 20 menit setelah pembelian, dan sebelum SMS tiba. Sewa menggunakan /rent/cancel/{order_id}; API Links adalah penjualan final. Pembatalan yang tidak memenuhi syarat atau belum dikonfirmasi mengembalikan error. Baca respons pembatalan sebelum mencoba lagi.
GET/reactivate/{order_id}/optionsCek harga dan detail reaktivasi saat ini.
Kunci API diperlukan.
Parameter
- order_id
- Nilai path wajib untuk pesanan asli.
Contoh permintaan
curl https://api.smsactivate.uk/reactivate/ORDER_ID/options -H "X-API-KEY: YOUR_API_KEY"Respons
{
"price": 0.25,
"duration": 20,
"phone": "10000000000",
"service": "tg",
"country": 2
}Errors
HTTP 400: reaktivasi tidak didukung atau tidak tersedia. HTTP 409: reaktivasi tidak tersedia untuk pesanan ini. HTTP 503: harga terkini yang valid tidak dapat dikonfirmasi.
POST/reactivate/{order_id}Reaktivasi aktivasi yang memenuhi syarat dengan harga saat ini.
Kunci API diperlukan.
Parameter
- order_id
- Nilai path wajib untuk pesanan asli. Tanpa body permintaan.
Contoh permintaan
curl -X POST https://api.smsactivate.uk/reactivate/ORDER_ID -H "X-API-KEY: YOUR_API_KEY"Respons
{
"message": "Number reactivated successfully.",
"id": "NEW_ORDER_ID",
"phone": "10000000000",
"price": 0.25,
"balance_remaining": 9.75
}Errors
HTTP 400: reaktivasi tidak didukung atau saldo dompet tidak cukup. HTTP 409: tidak tersedia untuk pesanan ini. HTTP 503: hasil tidak dapat dikonfirmasi; hubungi dukungan sebelum mencoba lagi.
GET/orders/{order_id}Baca detail salah satu pesanan Anda.
Kunci API diperlukan.
Parameter
- order_id
- Nilai path wajib yang dikembalikan saat pesanan dibuat.
Contoh permintaan
curl https://api.smsactivate.uk/orders/ORDER_ID -H "X-API-KEY: YOUR_API_KEY"Respons
Returns the order record with buyer-facing fields, including its status and remaining time where applicable. Internal routing IDs and cost fields are not returned.Errors
HTTP 404: pesanan tidak ditemukan atau bukan milik akun Anda.
Memilih layanan, negara, dan harga
LayananCari katalog layanan berdasarkan nama atau kode. Ketersediaan dapat berubah; cek endpoint langsung sebelum memesan.
163COMwp- 11688
hn - 11and1
ahs - 11xbet
wj - 224betting
lh - 22dehands
apd - 22domains
erc - 22ememain
blx - 22ГИС
bcg - 332Red
qi - 3360Kredi
ayo - 33Fun
auw - 44FunLite
hk - 5500px
fpx - 551exch
boc - 551exchange
exc - 77-Eleven
aws - 8888casino
ll - 9999 Md
brv
99acresfw
99appki- 999Game
qkb - 999k Outlet
amq - AA23
acv - AA9A
gn - AAadhar
hra
Abastece-aíanb- AAbbott
ags
Ace2Threerh- AAcima
cim - AAcko
amf
AdaKamiko- AAdaModal
bdo - AAdani
bq - AAdidas
an - AAditya Birla
qff - AAdmiralBet
bst - AAdobe
byh
Advertsagw- AAEG Presents
rsn - AAffirm
bow - AAfreecaTV
aip
AGIBANKsa- AAgoda
ag
AgriDevelopcs- AAgroinform
qu - AAhlan
bsm - AAiqfome
bbi - AAir Miles
bsy - AAirba Fresh
bnp
Airbnbuk- AAirtasker
byd
Airtelzl- AAirtime
acy
AISwv- AAIS PLAY
axs
Aitujj
Akudorf
Akulakutm
Alchemyaav
Alfabt
Alfagiftbn- AAlfamidi
bgt - AAlFursan
bxr - AAlgida
lp - AAlibaba
ab
AliExpresshx- AAlignable
aul
Alipay/Alibaba/1688hw
All Accessajy
Allegroyn
AlloBanknh- AAllofresh
aeo - AAltyn-i
al - AAmap 高德地图
btx - AAmarthaFin
bsv
Amasiayo- AAmaze Super App
bzk
Amazonam- AAme Digital
afi - AAmway
aee - AAngel One
aha
Ankamaalg- AAnnoncelight
byw
Any Otherot
AOLpm
ApostaGanhaml
Applewx
Apteka Aprelaeh
AptekaRUgk- AAptekiPlus
rq - AAR Lens
aco
ArenaPlusabt- AArgent
amo - AAri10
blq - AASAAS
bqr - AAsda
hs - AAsiaMiles
ajp - AAsianDating
ayb - AAskable
bpi - AAspiration
aptn
Astra Otoshopafd
AstraPayaem
Astropaygr- AASVLA
buj - AAti Su
bhl - AAtlas Earth
awq - AAtlasbus
atb
AttaPollanl- AAUBANK
du
Auchanst- AAudible
aud - AAukro
aox - AAuthentify
ccy - AAuthor24
kd - AAutodesk
bbl
Autoruaej- AAv100pro
ajl - AAvito
av
AVONff
Ketersediaan langsung dan contoh respons:
GET https://api.smsactivate.uk/services{
"services": ["tg", "wa", "go"],
"providers": { "source-counts": "per active catalog" },
"generated_at": "ISO 8601 timestamp"
}Katalog menyediakan nama dan kode untuk pencarian. Ketersediaan bersifat langsung dan dapat berbeda dari daftar ini; JSON ini menunjukkan bentuk respons, bukan inventaris saat ini.
NegaraID negara numerik dari katalog dasbor. Tidak ada endpoint API daftar negara umum untuk aktivasi standar.
Afghanistan74
Albania155
Algeria58
Angola76
Anguilla181
Antigua and Barbuda169
Argentina39
Armenia148
Aruba179
Australia175
Austria50
Azerbaijan35
Bahamas122
Bahrain145
Bangladesh60
Barbados118
Belarus51
Belgium82
Belize124
Benin120
Bermuda195
Bhutan158
Bolivia92
Bosnia108
Botswana123
Brazil73
Brunei121
Bulgaria83
Burkina Faso152
Burundi119
Cambodia24
Cameroon41
Canada36
Cape Verde186
Cayman Islands170
Central African Republic125
Chad42
Chile151
China3
Colombia33
Comoros133
Congo150
Costa Rica93
Croatia45
Cuba113
Cyprus77
Czech63
Denmark172
Djibouti168
Dominica126
Dominican Republic109
DR Congo18
Ecuador105
Egypt21
Equatorial Guinea167
Eritrea176
Estonia34
Ethiopia71
Faroe Islands202
Fiji189
Finland163
France78
French Guiana162
Gabon154
Gambia28
Georgia128
Germany43
Ghana38
Gibraltar201
Greece129
Grenada127
Guadeloupe160
Guatemala94
Guinea68
Guinea-Bissau130
Guyana131
Haiti26
Honduras88
Hong Kong14
Hungary84
Iceland132
India22
Indonesia6
Iran57
Iraq47
Ireland23
Israel13
Italy86
Ivory Coast27
Jamaica103
Japan182
Jersey194
Jordan116
Kazakhstan2
Kenya8
Kosovo203
Kuwait100
Kyrgyzstan11
Laos25
Latvia49
Lebanon153
Lesotho136
Liberia135
Libya102
Liechtenstein200
Lithuania44
Luxembourg165
Macao20
Madagascar17
Malawi137
Malaysia7
Maldives159
Mali69
Malta199
Mauritania114
Mauritius157
Mexico54
Moldova85
Monaco144
Mongolia72
Bentuk respons penawaran untuk satu layanan dan negara:
[
{ "name": "any", "offers": [{ "price": 0.25, "count": 4 }] }
]ID katalog mengidentifikasi pilihan negara, bukan jaminan penawaran langsung. Cek /offers/{service}/{country} untuk ketersediaan.
GET/servicesCek ketersediaan layanan saat ini.
Publik - tidak perlu kunci API.
Parameter
- Tidak ada
- Endpoint ini tidak menerima parameter query.
Contoh permintaan
curl https://api.smsactivate.uk/servicesRespons
Returns the current services array and generated_at timestamp. See the searchable Services catalog below for code/name lookup; it is a maintained reference, not a live availability guarantee.Errors
Ketersediaan dapat berubah. Cek endpoint langsung dan /offers/{service}/{country} sebelum memesan.
GET/countries/{service}Daftar ID negara yang saat ini memiliki nomor untuk suatu layanan.
Publik - tidak perlu kunci API.
Parameter
- service
- Kode layanan wajib, seperti tg.
Contoh permintaan
curl https://api.smsactivate.uk/countries/tgRespons
{ "countries": [2, 6, 187] }Errors
ID negara sesuai dengan katalog Negara di bawah. Ketersediaan berubah; cek /offers/{service}/{country} sebelum memesan. Endpoint ini memiliki batas permintaan.
GET/offers/{service}/{country}/deliveryLihat tingkat pengiriman kode terbaru untuk setiap tingkat harga.
Publik - tidak perlu kunci API.
Parameter
- service
- Kode layanan wajib, seperti tg.
- country
- ID negara numerik wajib.
Contoh permintaan
curl https://api.smsactivate.uk/offers/tg/2/deliveryRespons
{
"window_days": 30,
"tiers": { "0.2500": { "orders": 120, "codes": 108, "delivery_pct": 90, "best": true } }
}Errors
HTTP 400: layanan atau negara tidak valid. Tingkat tanpa kode terkirim tidak dicantumkan. Hasil di-cache sekitar 5 menit dan mencakup window_days hari terakhir. Endpoint ini memiliki batas permintaan.
GET/operators?service={service}&country={country}Daftar operator yang tersedia untuk layanan dan negara.
Publik - tidak perlu kunci API.
Parameter
- service
- Kode layanan wajib, seperti tg.
- country
- ID negara numerik wajib.
Contoh permintaan
curl 'https://api.smsactivate.uk/operators?service=tg&country=2'Respons
[
{ "name": "any", "localName": "Any Operator" },
{ "name": "example", "localName": "Example operator" }
]Errors
Daftar bergantung pada negara yang dipilih dan ketersediaan saat ini. service dan country sama-sama wajib; nilai yang hilang atau tidak valid mengembalikan HTTP 422.
GET/links/optionsDaftar layanan dan pilihan negara di katalog API Links.
Publik - tidak perlu kunci API.
Parameter
- Tidak ada
- Endpoint ini tidak menerima parameter query.
Contoh permintaan
curl https://api.smsactivate.uk/links/optionsRespons
{
"services": [{
"id": "sample_service",
"name": "Sample service",
"countries": [{ "id": 2, "name": "United States", "price": 0.25, "stock": 4 }]
}],
"countries": [{ "id": 2, "name": "United States" }]
}Errors
Daftar ini hanya untuk API Links. Ini bukan daftar negara umum untuk pesanan aktivasi standar.
GET/links/offers/{service}/{country}Cek harga dan stok inventaris API Links saat ini.
Publik - tidak perlu kunci API.
Parameter
- service
- Kode layanan dari katalog opsi API Links.
- country
- ID negara numerik dari daftar negara API Links untuk layanan yang dipilih.
Contoh permintaan
curl https://api.smsactivate.uk/links/offers/tg/1Respons
[{ "name": "any", "offers": [{ "price": "0.2500", "count": 4 }] }]Errors
Pilihan yang tidak tersedia mengembalikan daftar kosong. Untuk membeli produk ini, kirim product=api_links ke /get_numbers. API Links adalah penjualan final; quantity default-nya 1 dan harus antara 1 dan 100.
GET/offers/{service}/{country}Cek penawaran untuk satu kombinasi layanan dan negara.
Publik - tidak perlu kunci API.
Parameter
- service
- Nilai path wajib. Gunakan kode layanan yang dikembalikan oleh /services, seperti tg.
- country
- Nilai path wajib. ID negara numerik; gunakan katalog negara di dasbor untuk aktivasi standar. Tidak ada endpoint API umum yang mencantumkan ID negara ini.
Contoh permintaan
curl https://api.smsactivate.uk/offers/tg/2Respons
[
{
"name": "any",
"offers": [{ "price": "0.2500", "count": 4 }]
}
]Errors
Pasangan yang tidak didukung atau tidak tersedia dapat mengembalikan daftar kosong. Data penawaran di-cache; cache miss dapat lebih lama saat ketersediaan diperiksa.
Meninjau aktivitas sebelumnya
GET/ordersTelusuri riwayat pesanan Anda, dari yang terbaru.
Kunci API diperlukan.
Parameter
- page
- Nomor halaman opsional; default 1.
- per_page
- Ukuran halaman opsional; default 20 dan dibatasi maksimal 100.
- status
- Opsional: active, completed (atau received), cancelled, expired, refunded. Kosongkan atau gunakan all untuk menyertakan semua status.
- search
- Pencarian nomor telepon opsional.
- category
- Opsional: rents, links, atau numbers.
Contoh permintaan
curl 'https://api.smsactivate.uk/orders?page=2&per_page=100&status=received&category=numbers' -H "X-API-KEY: YOUR_API_KEY"Respons
{
"current_page": 2,
"data": [{ "id": "ORDER_ID", "status": "received", "phone": "10000000000" }],
"first_page_url": "…?page=1",
"last_page": 4,
"last_page_url": "…?page=4",
"next_page_url": "…?page=3",
"per_page": 100,
"prev_page_url": "…?page=1",
"total": 350
}Errors
Ikuti next_page_url sampai bernilai null. page default 1; per_page default 20 dan nilainya dibatasi 1–100. status menerima active, completed/received, cancelled, expired, atau refunded; all atau nilai yang tidak dikenal membiarkan status tanpa filter. search mencocokkan nomor telepon. category menerima rents, links, atau numbers; kategori yang tidak dikenal diabaikan. Riwayat besar membutuhkan beberapa permintaan halaman.
Sewa
GET/rent/servicesCek layanan sewa untuk suatu negara dan durasi.
Kunci API diperlukan.
Parameter
- country
- ID negara integer opsional; default 2.
- duration
- Jam opsional; default 24. Rentang yang diizinkan: 24–1.344 jam.
Contoh permintaan
curl 'https://api.smsactivate.uk/rent/services?country=2&duration=24' -H "X-API-KEY: YOUR_API_KEY"Respons
Returns rental availability, with service codes and current prices for the selected country and duration.Errors
HTTP 400: tidak ada nomor sewa tersedia untuk pilihan ini. HTTP 422: negara atau durasi tidak valid. HTTP 503: katalog sewa sementara tidak tersedia.
POST/rent/orderBuat pesanan sewa.
Kunci API diperlukan.
Parameter
- service
- Kode layanan wajib (string).
- country
- ID negara wajib (integer).
- duration
- Jam wajib, 24–1.344.
- operator
- String opsional; default any.
Contoh permintaan
curl -X POST https://api.smsactivate.uk/rent/order \
-H "X-API-KEY: YOUR_API_KEY" -H "Content-Type: application/json" \
-d '{"service":"tg","country":2,"duration":24}'Respons
{
"message": "Number rented successfully.",
"id": "ORDER_ID",
"phone": "10000000000",
"price": 2.50,
"balance_remaining": 7.50
}Errors
HTTP 400: permintaan tidak valid atau saldo tidak cukup. HTTP 409: tidak ada sewa tersedia. HTTP 503: hasil menunggu peninjauan; jangan coba lagi sampai dukungan memeriksa pesanan.
POST/rent/cancel/{order_id}Ajukan pembatalan sewa yang memenuhi syarat.
Kunci API diperlukan.
Parameter
- order_id
- Nilai path wajib. Tanpa body permintaan.
Contoh permintaan
curl -X POST https://api.smsactivate.uk/rent/cancel/ORDER_ID -H "X-API-KEY: YOUR_API_KEY"Respons
Returns the cancellation result. Refunds may remain pending verification after cancellation is accepted.Errors
Pembatalan terbatas pada sewa aktif yang memenuhi syarat, 2 sampai 20 menit setelah pembelian, sebelum SMS tiba. HTTP 404: sewa tidak ditemukan. HTTP 409: sewa tidak memenuhi syarat. Jika diterima, pengembalian dananya dapat tertunda menunggu verifikasi.
GET/rent/extend/{order_id}/optionsCek opsi perpanjangan yang tersedia untuk sewa.
Kunci API diperlukan.
Parameter
- order_id
- Nilai path wajib untuk sewa.
Contoh permintaan
curl https://api.smsactivate.uk/rent/extend/ORDER_ID/options -H "X-API-KEY: YOUR_API_KEY"Respons
{
"options": [{ "duration": 24, "price": 2.50 }],
"expires_at": "2026-10-06T12:00:00Z"
}Errors
HTTP 404: sewa tidak ditemukan. HTTP 409: sewa tidak memenuhi syarat (perpanjangan dibuka setelah 20 menit pertama, sewa harus active atau received, atau perpanjangan sebelumnya menunggu peninjauan). HTTP 503: perpanjangan sementara tidak tersedia atau opsi tidak dapat dimuat; coba lagi nanti. Endpoint ini memiliki batas permintaan.
POST/rent/extend/{order_id}Perpanjang sewa yang aktif.
Kunci API diperlukan.
Parameter
- order_id
- Nilai path wajib untuk sewa.
- duration
- Wajib: 24, 72, 168, 336, 720, 1.440, 2.160, atau 4.320 jam. Pilih dari respons opsi saat ini.
- expected_price
- Angka wajib yang disalin dari respons opsi saat ini.
- Idempotency-Key
- Header permintaan UUID v4 wajib. Gunakan kembali hanya untuk mengulang percobaan perpanjangan yang sama dengan aman.
Contoh permintaan
curl -X POST https://api.smsactivate.uk/rent/extend/ORDER_ID \
-H "X-API-KEY: YOUR_API_KEY" -H "Content-Type: application/json" \
-H "Idempotency-Key: 3f6c1a52-8b1e-4c47-9d0a-6a1f2c9e7b10" \
-d '{"duration":24,"expected_price":2.50}'Respons
{
"message": "Rental extended successfully.",
"attempt_id": "REQUEST_UUID",
"status": "settled",
"charged": 2.50,
"new_expires_at": "2026-10-10T12:00:00Z",
"balance_remaining": 7.50
}Errors
HTTP 422: duration, expected_price, atau Idempotency-Key hilang/tidak valid. HTTP 409: sewa tidak memenuhi syarat, durasi atau harga tidak lagi ditawarkan, atau Idempotency-Key sudah digunakan. HTTP 202: perpanjangan menunggu peninjauan; jangan coba lagi dengan kunci idempotensi baru. HTTP 503: perpanjangan tidak dapat dikonfirmasi; hubungi dukungan.
Verifikasi email
GET/emails/catalog?site={site}Daftar domain alamat verifikasi yang tersedia untuk suatu situs.
Kunci API diperlukan.
Parameter
- site
- Domain situs web wajib, misalnya example.com.
Contoh permintaan
curl 'https://api.smsactivate.uk/emails/catalog?site=example.com' -H "X-API-KEY: YOUR_API_KEY"Respons
[{ "name": "sample-domain.test", "price": 0.10, "stock": 5 }]Errors
HTTP 422: nilai site tidak valid. HTTP 503: katalog email sementara tidak tersedia.
POST/emails/buyBeli satu alamat verifikasi.
Kunci API diperlukan.
Parameter
- site
- Domain situs web wajib.
- domain
- Domain wajib yang dipilih dari respons katalog saat ini.
Contoh permintaan
curl -X POST https://api.smsactivate.uk/emails/buy \
-H "X-API-KEY: YOUR_API_KEY" -H "Content-Type: application/json" \
-d '{"site":"example.com","domain":"sample-domain.test"}'Respons
Returns an order object and balance_remaining when the purchase is confirmed.Errors
HTTP 400: saldo dompet tidak cukup. HTTP 409: domain kehabisan stok. HTTP 503: pembelian menunggu peninjauan; jangan coba lagi sampai dukungan memeriksa pesanan.
POST/emails/{order_id}/reorderPesan alamat yang sama lagi setelah pesanan sebelumnya selesai.
Kunci API diperlukan.
Parameter
- order_id
- Nilai path wajib untuk pesanan email yang sudah selesai (numerik). Tanpa body permintaan.
Contoh permintaan
curl -X POST https://api.smsactivate.uk/emails/ORDER_ID/reorder -H "X-API-KEY: YOUR_API_KEY"Respons
Returns the new email order, same shape as the email order response. The price is quoted at order time and charged from your balance.Errors
HTTP 404: pesanan tidak ditemukan. HTTP 409: pesanan sebelumnya belum selesai, pemesanan ulang sedang berlangsung, atau alamat ini tidak dapat dipesan ulang sekarang. HTTP 503: verifikasi email sementara tidak tersedia. Endpoint ini memiliki batas permintaan.
GET/emails/historyDaftar pesanan verifikasi email Anda.
Kunci API diperlukan.
Parameter
- page
- Nomor halaman opsional; default 1.
- per_page
- Ukuran halaman opsional; default 20 dan dibatasi maksimal 50.
Contoh permintaan
curl 'https://api.smsactivate.uk/emails/history?page=1&per_page=20' -H "X-API-KEY: YOUR_API_KEY"Respons
Returns paginated order data and page metadata.Errors
Jika tabel pesanan email tidak tersedia, API mengembalikan array data kosong.
GET/emails/status/{order_id}Baca atau segarkan pesanan verifikasi.
Kunci API diperlukan.
Parameter
- order_id
- Nilai path wajib yang dikembalikan oleh respons pembelian.
Contoh permintaan
curl https://api.smsactivate.uk/emails/status/ORDER_ID -H "X-API-KEY: YOUR_API_KEY"Respons
Returns the order status and available verification result fields.Errors
HTTP 404: pesanan tidak ditemukan. HTTP 503: status tidak dapat disegarkan. Respons hanya menyertakan kolom yang tersedia untuk pesanan.
DELETE/emails/{order_id}Ajukan pembatalan pesanan verifikasi email.
Kunci API diperlukan.
Parameter
- order_id
- Nilai path wajib yang dikembalikan oleh respons pembelian.
Contoh permintaan
curl -X DELETE https://api.smsactivate.uk/emails/ORDER_ID -H "X-API-KEY: YOUR_API_KEY"Respons
Returns the cancellation result. The refund can remain pending verification.Errors
Pesanan harus milik akun Anda dan memenuhi syarat untuk dibatalkan; lihat pesan error yang dikembalikan untuk status pesanan saat ini. Jika respons menyatakan pembatalan belum dikonfirmasi (HTTP 503), tunggu beberapa menit lalu kirim permintaan lagi.
Webhook
GET/webhookBaca konfigurasi webhook Anda.
Kunci API diperlukan.
Parameter
- Tidak ada
- Tidak ada parameter query.
Contoh permintaan
curl https://api.smsactivate.uk/webhook -H "X-API-KEY: YOUR_API_KEY"Respons
Returns the saved endpoint configuration. The signing secret is not returned by this read request.Errors
Mengembalikan konfigurasi saat ini untuk akun terautentikasi.
PUT/webhookBuat atau perbarui URL webhook Anda.
Kunci API diperlukan.
Parameter
- url
- URL HTTPS publik wajib pada port 443. Alamat lokal dan privat ditolak.
Contoh permintaan
curl -X PUT https://api.smsactivate.uk/webhook \
-H "X-API-KEY: YOUR_API_KEY" -H "Content-Type: application/json" \
-d '{"url":"https://example.com/hooks/sms"}'Respons
Returns the saved configuration. On first setup the signing secret is returned once; store it safely.Errors
HTTP 422: URL bukan alamat HTTPS publik yang diterima.
POST/webhook/rotate-secretGanti secret penandatanganan untuk webhook yang telah dikonfigurasi.
Kunci API diperlukan.
Parameter
- Tidak ada
- Tanpa body permintaan. Konfigurasikan webhook terlebih dahulu.
Contoh permintaan
curl -X POST https://api.smsactivate.uk/webhook/rotate-secret -H "X-API-KEY: YOUR_API_KEY"Respons
{ "secret": "NEW_SECRET_SHOWN_ONCE" }Errors
HTTP 404: tidak ada webhook yang dikonfigurasi. Simpan secret baru dengan aman; secret dikembalikan oleh respons rotasi ini, bukan oleh endpoint baca.
DELETE/webhookHapus konfigurasi webhook Anda.
Kunci API diperlukan.
Parameter
- Tidak ada
- Tanpa body permintaan.
Contoh permintaan
curl -X DELETE https://api.smsactivate.uk/webhook -H "X-API-KEY: YOUR_API_KEY"Respons
{ "configured": false }Errors
Menghapus konfigurasi webhook untuk akun terautentikasi.
POST/webhook/testKirim event uji ke endpoint yang telah dikonfigurasi.
Kunci API diperlukan.
Parameter
- Tidak ada
- Tanpa body permintaan. Konfigurasikan webhook terlebih dahulu.
Contoh permintaan
curl -X POST https://api.smsactivate.uk/webhook/test -H "X-API-KEY: YOUR_API_KEY"Respons
{
"delivered": true,
"http_status": 200,
"message": "Your server accepted the test message."
}Errors
HTTP 404: tidak ada webhook yang dikonfigurasi. Pengiriman uji melaporkan delivered=false saat server Anda tidak menerimanya.
GET/webhook/deliveriesTinjau hingga 50 percobaan pengiriman webhook terbaru.
Kunci API diperlukan.
Parameter
- Tidak ada
- Tidak ada parameter query.
Contoh permintaan
curl https://api.smsactivate.uk/webhook/deliveries -H "X-API-KEY: YOUR_API_KEY"Respons
{
"data": [{ "id": 42, "event_id": "EVENT_ID", "event_type": "sms.received", "status": "success", "attempts": 1, "http_status": 200 }]
}Errors
Mengembalikan 50 pengiriman webhook HTTP terbaru, dari yang terbaru.
POST/webhook/deliveries/{id}/retryCoba ulang salah satu pengiriman webhook Anda sekarang.
Kunci API diperlukan.
Parameter
- id
- Nilai path wajib untuk catatan pengiriman.
Contoh permintaan
curl -X POST https://api.smsactivate.uk/webhook/deliveries/42/retry -H "X-API-KEY: YOUR_API_KEY"Respons
{ "status": "success", "http_status": 200 }Errors
HTTP 404: pengiriman tidak ditemukan. Endpoint ini memiliki batas permintaan.
4. Penagihan
Saldo Anda dipotong saat Anda membuat pesanan. Aktivasi yang tidak menerima SMS dalam jendela 20 menit dikembalikan dananya ke saldo Anda. Aturan pembatalan dan pengembalian dana berbeda untuk sewa, email, dan API Links.
5. Pembatalan dan Pengembalian Dana
Untuk pesanan nomor (aktivasi), Anda dapat mengajukan pembatalan setelah 2 menit pertama dan sebelum jendela aktivasi 20 menit berakhir, hanya selama belum ada SMS yang masuk. Pembatalan yang memenuhi syarat dan terkonfirmasi mengembalikan biaya pesanan ke saldo Anda.
Aktivasi tidak dapat dibatalkan setelah SMS masuk atau setelah jendela aktivasinya berakhir. Jika aktivasi yang memenuhi syarat tidak menerima SMS selama jendela 20 menit, biaya pesanan dikembalikan ke saldo Anda.
Sewa dapat dibatalkan dalam jendela 2 hingga 20 menit yang sama selama belum ada kode yang masuk. Pengembalian dana sewa menunggu verifikasi dan tidak otomatis.
Nomor massal, API Links, dan pesanan email tidak dapat dikembalikan dananya setelah dikirim, kecuali dasbor menyatakan lain.
Jika pembatalan tidak dapat dikonfirmasi, hubungi dukungan sebelum mencoba lagi.
Frequently asked questions
How do I authenticate with the API?
Create or rotate a key in your dashboard. Send it in the X-API-KEY header with every request. The key is shown once when you create or rotate it. Keep it server-side. Open your dashboard.
What do I need for my first order?
A service code and a numeric country ID. Find them with GET /services and GET /countries/{service}, then check GET /offers/{service}/{country}. Prices are shown live in the dashboard. See live prices.
How do I read the code that arrives?
Poll GET /status/{order_id} and read sms_code when the status is received. GET /sms/{order_id} is rate-limited; do not use it for routine polling.
What if no SMS arrives?
An eligible activation with no SMS in its 20-minute window is refunded. You can also cancel an eligible active activation 2 to 20 minutes after purchase, before an SMS arrives. If a purchase response is uncertain, do not retry it; contact support. Read the FAQ.
Can I cancel an order?
For eligible active activations: POST /cancel/{order_id}, 2 to 20 minutes after purchase, before an SMS arrives. Rentals use POST /rent/cancel/{order_id}. API Links are final sale.
Does this API send verification codes to my users?
No. It receives codes on a number you order. If you need to send codes to your own users, this API is not the tool for that job.
How do webhooks work?
Set a public HTTPS URL on port 443 with PUT /webhook; the signing secret is returned once. Verify the signature as sha256= HMAC-SHA256 of "
Butuh batas lebih tinggi atau integrasi khusus? Hubungi tim kami. atau buka dasbor Anda.
