Developers
OTPBox API
Buy numbers, social media boosts and email addresses, check their status, and manage your wallet programmatically. Every key shares the same wallet balance and refund rules as the normal site — nothing behaves differently just because you're calling it from code.
Getting a key
Sign in to your OTPBox account and generate one yourself — no waiting on us.
Get your API key →Authentication
Send your key as a bearer token on every request. All amounts are in Nigerian Naira (NGN).
Authorization: Bearer YOUR_API_KEYEndpoints
/api/v1/balanceCheck your balance
Returns your current wallet balance.
Request
curl https://www.otpboxofficial.com/api/v1/balance \
-H "Authorization: Bearer YOUR_API_KEY"Response
{
"balance": 5000,
"currency": "NGN"
}Numbers
/api/v1/pricesGet prices
Prices for a service, by country name. Omit the service param to list all available service codes.
Request
curl "https://www.otpboxofficial.com/api/v1/prices?service=tg" \
-H "Authorization: Bearer YOUR_API_KEY"Response
{
"service": "tg",
"currency": "NGN",
"prices": {
"Poland": 5050,
"United Kingdom": 1800,
"USA": 4700
}
}/api/v1/numbersBuy a number
Debits your wallet and requests a number from the given service/country. Fails with 402 if your balance is too low, 404 if that combo isn't available, 409 if no numbers are in stock right now.
Request
curl -X POST https://www.otpboxofficial.com/api/v1/numbers \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{"service": "tg", "country": "Poland"}'Response
{
"id": "ef84d5ff-f806-4561-a29e-adad14f2daaf",
"phoneNumber": "48739271067",
"service": "tg",
"country": "Poland",
"price": 5050,
"currency": "NGN",
"status": "pending",
"expiresInSeconds": 1199,
"canResend": true
}/api/v1/numbers/:idCheck status / get the code
Poll this until status is 'delivered' (otp will be set) or 'refunded' (no code arrived in time — your wallet is credited automatically).
Request
curl https://www.otpboxofficial.com/api/v1/numbers/ef84d5ff-f806-4561-a29e-adad14f2daaf \
-H "Authorization: Bearer YOUR_API_KEY"Response
{
"id": "ef84d5ff-f806-4561-a29e-adad14f2daaf",
"status": "delivered",
"otp": "384921",
"phoneNumber": "48739271067",
"service": "tg",
"country": "Poland"
}/api/v1/numbers/:id/cancelCancel and refund
Cancels a pending purchase and refunds your wallet. Only works after the first ~2 minutes (409 if too early) and only while a number is still pending — once a code has been delivered, that purchase is final.
Request
curl -X POST https://www.otpboxofficial.com/api/v1/numbers/ef84d5ff-f806-4561-a29e-adad14f2daaf/cancel \
-H "Authorization: Bearer YOUR_API_KEY"Response
{
"id": "ef84d5ff-f806-4561-a29e-adad14f2daaf",
"status": "refunded"
}Boost
/api/v1/boost/servicesList Boost services
Followers, likes, views and more, with the price per 1,000 and the smallest and largest order. Use the id to order.
Request
curl https://www.otpboxofficial.com/api/v1/boost/services \
-H "Authorization: Bearer YOUR_API_KEY"Response
{
"currency": "NGN",
"on": true,
"services": [
{
"id": "b1dabf63bb492ad5",
"platform": "Instagram",
"name": "Followers",
"note": "High quality, real accounts",
"kind": "followers",
"pricePer1000": 2730,
"min": 10,
"max": 100000
}
]
}/api/v1/boost/ordersPlace a Boost order
Charges your wallet and starts the order. link is the full https link to the page or post. Optionally send amount (the price you expect); if our price has changed, nothing is charged and you get 409. Fails with 402 if your balance is too low.
Request
curl -X POST https://www.otpboxofficial.com/api/v1/boost/orders \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{"service": "b1dabf63bb492ad5", "link": "https://instagram.com/yourpage", "quantity": 1000}'Response
{
"id": "3b1f0c52-8d0e-4a51-9a3e-2f7c1d9e6a10",
"platform": "Instagram",
"name": "Followers",
"link": "https://instagram.com/yourpage",
"quantity": 1000,
"amount": 2730,
"refunded": 0,
"status": "in_progress",
"delivered": 0,
"startCount": null,
"createdAt": "2026-11-19T18:00:00Z",
"currency": "NGN"
}/api/v1/boost/orders/:idCheck a Boost order
status is in_progress while it runs, then completed, partial (part delivered, the rest refunded to your wallet) or cancelled (refunded). unconfirmed means we are still confirming the order started; if it did not, the money returns to your wallet. delivered is how many have been added so far. GET /api/v1/boost/orders lists your 50 newest.
Request
curl https://www.otpboxofficial.com/api/v1/boost/orders/3b1f0c52-8d0e-4a51-9a3e-2f7c1d9e6a10 \
-H "Authorization: Bearer YOUR_API_KEY"Response
{
"id": "3b1f0c52-8d0e-4a51-9a3e-2f7c1d9e6a10",
"quantity": 1000,
"amount": 2730,
"refunded": 0,
"status": "completed",
"delivered": 1000,
"currency": "NGN"
}Emails
/api/v1/emails/offers?site=instagram.comList inboxes for a website
The email addresses on sale for signing up to a website, with their prices. Use the domain to buy.
Request
curl "https://www.otpboxofficial.com/api/v1/emails/offers?site=instagram.com" \
-H "Authorization: Bearer YOUR_API_KEY"Response
{
"site": "instagram.com",
"currency": "NGN",
"on": true,
"inboxes": [
{ "domain": "gmail.com", "label": "Gmail", "price": 250 }
]
}/api/v1/emailsBuy an email address
Charges your wallet and gives you an address. Use it to sign up, then poll the email for the code. Optionally send price (what you expect); if ours has changed, nothing is charged and you get 409.
Request
curl -X POST https://www.otpboxofficial.com/api/v1/emails \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{"site": "instagram.com", "domain": "gmail.com"}'Response
{
"id": "9c4e2a7b-1f3d-4b8e-a6c2-5d7f0e1b3a94",
"site": "instagram.com",
"kind": "Gmail",
"amount": 250,
"refunded": 0,
"status": "waiting",
"address": "example.name@gmail.com",
"code": null,
"body": null,
"createdAt": "2026-11-19T18:00:00Z",
"currency": "NGN"
}/api/v1/emails/:idCheck an email / get the code
Poll this until status is 'delivered' (code and body are set) or 'refunded'. GET /api/v1/emails lists your 50 newest.
Request
curl https://www.otpboxofficial.com/api/v1/emails/9c4e2a7b-1f3d-4b8e-a6c2-5d7f0e1b3a94 \
-H "Authorization: Bearer YOUR_API_KEY"Response
{
"id": "9c4e2a7b-1f3d-4b8e-a6c2-5d7f0e1b3a94",
"status": "delivered",
"address": "example.name@gmail.com",
"code": "482913",
"currency": "NGN"
}/api/v1/emails/:id/cancelCancel an email
Cancels an email that has not received its code. The money returns once the cancel is confirmed: 200 when it is at once, 202 'cancelling' when it takes a moment (keep polling the email), 409 if the code arrived first.
Request
curl -X POST https://www.otpboxofficial.com/api/v1/emails/9c4e2a7b-1f3d-4b8e-a6c2-5d7f0e1b3a94/cancel \
-H "Authorization: Bearer YOUR_API_KEY"Response
{
"id": "9c4e2a7b-1f3d-4b8e-a6c2-5d7f0e1b3a94",
"status": "refunded",
"refunded": 250,
"currency": "NGN"
}Errors
Errors come back as { "error": "..." } with a matching status code: 401 invalid/missing key, 402 insufficient balance, 404 not found, 409 temporarily unavailable or too early to cancel.