📡 API Docs

Full GreenSMS API reference, supporting both SMS and mail verification

Authentication

All API requests must carry your api_key in the URL parameters

GET https://www.greensms.net/api/mail/getActivation.php?api_key=YOUR_API_KEY&service=kc&domain=gmail.com&provider=smsbower
After login you can get your API Key in Profile
📧

Mail API (Temp Mail)

For services requiring email verification like Vinted, Gmail

GET /api/mail/getActivation.php

Get a temp mail address

Parameter

Parameter Required Description
api_key Yes Your API Key
service Yes Service code (e.g. kc = Vinted)
provider No Mail channel: omit / smsbower = BO mailbox (service = service code, e.g. kc); gmail500 = G5 mailbox (service = product code, e.g. 6074 = Vinted)
domain Yes Mail domain (e.g. gmail.com)
maxPrice No Max accepted price (e.g. 0.05)

G5 mailbox (provider=gmail500) common product codes: Vinted=6074 / TikTok=1001 / Instagram=1002 / Apple=1003 / PayPal=1004 / Facebook=1005 / X=1006 / Amazon=1007 / LinkedIn=1009 / Telegram=1011 / Airbnb=1021. Only products with a price configured in the admin panel are usable. G5 does not support cancellation or refund.

Response

{
  "status": 1,
  "mail": "xxx@gmail.com",
  "mailId": "12345678",
  "provider": "smsbower",
  "cancellable": true,
  "expires_at": 1790000000
}
GET /api/mail/getCode.php

Get the code received by the temp mail

Parameter

Parameter Required Description
api_key Yes Your API Key
mailId Yes Mail ID (returned by getActivation)

Response

{
  "status": 1,
  "code": "123456"
}
GET /api/mail/setStatus.php

Modify mail activation status (cancel/complete)

Status Code

Status Code Description
2 Cancel activation (no longer need this mail)
3 Complete (code received successfully)
5 Waiting for next mail (resend)

G5 mailbox (provider=gmail500) does not support cancellation or refund: calling status=2 returns {"status":0,"no_refund":true}; the mailbox simply expires at end of lifetime. BO mailbox (smsbower) still supports cancel + refund.

🚀 Gmail 接码完整示例 / Gmail receiving example

# 1) 获取 Gmail 临时邮箱 # BO邮箱（默认渠道，service 用服务码，如 kc=Vinted） curl "https://www.greensms.net/api/mail/getActivation.php?api_key=YOUR_API_KEY&service=kc&domain=gmail.com" # G5邮箱（provider=gmail500，service 用产品编号，如 6074=Vinted / 1001=TikTok） curl "https://www.greensms.net/api/mail/getActivation.php?api_key=YOUR_API_KEY&provider=gmail500&service=6074&domain=gmail.com" # 2) 轮询获取验证码（用第1步返回的 mailId 替换 MAILID） curl "https://www.greensms.net/api/mail/getCode.php?api_key=YOUR_API_KEY&mail_id=MAILID" # 3) 释放邮箱（status: 2=取消退费 3=完成 5=等待下一封） # 注意：G5邮箱（provider=gmail500）不支持取消退费，status=2 会返回 no_refund curl "https://www.greensms.net/api/mail/setStatus.php?api_key=YOUR_API_KEY&mail_id=MAILID&status=2"
📱

SMS API (Phone Verification)

For services requiring phone verification like Telegram, WhatsApp

GET /stubs/handler_api.php?action=getNumber

Get a phone number to receive SMS codes

Parameter

Parameter Description
service Service code (e.g. tg = Telegram, kc = Vinted)
country Country code (e.g. 0 = Russia, 6 = Indonesia)
GET /stubs/handler_api.php?action=getStatus

Get SMS code status

STATUS_OK:123456
STATUS_WAIT_CODE
STATUS_CANCEL

Common Service Codes

🛍️
Vinted
kc
✈️
Telegram
tg
💬
WhatsApp
wa
📘
Facebook
fb
🔍
Google
gg
📞
Viber
vi
📷
Instagram
ig
🐦
Twitter
tw
📧
Email
em
📦
Amazon
am