code Developer API

CodeMandi API

Programmatic access to virtual numbers, OTP polling, and real-time SMS delivery — built for developers and automation workflows.

In development

Launching soon

We're building a powerful REST + WebSocket API that gives developers full programmatic access to the CodeMandi virtual-number network. Join the waitlist for early access and priority onboarding.

send Join the waitlist on Telegram

What will be available

A full-featured API designed for developers and automation workflows.

data_object

REST API with JSON

Clean, predictable REST endpoints with JSON request and response bodies. Easy to integrate with any language or framework.

public

Browse by country & platform

Query available virtual numbers filtered by country code and target platform (WhatsApp, Telegram, Google, etc.).

add_circle

Purchase number endpoint

Programmatically purchase a virtual number and receive it instantly in the API response.

sms

Check OTP status

Poll the OTP status endpoint to check if an SMS has been received and retrieve the code when available.

webhook

Webhook + WebSocket push

Register a webhook URL or subscribe to a WebSocket channel for real-time push when an OTP is delivered — no polling needed.

key

API key management

Generate, rotate, and revoke API keys from your dashboard with read-only or full-access permissions.

Preview

A glimpse of what the API will look like.

POST /v1/numbers/buy

Purchase a number

# Buy a WhatsApp number from India
curl -X POST https://api.codemandi.com/v1/numbers/buy \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"platform": "whatsapp", "country": "IN"}'

# Response
{
  "success": true,
  "number": "+91 98765 43210",
  "order_id": "ord_abc123xyz",
  "expires_at": "2026-05-15T12:30:00Z",
  "platform": "whatsapp",
  "country": "IN"
}

GET /v1/numbers/{order_id}/otp

Check OTP status

# Poll for OTP delivery
curl https://api.codemandi.com/v1/numbers/ord_abc123xyz/otp \
  -H "Authorization: Bearer YOUR_API_KEY"

# Response (OTP received)
{
  "status": "received",
  "otp": "829415",
  "received_at": "2026-05-15T12:28:44Z",
  "message": "Your WhatsApp code is 829415"
}

send

Get early API access

Message us on Telegram to join the early-access waitlist. We'll notify you the moment the API is ready and give you priority onboarding.

send Message @Codemandisupport Tell us your use case and we'll get back to you within 2 hours.