Skip to content
View as Markdown
Enter your site to enable Send. Requests are sent from your browser, so the site must allow cross-origin calls (CORS).

GET Get Subscriber Message Logs​

GET
/messaging/subscribers/{id}/logs

Paginated message history of one contact on one channel, for the contact-profile SMS / WhatsApp tabs. It reads the contact's thread on the channel; a contact never messaged on that channel simply gets an empty list. Rows are sorted by the effective time (sent_at, else scheduled_at, else created_at) then ID, in order. A missing contact returns HTTP 422 with code: 404 in the body (the controller passes 404 inside the payload, not as the HTTP status). Replaces GET /sms/subscribers/{id}/logs. PRO (FluentCampaign Pro Messaging module).

Required capability: fcrm_read_emails or fcrm_manage_emails — which one applies depends on the action being performed.

Enforced by MessagePolicy::verifyRequest(), the policy default for this route group.

Requires: FluentCampaign Pro with the Messaging module enabled. While no messaging channel (SMS or WhatsApp) is switched on the route is not registered at all and returns a 404.

Authorizations​

ApplicationPasswords

WordPress Application Passwords — use Basic auth with your WordPress username and an application password in the format: username:application_password

Type
API Key (header: Authorization)

Parameters​

Path Parameters

id*

Subscriber (contact) ID.

Type
integer
Required

Query Parameters

channel

Channel to scope the request to. Unknown or missing values fall back to sms.

Type
string
Valid values
"sms""whatsapp"
Default
"sms"
filter

campaign or automation (by ref_type), incoming (inbound), or custom_sms (outbound with no campaign/automation ref). Any other value behaves like custom_sms; all disables filtering.

Type
string
Valid values
"all""campaign""automation""incoming""custom_sms"
Default
"all"
order

Sort direction. Anything other than desc sorts ascending.

Type
string
Valid values
"asc""desc"
Default
"asc"
page

Page number.

Type
integer
Default
1
per_page

Rows per page (not clamped).

Type
integer
Default
20

Responses​

Paginated message logs.

application/json
JSON
{
"logs": {
"data": [
{
"id": 0,
"thread_id": 0,
"direction": "string",
"content": "string",
"message": "string",
"ref_type": "string",
"ref_id": 0,
"status": "string",
"provider_message_id": "string",
"meta": {
"additionalProperties": "string"
},
"scheduled_at": "string",
"sent_at": "string",
"created_at": "string",
"updated_at": "string",
"from": "string",
"date": "string",
"time": "string",
"_date_time": "string",
"type": "string"
}
],
"total": 0,
"per_page": 0,
"current_page": 0,
"last_page": 0
}
}

Playground​

Authorization
Variables
Key
Value

Samples​

Powered by VitePress OpenAPI