NeerMela Developer Platform

Build chat, calls & community into your product

One versioned REST API for messaging, voice & video, groups, media and identity — the same platform that powers the NeerMela app. Ship a business app, a support bot or a whole community, on Bangladesh's own infrastructure.

1
versioned API
REST
JSON in / out
JWT
secure auth
WS
realtime
# 1 · request a one-time code
curl -X POST https://neermela-api.onrender.com/v1/auth/otp/send \
  -H 'Content-Type: application/json' \
  -d '{"channel":"sms","phone":"+8801XXXXXXXXX"}'

# → { "challenge_id":"CH_…", "expires_in":300 }

# 2 · verify & get tokens
curl -X POST …/v1/auth/otp/verify \
  -d '{"challenge_id":"CH_…","code":"483921"}'

# → access_token + refresh_token
What the API gives you

Everything to build a communication product

Domain-separated modules, one clean contract. Start with auth and messaging, add the rest as you grow.

🔐

Auth & identity

Phone / email OTP, JWT access + rotating refresh tokens, sessions and linked-device management.

💬

Messaging

Direct & group chats, send / edit / delete, read receipts and cursor pagination.

⚡

Realtime

WebSocket fan-out for instant delivery, typing indicators and presence.

🖼️

Media

Signed-URL direct-to-storage uploads — large files never touch the API.

👤

Users & KYC

Profiles, public lookups and optional NID / passport verification.

🛡️

Gateway

Request-ids, idempotency keys, per-route rate limits and a unified error envelope.

Authentication

Passwordless, in two calls

Every request after sign-in carries a Bearer JWT. Codes are hashed with argon2 and never stored in plaintext.

// Base URL
https://neermela-api.onrender.com/v1

POST /v1/auth/otp/send   { channel, phone | email, purpose }
POST /v1/auth/otp/verify { challenge_id, code } → tokens
POST /v1/auth/refresh    { refresh_token }

// then, on every authed call:
Authorization: Bearer <access_token>
API Reference

Core endpoints

A stable, versioned surface. Full contract published as an OpenAPI 3.1 spec on GitHub.

POST/v1/auth/otp/sendsend a login code
POST/v1/auth/otp/verifyverify & get tokens
GET/v1/users/mecurrent profile
GET/v1/chatslist chats
POST/v1/chats/:id/messagessend a message
GET/v1/realtimewebsocket stream
POST/v1/media/upload-urlsigned upload URL

Response envelope: { "success": true, "data": { … }, "request_id": "REQ_…" }

Use cases

What you can build

Like a WhatsApp Business API — but yours, on NeerMela. Reach customers, automate replies and run communities.

🏢

Business messaging

Let businesses chat with customers, send updates and broadcasts through NeerMela.

🤖

Bots & automation

Auto-replies, order updates and support flows driven by your own backend.

🌐

Community platforms

Power groups, channels and communities inside your product.

📣

Notifications

Deliver OTPs, alerts and reminders over chat instead of costly SMS.

🎥

Calls in your app

Add voice & video between your users, backed by NeerMela realtime.

🧩

Integrations

Connect CRMs, storefronts and tools to a single messaging layer.

Quickstart

Your first message in minutes

# get your profile
curl https://neermela-api.onrender.com/v1/users/me \
  -H 'Authorization: Bearer <access_token>'

# send a message to a chat
curl -X POST …/v1/chats/CHAT_ID/messages \
  -H 'Authorization: Bearer <access_token>' \
  -d '{"type":"text","body":"Hello from NeerMela API"}'
REST · JSONJWT authWebSocket realtimeIdempotency keysRate limitsSDK · soonWebhooks · soonSandbox · soon
Get access

Build with the NeerMela API

The API is in early access. Tell us what you're building and we'll set you up with credentials and onboarding.

Request access (WhatsApp) ⭐ Explore on GitHub