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_KEY

Endpoints

GET/api/v1/balance

Check 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

GET/api/v1/prices

Get 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
  }
}
POST/api/v1/numbers

Buy 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
}
GET/api/v1/numbers/:id

Check 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"
}
POST/api/v1/numbers/:id/cancel

Cancel 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

GET/api/v1/boost/services

List 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
    }
  ]
}
POST/api/v1/boost/orders

Place 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"
}
GET/api/v1/boost/orders/:id

Check 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

GET/api/v1/emails/offers?site=instagram.com

List 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 }
  ]
}
POST/api/v1/emails

Buy 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"
}
GET/api/v1/emails/:id

Check 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"
}
POST/api/v1/emails/:id/cancel

Cancel 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.

Help · Rules · Terms of Service