Messages

View message history for your organization.

List messages

GET /v1/messages

Retrieve a paginated list of messages (SMS, email, etc.).

Required scope: messages:read

Query parameters

Parameter	Type	Description
page	integer	Page number (default: 1)
limit	integer	Results per page (default: 20, max: 100)
channel	string	Filter by channel: sms, email, whatsapp

Example

curl "https://api.replicer.ai/v1/messages?channel=sms&limit=10" \
  -H "Authorization: Bearer rpl_live_your_key"

Response 200 OK

{
  "data": [
    {
      "id": "clx-msg-001",
      "channel": "sms",
      "direction": "OUTBOUND",
      "status": "delivered",
      "fromAddress": "+0987654321",
      "toAddress": "+1234567890",
      "subject": null,
      "body": "Hi John, confirming your appointment tomorrow at 2 PM.",
      "externalId": "ext-sms-abc",
      "errorMessage": null,
      "createdAt": "2026-04-05T10:00:00Z"
    }
  ],
  "pagination": {
    "page": 1,
    "limit": 10,
    "total": 30,
    "totalPages": 3
  },
  "requestId": "req-abc123"
}

Message fields

Field	Type	Description
id	string	Unique message ID
channel	string	Delivery channel (sms, email, whatsapp)
direction	string	INBOUND or OUTBOUND
status	string	Delivery status
fromAddress	string	Sender address/number
toAddress	string	Recipient address/number
subject	string | null	Email subject (null for SMS)
body	string	Message content
externalId	string | null	External provider message ID
errorMessage	string | null	Error details if delivery failed
createdAt	string	ISO 8601 timestamp

---

Send SMS

POST /v1/messages/sms

Coming soon

This endpoint is planned but not yet available. It currently returns 503 Not Implemented.

Required scope: messages:write

A dedicated Go messaging worker is being developed. Once available, this endpoint will allow you to send SMS messages programmatically.