SNSNumber

휴대폰 번호 대여 API

직접 작성한 코드로 번호 대여, 수신 SMS 읽기, 연장 및 취소를 할 수 있어요. 콘솔에서 발급받은 하나의 API 키로 HTTPS를 통해 JSON 형식으로 이용 가능해요.

기본 URL
https://snsnumber.com/api/v1
인증
Authorization: Bearer snk_...
요청 제한
키당 분당 300회 요청 가능

콘솔의 API 메뉴에서 키를 생성하세요. 가격은 소수점 둘째 자리까지의 문자열로 표시된 미국 달러예요. 시간은 UTC 기준 ISO 8601 형식이에요.

엔드포인트

GET/balance미국 달러 기준 크레딧 잔액.
{ "balance": "120.00", "currency": "USD" }
GET/prices?country=us국가, 기간 및 가격 정보. 국가를 생략하면 전체 목록을 반환해요.
{ "currency": "USD", "countries": [ { "country": "us", "name": "United States", "dial": "+1",
  "periods": [ { "days": 15, "price": "36.00" }, { "days": 30, "price": "54.00" } ] } ] }
POST/rentals번호 대여. 요청 본문: 국가 코드와 일수.
curl -X POST https://snsnumber.com/api/v1/rentals -H "Authorization: Bearer snk_..." \
  -H "Content-Type: application/json" -d '{"country":"us","days":30}'

{ "rental": { "id": "RN-7KQ2M9XWD4", "country": "us", "phone": "+14155550123", "state": "active",
  "days": 30, "ends_at": "2026-12-03T10:00:00.000Z", "can_cancel": true, "messages": [] } }
GET/rentals?state=active대여 중인 번호 목록 (상태: 사용 중, 만료, 취소됨), 최신순으로 보여요.
{ "rentals": [ { "id": "RN-7KQ2M9XWD4", "phone": "+14155550123", "state": "active", "message_count": 2 } ] }
GET/rentals/{id}대여 번호와 수신함이에요.
{ "rental": { "id": "RN-7KQ2M9XWD4", "messages": [ { "id": 18, "sender": "Verify",
  "text": "Your verification code is 482913.", "code": "482913", "received_at": "2026-11-03T10:01:12.000Z" } ] } }
POST/rentals/{id}/extend사용 중인 번호에 기간을 추가해요. 본문: 일수.
{"days":15}  ->  { "rental": { "id": "RN-7KQ2M9XWD4", "extensions": 1, "ends_at": "2026-12-18T10:00:00.000Z" } }
POST/rentals/{id}/cancelSMS가 도착하지 않은 상태에서 20분 이내 취소하면 전액 환불해요.
{ "rental": { "id": "RN-7KQ2M9XWD4", "state": "canceled" } }

오류

오류는 HTTP 상태 코드와 { "error": { "code", "message" } }을 반환해요.

상태코드의미
401no_key, bad_keyAPI 키가 없거나 잘못되었어요
402no_balance크레딧이 부족해요
404not_found대여 번호를 찾을 수 없어요
409ended, cancel_denied대여가 종료되었거나 취소 기간이 지났어요
429rate_limited, too_many_active분당 300회 요청 또는 20개의 활성 번호 초과
503network_error잠시 후 다시 시도해보세요
전화번호 대여 API: 대여, 수신함, 연장 | SNSNumber