API Overview
Base URL
Sandbox (current public host):
https://api.morisbox.com/api/v1
All endpoints are under /api/v1 unless otherwise stated.
| Environment | Base URL |
|---|
| Sandbox | https://api.morisbox.com/api/v1 |
| Local Docker | http://127.0.0.1:11300/api/v1 |
Conventions
| Topic | Rule |
|---|
| Format | JSON request / JSON response |
| Authentication | Authorization: Bearer <api_key> |
| Phone numbers | E.164 (+228XXXXXXXX) |
| Dates | ISO-8601 strings |
| Errors | { "error": { "code", "message" } } |
| Successful creation | Usually 201 |
Two API surfaces
| Surface | Key | Audience | Documentation |
|---|
| Partner API | sk_… | Partner organizations | This site (Messages, Bots, and more) |
| Developer API | sk_dev_… | Independent developers | docs.morisbox.com/developers |
Resource groups (partners)
Resource groups (developers)
Partner example: list messages
GET /api/v1/messages?phone=%2B228XXXXXXXX&limit=20
Authorization: Bearer sk_…
Developer example: send with a template
POST /api/v1/dev/messages
Authorization: Bearer sk_dev_…
Content-Type: application/json
{
"phone": "+228XXXXXXXX",
"template_code": "notification",
"lang": "fr",
"vars": { "text": "Bonjour" }
}
Rate limits
Per-key limits may apply. When throttled, the API returns 429 with a retry hint. Partners should prefer broadcasts for high-volume delivery.
Versioning
The current public version is v1. Breaking changes will use a new prefix (/api/v2) or a documented deprecation window.
