API Reference

Complete reference for all Chatbase WhatsApp API endpoints

API Reference

Complete reference for the Chatbase WhatsApp Business API. All endpoints require authentication — see Authentication for details.

Base URL

https://chatbase.in/api/v1/whatsapp

All API requests should be made to this base URL. HTTPS is required.

Authentication

Every request must include a Bearer token:

Authorization: Bearer wpapi_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

Request Format

Content-Type: application/json for all POST/PUT requests
Accept: application/json
Phone numbers must be in E.164 format without the leading + (e.g. 919876543210)

Response Format

All responses are JSON. Successful responses include a success: true field. Errors include a message field explaining what went wrong.

// Success
{ "success": true, "message_id": "wamid.xxx", "status": "accepted" }

// Error
{ "success": false, "message": "Template not found or not approved" }

HTTP Status Codes

Code	Meaning
`200`	OK — request succeeded
`201`	Created — resource created
`400`	Bad Request — invalid parameters
`401`	Unauthorized — missing or invalid API key
`403`	Forbidden — feature not in plan, IP/route restriction
`404`	Not Found
`422`	Unprocessable Entity — validation error
`429`	Too Many Requests — rate limit exceeded
`500`	Internal Server Error

Rate Limits

Rate limits depend on your subscription plan. When exceeded, the API returns 429 Too Many Requests. Implement exponential back-off when retrying.

The current rate limit for your API client is included in the response to GET /me.

Endpoints

Method	Endpoint	Description
`GET`	/me	Account info
`GET`	/contacts	List contacts
`GET`	/contacts/search	Search contacts
`GET`	/templates	List approved templates
`GET`	/messages	List sent/received messages
`POST`	/messages/send	Send a message
`POST`	/messages/send/bulk	Send bulk messages
`POST`	/messages/send/authentication/utility	Send OTP/auth message
`GET`	/jobs/:jobId	Get bulk job status
`GET`	/conversations	List conversations
`GET`	/conversations/:phone/messages	Get conversation messages

SDKs & Libraries

Official SDKs are coming soon. For now, use any HTTP client with the examples from this documentation:

Node.js: axios, node-fetch, or native fetch
Python: requests or httpx
PHP: GuzzleHttp
Go: net/http

Next Steps

Send Message — All message types with full examples
Webhooks — Receive delivery receipts and inbound messages
Templates — Create and manage WhatsApp message templates