List inbox conversations
Returns the unified DM inbox thread list for your account, ordered waiting-first (fans awaiting a reply rise to the top, longest wait first, then the rest by most-recent activity). Requires a read-scoped key.
Authorization
bearerAuth Your al_live_<prefix>_<secret> API key. Mint and manage keys in the dashboard.
In: header
Query Parameters
Filter to conversations in this status. Omit for all.
Value in
- "open"
- "closed"
- "snoozed"
Filter to conversations assigned to this operator id.
Maximum number of conversations to return.
1 <= value <= 1000200Response Body
application/json
application/json
curl -X GET "https://example.com/api/admin/inbox/conversations"{ "conversations": [ { "fan_id": "fan_8841920", "of_account_id": "acct_92f1", "platform": "of", "last_msg_ts": 1719763200, "last_inbound_ts": 1719763200, "last_outbound_ts": 1719759000, "unread_count": 2, "assigned_operator_id": 7, "status": "open", "waiting_seconds": 5400 }, { "fan_id": "fan_2210045", "of_account_id": "acct_92f1", "platform": "of", "last_msg_ts": 1719760400, "last_inbound_ts": 1719750000, "last_outbound_ts": 1719760400, "unread_count": 0, "assigned_operator_id": null, "status": "open", "waiting_seconds": 0 } ], "count": 2}{ "detail": "Not authenticated"}One fan's spender detail
Returns one paying fan's detail card: identity, country/source, lifetime net/gross, tracking period, per-day net series, RFM/lifecycle profile, and the transactions list. Requires a read-scoped key.
Read a conversation thread
Reads the live message thread for one fan, normalized to a stable shape. Message bodies are not stored on our side; they are re-read live at request time. If the underlying read fails the response degrades to an empty list with error=true instead of failing. Requires a read-scoped key.