API reference

Base: https://sms.001.com.mx/api/v1

Auth: Authorization: Bearer sk_... (API key) or Authorization: Bearer at_... (JWT access token).

All responses are JSON. Errors return { "error": "message" } with an appropriate HTTP status.

Send message

POST /api/v1/send

{
  "channel": "sms",
  "phoneNumbers": ["+15551234567"],
  "message": "Hello world",
  "mediaUrls": ["https://..."],
  "simNumber": 1,
  "priority": 0,
  "ttl": 300,
  "validUntil": "2026-01-01T00:00:00Z",
  "withDeliveryReport": true,
  "isEncrypted": false,
  "externalId": "your-idempotency-key",
  "deviceId": "cm..."
}

Response:

{
  "id": "cmxxx...",
  "state": "processing",
  "recipients": [{ "phoneNumber": "+15551234567", "state": "processing" }]
}

Query messages

GET /api/v1/messages?limit=50&cursor=cm...&direction=out&state=delivered
GET /api/v1/messages/{id}
GET /api/v1/inbox?deviceId=cm...

Conversations

GET  /api/conversations
GET  /api/conversations/{id}
GET  /api/conversations/{id}/messages
POST /api/conversations/{id}/send
POST /api/conversations/{id}/read

Devices

GET    /api/devices
POST   /api/devices/android       { "name": "..." }
POST   /api/devices/whatsapp      { "name": "..." }
GET    /api/devices/{id}/settings
PATCH  /api/devices/{id}/settings
GET    /api/devices/{id}/logs?level=error
DELETE /api/devices/{id}

Webhooks

GET    /api/webhooks
GET    /api/webhooks/events
POST   /api/webhooks
PATCH  /api/webhooks/{id}
DELETE /api/webhooks/{id}

Keys & tokens

POST   /api/keys
DELETE /api/keys/{id}

POST   /api/auth/token
POST   /api/auth/token/refresh

Billing / usage

GET /api/billing