Real Non-VOIP Numbers for SMS Verification - Instant Delivery

Base URL: https://otpgrove.com/api/v1/. Charges deduct from your OTP Grove wallet. Orders created via API use the same order engine as the dashboard and appear immediately in Order History. Existing API keys keep working — create or regenerate only from Dashboard → API Key.

Authentication

Every request requires your API key:

• Header (recommended): Authorization: Bearer YOUR_API_KEY
• Query: ?api_key=YOUR_API_KEY

curl -X GET "https://otpgrove.com/api/v1/balance/" \
  -H "Authorization: Bearer YOUR_API_KEY"

Invalid / missing key → HTTP 401:

{
  "success": false,
  "error": {
    "code": "UNAUTHORIZED",
    "message": "OTP Grove API Invalid API Key"
  },
  "error_message": "OTP Grove API Invalid API Key"
}

Service types

Used by /services/ and /buy/ as type.

Error responses

All errors use OTP Grove branding. Shape:

{
  "success": false,
  "error": {
    "code": "INSUFFICIENT_BALANCE",
    "message": "OTP Grove API Balance Low"
  },
  "error_message": "OTP Grove API Balance Low"
}

GET /api/v1/balance/

Wallet balance (server-authoritative).

curl -X GET "https://otpgrove.com/api/v1/balance/" \
  -H "Authorization: Bearer YOUR_API_KEY"

{
  "balance": "8.56",
  "currency": "USD"
}

GET /api/v1/services/

List purchasable services (price > 0). Header X-Powered-By: OTPGrove API.

curl -X GET "https://otpgrove.com/api/v1/services/?type=usa1" \
  -H "Authorization: Bearer YOUR_API_KEY"

Temp / global item shape:

[
  {
    "id": 1358186,
    "service_code": "wp",
    "name": "WhatsApp",
    "price": "0.0260",
    "currency": "USD",
    "provider": "OTP Grove",
    "providerName": "OTP Grove"
  }
]

Use id as service_id in POST /buy/.

GET /api/v1/countries/

curl -X GET "https://otpgrove.com/api/v1/countries/?type=dedicated" \
  -H "Authorization: Bearer YOUR_API_KEY"

Long Term Number USA (API products)

GET /api/v1/services/?type=longterm returns these stable product IDs (same pricing as dashboard):

curl -X POST "https://otpgrove.com/api/v1/buy/" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"type":"longterm","service_id":900001}'

If inventory is empty → OTP Grove API Service Unavailable.

Dedicated numbers (30-day)

GET /api/v1/services/?type=dedicated lists in-stock dedicated offers with country, carrier, and duration. Optional country filter. Buy with the returned id.

curl -X GET "https://otpgrove.com/api/v1/services/?type=dedicated&country=United%20States" \
  -H "Authorization: Bearer YOUR_API_KEY"

POST /api/v1/buy/

JSON body. Debits wallet atomically on success.

curl -X POST "https://otpgrove.com/api/v1/buy/" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"type":"usa1","service_id":1358186}'

{
  "order_id": "42",
  "number": "+1234567890",
  "status": "pending",
  "provider": "OTP Grove",
  "providerName": "OTP Grove"
}

GET /api/v1/sms/

Poll SMS / OTP for an order you own. Poll every 3–5 seconds while pending.

curl -X GET "https://otpgrove.com/api/v1/sms/?order_id=42" \
  -H "Authorization: Bearer YOUR_API_KEY"

{
  "order_id": "42",
  "sms": "Your code is 123456",
  "status": "received"
}

Status: pending, received, cancelled, timeout.

GET /api/v1/status/

Status only (no full SMS body).

curl -X GET "https://otpgrove.com/api/v1/status/?order_id=42" \
  -H "Authorization: Bearer YOUR_API_KEY"

{
  "order_id": "42",
  "status": "pending"
}

POST /api/v1/cancel/

Cancel a pending SMS order when the dashboard cancel rules allow it (no OTP yet; within cancel window; not after renew). Refunds sell price to wallet when eligible.

Not supported for eSIM/dataplan orders and legacy SMSPool rental-request IDs — those return cancel-not-supported.

curl -X POST "https://otpgrove.com/api/v1/cancel/" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"order_id":"42"}'

{
  "status": "cancelled",
  "refund": "0.50"
}

API → Dashboard sync

• API orders are owned by the authenticated OTP Grove user
• Same SmsOrder / order lifecycle as the dashboard
• Visible in Order History and product pages immediately
• Balance updates on buy / refund
• SMS status stays in sync when you poll /sms/ or open the dashboard

FAQ

Is OTPGrove API cheaper than SMS-Activate?

Yes. OTPGrove REST API starts from about $0.10 per real non-VoIP OTP with no $30 minimum. SMS-Activate shut down — migrate getNumber/getSMS scripts to /api/v1/ endpoints.

Does the API provide real non-VoIP numbers?

Yes. Every usa1/usa2/global temp number via API is a real non-VoIP carrier number — not VoIP. Ideal for WhatsApp, Google, Telegram OTP automation.

How do I get an API key?

Register free at /register/, fund your wallet, then copy your API key from the dashboard API Key page. Start integrating in minutes.

Can I buy bulk non-VoIP numbers via API?

Yes. High-volume developers and resellers get bulk non-VoIP API access with volume discounts. Contact support for wholesale rates above 10,000 OTP/month.

What are the API rate limits?

Standard accounts: 60 requests/minute per API key. Bulk/reseller tiers: 300+ requests/minute. Contact support to raise limits.

Does OTPGrove support webhooks?

Webhook delivery for incoming SMS is on the roadmap for reseller tiers. Currently poll GET /api/v1/sms/ every 3–5 seconds for OTP.