Build with SMSBulk

Get your API key

Create an API key from your dashboard. Each user can create up to 10 keys.

Test authentication

Verify your key works by checking your wallet balance.

curl https://smsbulk.net/api/v1/wallet/balance \
  -H "x-api-key: YOUR_KEY"

# Response:
# { "balance": "10.00", "currency": "USD" }

Buy a number

Reserve a virtual number for SMS verification. Cost is deducted from your wallet.

curl -X POST https://smsbulk.net/api/v1/activations \
  -H "x-api-key: YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "serviceCode": "wa",
    "countryIso": "US"
  }'

# Response:
# {
#   "id": "cuid_xxx",
#   "phoneNumber": "12025550147",
#   "status": "WAITING",
#   "userCost": "0.50"
# }

Wait for the SMS

Poll the activation endpoint until status becomes RECEIVED. The SMS code will be in the response.

Message contents, including the code, are deleted 30 days after they are received; getStatus then returns NO_ACTIVATION and v1 returns purged: true.

curl https://smsbulk.net/api/v1/activations/cuid_xxx \
  -H "x-api-key: YOUR_KEY"

# Response (when SMS arrives):
# {
#   "id": "cuid_xxx",
#   "smsCode": "123456",
#   "status": "RECEIVED",
#   ...
# }