Returns a paginated list of all messages — both outbound (sent by your platform) and inbound (replies from users) — logged for your workspace. This is the primary way to inspect message history, build reporting, and audit delivery.
Request
Number of messages to return. Maximum 200.
Number of messages to skip. Use with limit to paginate.
Filter by message direction.| Value | Description |
|---|
OUTBOUND | Messages sent by your platform to a user |
INBOUND | Messages sent by a user to your platform (RCS replies, inbound SMS) |
Filter by current delivery status.| Value | Meaning |
|---|
QUEUED | Accepted, not yet dispatched |
SENT | Dispatched to the carrier / network |
DELIVERED | Confirmed on the recipient’s device |
READ | User opened the message |
CLICKED | Link in the message was clicked (email) |
BOUNCED | Hard or soft bounce (email) |
FAILED | Permanent delivery failure |
UNSUBSCRIBED | One-click unsubscribe processed (email) |
Filter to a specific channel (ch_ prefixed ID). See Identifiers. Filter to messages for a specific contact.
Filter to messages sent as part of a specific campaign.
Filter by message type: MESSAGE, CONVERSATION, or NEWSLETTER.
ISO 8601 start of the date range (inclusive). Example: 2026-03-01T00:00:00Z.
ISO 8601 end of the date range (inclusive). Example: 2026-03-31T23:59:59Z.
Response
{
"messages": [
{
"id": "msg_a1b2c3d4",
"direction": "OUTBOUND",
"channel_id": "ch_rcs_xxxx",
"contact_id": "c_a1b2c3d4",
"campaign_id": null,
"message_type": "MESSAGE",
"content_type": "INTERACTIVE",
"status": "DELIVERED",
"cost": "0.0800",
"sent_at": "2026-03-28T09:00:01Z",
"delivered_at": "2026-03-28T09:00:04Z",
"read_at": "2026-03-28T09:03:22Z",
"created_at": "2026-03-28T09:00:00Z"
},
{
"id": "msg_b2c3d4e5",
"direction": "INBOUND",
"channel_id": "ch_rcs_xxxx",
"contact_id": "c_a1b2c3d4",
"campaign_id": null,
"message_type": "CONVERSATION",
"content_type": "TEXT",
"status": "DELIVERED",
"cost": null,
"sent_at": "2026-03-28T09:05:10Z",
"delivered_at": "2026-03-28T09:05:10Z",
"read_at": null,
"created_at": "2026-03-28T09:05:10Z"
}
],
"total": 4821,
"limit": 50,
"offset": 0
}
Message ID. Use with GET /v1/messages/{id} to fetch the full content and delivery timeline.
OUTBOUND for sends you initiated; INBOUND for user replies and incoming SMS.
Shape of the message content: TEXT, TEMPLATE, MEDIA, or INTERACTIVE (rich card / carousel).
Settled cost in EUR as a decimal string (e.g. "0.0800"). null for inbound messages (not billed). Returned as a string to preserve decimal precision — unlike the numeric hold_amount / message_price fields in the send response.
Timestamp the user read the message. null if no read receipt was received.
Total matching messages across all pages.
Returned when a filter value is not valid.{ "error": "validation_error", "message": "'status' must be one of: QUEUED, SENT, DELIVERED, READ, CLICKED, BOUNCED, FAILED, UNSUBSCRIBED" }
Examples
List all inbound messages (user replies) from the last 7 days:
curl "https://api.arowana.app/v1/messages?direction=INBOUND&from=2026-03-21T00:00:00Z" \
-H "Authorization: Bearer $API_KEY"
curl "https://api.arowana.app/v1/messages?status=FAILED&channel_id=ch_rcs_xxxx&limit=100" \
-H "Authorization: Bearer $API_KEY"
curl "https://api.arowana.app/v1/messages?contact_id=c_a1b2c3d4" \
-H "Authorization: Bearer $API_KEY"
# Page 1
curl "https://api.arowana.app/v1/messages?campaign_id=550e8400-e29b-41d4-a716-446655440004&direction=OUTBOUND&limit=200&offset=0" \
-H "Authorization: Bearer $API_KEY"
# Page 2
curl "https://api.arowana.app/v1/messages?campaign_id=550e8400-e29b-41d4-a716-446655440004&direction=OUTBOUND&limit=200&offset=200" \
-H "Authorization: Bearer $API_KEY"
To retrieve the full message content and the step-by-step delivery timeline for a single message, use GET /v1/messages/{id}. 
