1. 인증
계정 대시보드의 설정에서 API 키를 발급받으세요. 모든 API 요청에는 다음 헤더가 포함되어야 합니다:
X-API-KEY: your_api_key_here2. 기본 URL
모든 API 요청은 이 기본 URL을 사용합니다:
https://api.smsactivate.uk요청 예시
이 요청은 주문을 생성하며 지갑에서 요금이 청구될 수 있습니다. 예시 서비스와 국가를 내 계정에서 사용 가능한 선택으로 바꾸세요.
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}'API 레퍼런스
각 작업에는 입력값, 요청 예시, 대표 응답, 주요 오류가 나와 있습니다. 기존 API 연동은 이전 엔드포인트를 계속 사용할 수 있으며, 신규 연동에는 아래의 상품 기반 엔드포인트를 권장합니다. 예시에는 임의의 ID와 값이 사용됩니다. 인증된 요청은 서버에서 API 키 헤더와 함께 보내세요.
시작하기
GET/balance지갑의 현재 잔액을 조회합니다.
API 키가 필요합니다.
매개변수
- 없음
- 쿼리 매개변수가 없습니다.
요청 예시
curl https://api.smsactivate.uk/balance -H "X-API-KEY: YOUR_API_KEY"응답
{ "balance": "10.0000" }Errors
이 엔드포인트는 인증된 계정의 현재 잔액을 반환합니다.
번호 받기 및 관리
POST/get_numbers활성화 주문을 생성합니다.
API 키가 필요합니다.
매개변수
- service
- 필수 문자열. 서비스 코드, 예: tg.
- country
- 필수 정수. 숫자 국가 ID.
- operator
- 선택 문자열. 기본값은 any.
- max_price
- 선택 숫자. 최대 가격. maxPrice도 사용할 수 있습니다.
- min_price
- 선택 숫자. minPrice도 사용할 수 있습니다.
- any_price
- 선택 불리언. anyPrice도 사용할 수 있습니다.
- product
- 선택: standard(기본값) 또는 api_links. API Links는 환불 불가 재고 구매입니다.
- idempotency_key
- 표준 활성화용 선택 UUID. 결과를 확인하는 중인 동일한 구매 요청에만 같은 키를 재사용하세요.
- quantity
- API Links 재고 주문용 1~100 사이의 선택 정수. 기본값은 1. 표준 활성화 주문은 번호 하나입니다.
요청 예시
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}'응답
{
"id": "ORDER_ID",
"phone": "10000000000",
"price": "0.2500",
"balance_remaining": "9.7500"
}Errors
HTTP 400: 선택 불가, 가격 한도 또는 잔액 부족. HTTP 409: 이전 주문을 아직 확인 중입니다. HTTP 503: 일시적 오류 또는 불확실한 주문. 응답에 조정이 필요하다고 표시되면 재시도하지 말고 지원팀에 문의하세요.
GET/sms/{order_id}활성 주문의 상태를 다시 확인하도록 요청합니다.
API 키가 필요합니다. 이 엔드포인트에는 요청 제한이 있습니다.
매개변수
- order_id
- 주문 생성 시 반환된 필수 경로 값입니다.
요청 예시
curl https://api.smsactivate.uk/sms/ORDER_ID -H "X-API-KEY: YOUR_API_KEY"응답
{
"status": "received",
"sms_code": "123456",
"raw_sms": "Your verification code is 123456"
}Errors
HTTP 400: 이 주문은 SMS 확인을 사용할 수 없습니다. HTTP 404: 주문을 찾을 수 없습니다. HTTP 502: 일시적 확인 실패. 만료된 주문은 새 외부 확인 없이 저장된 상태를 반환합니다.
GET/status/{order_id}주문 상태와 수신된 SMS를 조회합니다.
API 키가 필요합니다.
매개변수
- order_id
- 주문 생성 시 반환된 필수 경로 값입니다.
요청 예시
curl https://api.smsactivate.uk/status/ORDER_ID -H "X-API-KEY: YOUR_API_KEY"응답
{
"status": "received",
"sms_code": "123456",
"raw_sms": "Your verification code is 123456"
}Errors
응답은 인증된 계정의 주문으로 한정됩니다. 상태 조회가 실패하면 API가 오류를 반환합니다. 주문 ID를 확인하고 서비스가 일시적으로 사용 불가이면 나중에 다시 시도하세요.
POST/resend/{order_id}지원되는 활성 활성화에 대해 SMS를 한 번 더 요청합니다.
API 키가 필요합니다.
매개변수
- order_id
- 필수 경로 값. 요청 본문 없음.
요청 예시
curl -X POST https://api.smsactivate.uk/resend/ORDER_ID -H "X-API-KEY: YOUR_API_KEY"응답
{ "message": "Resend request successful. Waiting for new SMS." }Errors
HTTP 400: 재전송이 허용되지 않거나 주문이 만료되었습니다. HTTP 409: 이 주문은 재전송을 사용할 수 없습니다. HTTP 500: 재전송을 완료하지 못했습니다.
POST/cancel/{order_id}취소 가능한 활성화의 취소를 요청합니다.
API 키가 필요합니다.
매개변수
- order_id
- 필수 경로 값. 요청 본문 없음.
요청 예시
curl -X POST https://api.smsactivate.uk/cancel/ORDER_ID -H "X-API-KEY: YOUR_API_KEY"응답
{
"message": "Number cancelled and balance refunded",
"refunded_amount": "0.2500",
"new_balance": "10.0000"
}Errors
취소는 구매 후 2~20분 사이이고 SMS가 도착하기 전의 취소 가능한 활성 활성화에만 가능합니다. 임대는 /rent/cancel/{order_id}를 사용하며 API Links는 환불 불가입니다. 취소 불가이거나 확인되지 않은 취소는 오류를 반환합니다. 재시도하기 전에 취소 응답을 확인하세요.
GET/reactivate/{order_id}/options현재 재활성화 가격과 세부 정보를 확인합니다.
API 키가 필요합니다.
매개변수
- order_id
- 원래 주문의 필수 경로 값입니다.
요청 예시
curl https://api.smsactivate.uk/reactivate/ORDER_ID/options -H "X-API-KEY: YOUR_API_KEY"응답
{
"price": 0.25,
"duration": 20,
"phone": "10000000000",
"service": "tg",
"country": 2
}Errors
HTTP 400: 재활성화가 지원되지 않거나 사용할 수 없습니다. HTTP 409: 이 주문은 재활성화를 사용할 수 없습니다. HTTP 503: 유효한 현재 가격을 확인하지 못했습니다.
POST/reactivate/{order_id}취소 가능한 활성화를 현재 가격으로 재활성화합니다.
API 키가 필요합니다.
매개변수
- order_id
- 원래 주문의 필수 경로 값입니다. 요청 본문 없음.
요청 예시
curl -X POST https://api.smsactivate.uk/reactivate/ORDER_ID -H "X-API-KEY: YOUR_API_KEY"응답
{
"message": "Number reactivated successfully.",
"id": "NEW_ORDER_ID",
"phone": "10000000000",
"price": 0.25,
"balance_remaining": 9.75
}Errors
HTTP 400: 재활성화가 지원되지 않거나 지갑 잔액이 부족합니다. HTTP 409: 이 주문은 사용할 수 없습니다. HTTP 503: 결과를 확인하지 못했습니다. 다시 시도하기 전에 지원팀에 문의하세요.
GET/orders/{order_id}내 주문 중 하나의 세부 정보를 조회합니다.
API 키가 필요합니다.
매개변수
- order_id
- 주문 생성 시 반환된 필수 경로 값입니다.
요청 예시
curl https://api.smsactivate.uk/orders/ORDER_ID -H "X-API-KEY: YOUR_API_KEY"응답
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: 주문을 찾을 수 없거나 내 계정의 주문이 아닙니다.
서비스, 국가, 가격 선택
서비스이름 또는 코드로 서비스 카탈로그를 검색하세요. 재고는 변동될 수 있으니 주문 전에 실시간 엔드포인트를 확인하세요.
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
실시간 재고 및 응답 예시:
GET https://api.smsactivate.uk/services{
"services": ["tg", "wa", "go"],
"providers": { "source-counts": "per active catalog" },
"generated_at": "ISO 8601 timestamp"
}카탈로그는 조회용 이름과 코드를 제공합니다. 재고는 실시간이며 이 목록과 다를 수 있습니다. 이 JSON은 응답 형태를 보여줄 뿐 현재 재고가 아닙니다.
국가대시보드 카탈로그의 숫자 국가 ID입니다. 표준 활성화용 일반 국가 목록 API 엔드포인트는 없습니다.
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
하나의 서비스와 국가에 대한 오퍼 응답 형태:
[
{ "name": "any", "offers": [{ "price": 0.25, "count": 4 }] }
]카탈로그 ID는 국가 선택지를 식별할 뿐 실시간 오퍼를 보장하지 않습니다. 재고는 /offers/{service}/{country} 에서 확인하세요.
GET/services서비스의 현재 재고 상태를 확인합니다.
공개 - API 키가 필요하지 않습니다.
매개변수
- 없음
- 이 엔드포인트는 쿼리 매개변수를 받지 않습니다.
요청 예시
curl https://api.smsactivate.uk/services응답
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
재고는 변동될 수 있습니다. 주문하기 전에 실시간 엔드포인트와 /offers/{service}/{country}를 확인하세요.
GET/countries/{service}서비스에 현재 번호가 있는 국가 ID 목록을 조회합니다.
공개 - API 키가 필요하지 않습니다.
매개변수
- service
- 필수 서비스 코드, 예: tg.
요청 예시
curl https://api.smsactivate.uk/countries/tg응답
{ "countries": [2, 6, 187] }Errors
국가 ID는 아래 국가 카탈로그와 일치합니다. 재고는 변동됩니다. 주문하기 전에 /offers/{service}/{country}를 확인하세요. 이 엔드포인트에는 요청 제한이 있습니다.
GET/offers/{service}/{country}/delivery가격 구간별 최근 코드 수신율을 확인합니다.
공개 - API 키가 필요하지 않습니다.
매개변수
- service
- 필수 서비스 코드, 예: tg.
- country
- 필수 숫자 국가 ID.
요청 예시
curl https://api.smsactivate.uk/offers/tg/2/delivery응답
{
"window_days": 30,
"tiers": { "0.2500": { "orders": 120, "codes": 108, "delivery_pct": 90, "best": true } }
}Errors
HTTP 400: 잘못된 서비스 또는 국가. 수신된 코드가 없는 구간은 표시되지 않습니다. 결과는 약 5분간 캐시되며 최근 window_days일을 대상으로 합니다. 이 엔드포인트에는 요청 제한이 있습니다.
GET/operators?service={service}&country={country}서비스와 국가에 사용 가능한 통신사 목록을 조회합니다.
공개 - API 키가 필요하지 않습니다.
매개변수
- service
- 필수 서비스 코드, 예: tg.
- country
- 필수 숫자 국가 ID.
요청 예시
curl 'https://api.smsactivate.uk/operators?service=tg&country=2'응답
[
{ "name": "any", "localName": "Any Operator" },
{ "name": "example", "localName": "Example operator" }
]Errors
목록은 선택한 국가와 현재 재고에 따라 달라집니다. service와 country 모두 필수이며, 누락되거나 잘못된 값은 HTTP 422를 반환합니다.
GET/links/optionsAPI Links 카탈로그의 서비스와 국가 선택지를 조회합니다.
공개 - API 키가 필요하지 않습니다.
매개변수
- 없음
- 이 엔드포인트는 쿼리 매개변수를 받지 않습니다.
요청 예시
curl https://api.smsactivate.uk/links/options응답
{
"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
이 목록은 API Links 전용입니다. 표준 활성화 주문을 위한 일반 국가 목록이 아닙니다.
GET/links/offers/{service}/{country}현재 API Links 재고 가격과 수량을 확인합니다.
공개 - API 키가 필요하지 않습니다.
매개변수
- service
- API Links 옵션 카탈로그의 서비스 코드.
- country
- 선택한 서비스의 API Links 국가 목록에 있는 숫자 국가 ID.
요청 예시
curl https://api.smsactivate.uk/links/offers/tg/1응답
[{ "name": "any", "offers": [{ "price": "0.2500", "count": 4 }] }]Errors
사용할 수 없는 선택은 빈 목록을 반환합니다. 이 상품을 구매하려면 /get_numbers에 product=api_links를 보내세요. API Links는 환불 불가이며 quantity의 기본값은 1이고 1~100 사이여야 합니다.
GET/offers/{service}/{country}하나의 서비스와 국가 조합에 대한 오퍼를 확인합니다.
공개 - API 키가 필요하지 않습니다.
매개변수
- service
- 필수 경로 값. /services가 반환한 서비스 코드를 사용하세요. 예: tg.
- country
- 필수 경로 값. 숫자 국가 ID. 표준 활성화는 대시보드 국가 카탈로그를 사용하세요. 이 국가 ID를 나열하는 일반 API 엔드포인트는 없습니다.
요청 예시
curl https://api.smsactivate.uk/offers/tg/2응답
[
{
"name": "any",
"offers": [{ "price": "0.2500", "count": 4 }]
}
]Errors
지원되지 않거나 사용할 수 없는 조합은 빈 목록을 반환할 수 있습니다. 오퍼 데이터는 캐시되며, 캐시에 없으면 재고를 확인하는 동안 더 오래 걸릴 수 있습니다.
지난 활동 보기
GET/orders주문 내역을 최신순으로 조회합니다.
API 키가 필요합니다.
매개변수
- page
- 선택 페이지 번호. 기본값은 1.
- per_page
- 선택 페이지 크기. 기본값은 20이며 최대 100입니다.
- status
- 선택: active, completed(또는 received), cancelled, expired, refunded. 모든 상태를 포함하려면 생략하거나 all을 사용하세요.
- search
- 선택 전화번호 검색.
- category
- 선택: rents, links 또는 numbers.
요청 예시
curl 'https://api.smsactivate.uk/orders?page=2&per_page=100&status=received&category=numbers' -H "X-API-KEY: YOUR_API_KEY"응답
{
"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
next_page_url이 null이 될 때까지 따라가세요. page의 기본값은 1이고, per_page의 기본값은 20이며 값은 1–100으로 제한됩니다. status는 active, completed/received, cancelled, expired, refunded를 받으며, all 또는 알 수 없는 값은 status를 필터링하지 않습니다. search는 전화번호와 일치합니다. category는 rents, links, numbers를 받으며 알 수 없는 카테고리는 무시됩니다. 내역이 많으면 여러 번의 페이지 요청이 필요합니다.
임대
GET/rent/services국가와 기간별 임대 서비스를 확인합니다.
API 키가 필요합니다.
매개변수
- country
- 선택 정수 국가 ID. 기본값은 2.
- duration
- 선택 시간. 기본값은 24. 허용 범위: 24–1,344시간.
요청 예시
curl 'https://api.smsactivate.uk/rent/services?country=2&duration=24' -H "X-API-KEY: YOUR_API_KEY"응답
Returns rental availability, with service codes and current prices for the selected country and duration.Errors
HTTP 400: 선택한 조건에 사용 가능한 임대 번호가 없습니다. HTTP 422: 잘못된 국가 또는 기간. HTTP 503: 임대 카탈로그를 일시적으로 사용할 수 없습니다.
POST/rent/order임대 주문을 생성합니다.
API 키가 필요합니다.
매개변수
- service
- 필수 서비스 코드(문자열).
- country
- 필수 국가 ID(정수).
- duration
- 필수 시간, 24–1,344.
- operator
- 선택 문자열. 기본값은 any.
요청 예시
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}'응답
{
"message": "Number rented successfully.",
"id": "ORDER_ID",
"phone": "10000000000",
"price": 2.50,
"balance_remaining": 7.50
}Errors
HTTP 400: 잘못된 요청 또는 잔액 부족. HTTP 409: 사용 가능한 임대가 없습니다. HTTP 503: 결과가 검토 대기 중입니다. 지원팀이 주문을 확인할 때까지 재시도하지 마세요.
POST/rent/cancel/{order_id}취소 가능한 임대의 취소를 요청합니다.
API 키가 필요합니다.
매개변수
- order_id
- 필수 경로 값. 요청 본문 없음.
요청 예시
curl -X POST https://api.smsactivate.uk/rent/cancel/ORDER_ID -H "X-API-KEY: YOUR_API_KEY"응답
Returns the cancellation result. Refunds may remain pending verification after cancellation is accepted.Errors
취소는 구매 후 2~20분 사이이고 SMS가 도착하기 전의 취소 가능한 활성 임대로 제한됩니다. HTTP 404: 임대를 찾을 수 없습니다. HTTP 409: 임대가 취소 대상이 아닙니다. 승인되면 환불은 확인 대기 상태로 남을 수 있습니다.
GET/rent/extend/{order_id}/options임대에 사용 가능한 연장 옵션을 확인합니다.
API 키가 필요합니다.
매개변수
- order_id
- 임대의 필수 경로 값입니다.
요청 예시
curl https://api.smsactivate.uk/rent/extend/ORDER_ID/options -H "X-API-KEY: YOUR_API_KEY"응답
{
"options": [{ "duration": 24, "price": 2.50 }],
"expires_at": "2026-10-06T12:00:00Z"
}Errors
HTTP 404: 임대를 찾을 수 없습니다. HTTP 409: 임대가 연장 대상이 아닙니다(연장은 처음 20분 이후에 열리며, 임대는 active 또는 received 상태여야 하고, 이전 연장이 검토 대기 중이 아니어야 합니다). HTTP 503: 연장을 일시적으로 사용할 수 없거나 옵션을 불러오지 못했습니다. 나중에 다시 시도하세요. 이 엔드포인트에는 요청 제한이 있습니다.
POST/rent/extend/{order_id}활성 임대를 연장합니다.
API 키가 필요합니다.
매개변수
- order_id
- 임대의 필수 경로 값입니다.
- duration
- 필수: 24, 72, 168, 336, 720, 1,440, 2,160 또는 4,320시간. 현재 옵션 응답에서 선택하세요.
- expected_price
- 현재 옵션 응답에서 복사한 필수 숫자.
- Idempotency-Key
- 필수 UUID v4 요청 헤더. 동일한 연장 시도를 안전하게 재시도할 때만 재사용하세요.
요청 예시
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}'응답
{
"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 또는 Idempotency-Key가 없거나 잘못되었습니다. HTTP 409: 임대가 연장 대상이 아니거나, 기간 또는 가격이 더 이상 제공되지 않거나, Idempotency-Key가 이미 사용되었습니다. HTTP 202: 연장이 검토 대기 중입니다. 새 멱등성 키로 재시도하지 마세요. HTTP 503: 연장을 확인하지 못했습니다. 지원팀에 문의하세요.
이메일 인증
GET/emails/catalog?site={site}사이트에 사용 가능한 인증 주소 도메인 목록을 조회합니다.
API 키가 필요합니다.
매개변수
- site
- 필수 웹사이트 도메인, 예: example.com.
요청 예시
curl 'https://api.smsactivate.uk/emails/catalog?site=example.com' -H "X-API-KEY: YOUR_API_KEY"응답
[{ "name": "sample-domain.test", "price": 0.10, "stock": 5 }]Errors
HTTP 422: 잘못된 site 값. HTTP 503: 이메일 카탈로그를 일시적으로 사용할 수 없습니다.
POST/emails/buy인증 주소 하나를 구매합니다.
API 키가 필요합니다.
매개변수
- site
- 필수 웹사이트 도메인.
- domain
- 현재 카탈로그 응답에서 선택한 필수 도메인.
요청 예시
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"}'응답
Returns an order object and balance_remaining when the purchase is confirmed.Errors
HTTP 400: 지갑 잔액 부족. HTTP 409: 도메인 재고 없음. HTTP 503: 구매가 검토 대기 중입니다. 지원팀이 주문을 확인할 때까지 재시도하지 마세요.
POST/emails/{order_id}/reorder이전 주문이 끝난 뒤 같은 주소를 다시 주문합니다.
API 키가 필요합니다.
매개변수
- order_id
- 완료된 이메일 주문의 필수 경로 값(숫자). 요청 본문 없음.
요청 예시
curl -X POST https://api.smsactivate.uk/emails/ORDER_ID/reorder -H "X-API-KEY: YOUR_API_KEY"응답
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: 주문을 찾을 수 없습니다. HTTP 409: 이전 주문이 끝나지 않았거나, 재주문이 이미 진행 중이거나, 이 주소를 지금은 재주문할 수 없습니다. HTTP 503: 이메일 인증을 일시적으로 사용할 수 없습니다. 이 엔드포인트에는 요청 제한이 있습니다.
GET/emails/history이메일 인증 주문 목록을 조회합니다.
API 키가 필요합니다.
매개변수
- page
- 선택 페이지 번호. 기본값은 1.
- per_page
- 선택 페이지 크기. 기본값은 20이며 최대 50입니다.
요청 예시
curl 'https://api.smsactivate.uk/emails/history?page=1&per_page=20' -H "X-API-KEY: YOUR_API_KEY"응답
Returns paginated order data and page metadata.Errors
이메일 주문 테이블을 사용할 수 없으면 API는 빈 data 배열을 반환합니다.
GET/emails/status/{order_id}인증 주문을 조회하거나 새로 고칩니다.
API 키가 필요합니다.
매개변수
- order_id
- 구매 응답에서 반환된 필수 경로 값입니다.
요청 예시
curl https://api.smsactivate.uk/emails/status/ORDER_ID -H "X-API-KEY: YOUR_API_KEY"응답
Returns the order status and available verification result fields.Errors
HTTP 404: 주문을 찾을 수 없습니다. HTTP 503: 상태를 새로 고치지 못했습니다. 응답에는 주문에 사용 가능한 필드만 포함됩니다.
DELETE/emails/{order_id}이메일 인증 주문의 취소를 요청합니다.
API 키가 필요합니다.
매개변수
- order_id
- 구매 응답에서 반환된 필수 경로 값입니다.
요청 예시
curl -X DELETE https://api.smsactivate.uk/emails/ORDER_ID -H "X-API-KEY: YOUR_API_KEY"응답
Returns the cancellation result. The refund can remain pending verification.Errors
주문은 내 계정 소속이어야 하고 취소 가능해야 합니다. 현재 주문 상태는 반환된 오류 메시지를 확인하세요. 응답에 취소가 아직 확인되지 않았다고 나오면(HTTP 503) 몇 분 기다린 뒤 요청을 다시 보내세요.
웹훅
GET/webhook웹훅 설정을 조회합니다.
API 키가 필요합니다.
매개변수
- 없음
- 쿼리 매개변수가 없습니다.
요청 예시
curl https://api.smsactivate.uk/webhook -H "X-API-KEY: YOUR_API_KEY"응답
Returns the saved endpoint configuration. The signing secret is not returned by this read request.Errors
인증된 계정의 현재 설정을 반환합니다.
PUT/webhook웹훅 URL을 생성하거나 업데이트합니다.
API 키가 필요합니다.
매개변수
- url
- 443 포트의 필수 공개 HTTPS URL. 로컬 및 사설 주소는 거부됩니다.
요청 예시
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"}'응답
Returns the saved configuration. On first setup the signing secret is returned once; store it safely.Errors
HTTP 422: URL이 허용되는 공개 HTTPS 주소가 아닙니다.
POST/webhook/rotate-secret설정된 웹훅의 서명 시크릿을 교체합니다.
API 키가 필요합니다.
매개변수
- 없음
- 요청 본문 없음. 먼저 웹훅을 설정하세요.
요청 예시
curl -X POST https://api.smsactivate.uk/webhook/rotate-secret -H "X-API-KEY: YOUR_API_KEY"응답
{ "secret": "NEW_SECRET_SHOWN_ONCE" }Errors
HTTP 404: 설정된 웹훅이 없습니다. 새 시크릿은 안전하게 저장하세요. 읽기 엔드포인트가 아니라 이 교체 응답에서 반환됩니다.
DELETE/webhook웹훅 설정을 삭제합니다.
API 키가 필요합니다.
매개변수
- 없음
- 요청 본문 없음.
요청 예시
curl -X DELETE https://api.smsactivate.uk/webhook -H "X-API-KEY: YOUR_API_KEY"응답
{ "configured": false }Errors
인증된 계정의 웹훅 설정을 삭제합니다.
POST/webhook/test설정된 엔드포인트로 테스트 이벤트를 보냅니다.
API 키가 필요합니다.
매개변수
- 없음
- 요청 본문 없음. 먼저 웹훅을 설정하세요.
요청 예시
curl -X POST https://api.smsactivate.uk/webhook/test -H "X-API-KEY: YOUR_API_KEY"응답
{
"delivered": true,
"http_status": 200,
"message": "Your server accepted the test message."
}Errors
HTTP 404: 설정된 웹훅이 없습니다. 서버가 수락하지 않으면 테스트 전송은 delivered=false로 보고합니다.
GET/webhook/deliveries최근 웹훅 전송 시도를 최대 50건까지 확인합니다.
API 키가 필요합니다.
매개변수
- 없음
- 쿼리 매개변수가 없습니다.
요청 예시
curl https://api.smsactivate.uk/webhook/deliveries -H "X-API-KEY: YOUR_API_KEY"응답
{
"data": [{ "id": 42, "event_id": "EVENT_ID", "event_type": "sms.received", "status": "success", "attempts": 1, "http_status": 200 }]
}Errors
가장 최근의 HTTP 웹훅 전송 50건을 최신순으로 반환합니다.
POST/webhook/deliveries/{id}/retry웹훅 전송 중 하나를 지금 다시 시도합니다.
API 키가 필요합니다.
매개변수
- id
- 전송 기록의 필수 경로 값입니다.
요청 예시
curl -X POST https://api.smsactivate.uk/webhook/deliveries/42/retry -H "X-API-KEY: YOUR_API_KEY"응답
{ "status": "success", "http_status": 200 }Errors
HTTP 404: 전송 기록을 찾을 수 없습니다. 이 엔드포인트에는 요청 제한이 있습니다.
4. 결제
주문 시 잔액에서 금액이 차감됩니다. 20분 제한 시간 내에 SMS를 받지 못한 활성화는 잔액으로 환불됩니다. 취소 및 환불 규칙은 임대, 이메일, API Links마다 다릅니다.
5. 취소 및 환불
번호 주문(활성화)은 처음 2분이 지난 후 20분 활성화 시간이 끝나기 전까지, SMS가 도착하지 않은 경우에만 취소를 요청할 수 있습니다. 적격 조건을 충족해 확인된 취소는 주문 금액을 잔액으로 환불합니다.
SMS가 도착했거나 활성화 시간이 끝난 후에는 활성화를 취소할 수 없습니다. 적격 활성화가 20분 동안 SMS를 받지 못하면 주문 금액이 잔액으로 환불됩니다.
임대는 코드가 도착하지 않았다면 같은 2~20분 구간에서 취소할 수 있습니다. 임대 환불은 확인 후 처리되며 자동으로 이루어지지 않습니다.
대량 번호, API Links, 이메일 주문은 대시보드에 별도로 명시되지 않는 한 전달 후 환불되지 않습니다.
취소를 확인할 수 없는 경우 다시 시도하기 전에 고객 지원에 문의하세요.
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 "
