Panduan developer

Dokumentasi pengembang

SMS Activate menawarkan API otomatis penuh bagi pengguna yang perlu menyewa nomor telepon sementara dalam skala besar.

Create an API key in your dashboard and send it in the X-API-KEY header to https://api.smsactivate.uk. Order a number with POST /get_numbers using a service code and numeric country ID, then poll GET /status/{order_id} for the code. This API receives codes on a number you order. It does not send codes to your own users.

Mulai

Buat kunci API di dasbor Anda, lalu gunakan dalam permintaan dari sisi server.

Jangan pernah menaruh kunci API aktif di kode browser, tangkapan layar, atau repositori publik.

Buka kunci API

What does a first integration look like, end to end?

Start with GET /balance. A failed first call usually means the key or header is wrong.

Check what is live before you order: GET /services for service codes, GET /countries/{service} for country IDs, GET /offers/{service}/{country} for current offers. Availability changes; the catalog here is a reference, not a promise of stock. Browse all services.

POST /get_numbers with service and country. The response gives you an order id and a phone number; save the id.

Poll GET /status/{order_id} until the status reads received, then read sms_code.

What happens to an order after you place it?

An order moves through states, and what you can do depends on the state.

Active means the number is waiting for an SMS. While active you can ask for another SMS with POST /resend/{order_id} on a supported activation, or cancel an eligible one with POST /cancel/{order_id}. Cancel only works 2 to 20 minutes after purchase, and only before an SMS arrives.

Received means the code arrived. An expired order ran out its 20-minute window with no SMS and returns its stored status. An eligible activation that receives no SMS is refunded to your wallet. Read the FAQ.

Check the cancel response before you retry anything. If a purchase response is uncertain, do not order again until its status is clear. Contact support.

What mistakes cost first-time integrators the most?

Putting the key in browser code or a public repo. Keep it on a server you control.

Ordering before checking availability. GET /offers/{service}/{country} first saves a failed order.

Polling without a stop. GET /sms/{order_id} is rate-limited, so use GET /status/{order_id} and stop at a final state: received, cancelled, expired or refunded.

Retrying a purchase that came back uncertain. A 503 can mean the order went through and the answer got lost. Contact support.

Reusing an idempotency key for a different purchase. Use the same key only to check the outcome of the same purchase request.

Assuming the code will be accepted. Acceptance is the receiving service's decision, not ours.

Buying a one-time activation for an account that will ask for a code again - rentals are for that: 24 to 1,344 hours on the same number.

1. Autentikasi

Dapatkan kunci API Anda di pengaturan dasbor. Semua permintaan API harus menyertakan header:

X-API-KEY: your_api_key_here

2. URL dasar

Semua permintaan API menggunakan URL dasar ini:

https://api.smsactivate.uk

Contoh 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.
Nama / kode1,638 entri katalog
  • 163COMwp
  • 11688hn
  • 11and1ahs
  • 11xbetwj
  • 224bettinglh
  • 22dehandsapd
  • 22domainserc
  • 22ememainblx
  • 22ГИСbcg
  • 332Redqi
  • 3360Krediayo
  • 33Funauw
  • 44FunLitehk
  • 5500pxfpx
  • 551exchboc
  • 551exchangeexc
  • 77-Elevenaws
  • 8888casinoll
  • 9999 Mdbrv
  • 99acresfw
  • 99appki
  • 999Gameqkb
  • 999k Outletamq
  • AA23acv
  • AA9Agn
  • AAadharhra
  • Abastece-aíanb
  • AAbbottags
  • Ace2Threerh
  • AAcimacim
  • AAckoamf
  • AdaKamiko
  • AAdaModalbdo
  • AAdanibq
  • AAdidasan
  • AAditya Birlaqff
  • AAdmiralBetbst
  • AAdobebyh
  • Advertsagw
  • AAEG Presentsrsn
  • AAffirmbow
  • AAfreecaTVaip
  • AGIBANKsa
  • AAgodaag
  • AgriDevelopcs
  • AAgroinformqu
  • AAhlanbsm
  • AAiqfomebbi
  • AAir Milesbsy
  • AAirba Freshbnp
  • Airbnbuk
  • AAirtaskerbyd
  • Airtelzl
  • AAirtimeacy
  • AISwv
  • AAIS PLAYaxs
  • Aitujj
  • Akudorf
  • Akulakutm
  • Alchemyaav
  • Alfabt
  • Alfagiftbn
  • AAlfamidibgt
  • AAlFursanbxr
  • AAlgidalp
  • AAlibabaab
  • AliExpresshx
  • AAlignableaul
  • Alipay/Alibaba/1688hw
  • All Accessajy
  • Allegroyn
  • AlloBanknh
  • AAllofreshaeo
  • AAltyn-ial
  • AAmap 高德地图btx
  • AAmarthaFinbsv
  • Amasiayo
  • AAmaze Super Appbzk
  • Amazonam
  • AAme Digitalafi
  • AAmwayaee
  • AAngel Oneaha
  • Ankamaalg
  • AAnnoncelightbyw
  • Any Otherot
  • AOLpm
  • ApostaGanhaml
  • Applewx
  • Apteka Aprelaeh
  • AptekaRUgk
  • AAptekiPlusrq
  • AAR Lensaco
  • ArenaPlusabt
  • AArgentamo
  • AAri10blq
  • AASAASbqr
  • AAsdahs
  • AAsiaMilesajp
  • AAsianDatingayb
  • AAskablebpi
  • AAspirationaptn
  • Astra Otoshopafd
  • AstraPayaem
  • Astropaygr
  • AASVLAbuj
  • AAti Subhl
  • AAtlas Earthawq
  • AAtlasbusatb
  • AttaPollanl
  • AAUBANKdu
  • Auchanst
  • AAudibleaud
  • AAukroaox
  • AAuthentifyccy
  • AAuthor24kd
  • AAutodeskbbl
  • Autoruaej
  • AAv100proajl
  • AAvitoav
  • 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.
Negara / ID numerik206 entri katalog
  • 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/services

Respons

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/tg

Respons

{ "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/delivery

Respons

{
  "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/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/2

Respons

[
  {
    "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 "." and reject timestamps more than five minutes old. Test with POST /webhook/test.

Butuh batas lebih tinggi atau integrasi khusus? Hubungi tim kami. atau buka dasbor Anda.