List Chats

get

https://api.lodgestory.com/api/wp-crm/chats/{organisationId}

List your organisation's chats (most recently active first). Returns the full org inbox — contact, channel, status, assignees, teams, labels and last message for each chat.

Optional filters: status (open/resolved), channelIds, assignedToUserIds, assignedToTeamIds, unassigned, unanswered, priority, archived, labelIds, search (chat name + contact name/phone), updatedAfter/updatedBefore, plus sortBy/sortOrder/limit/offset. Paginate with offset; hasMore indicates another page exists.

Requires CRM_ADMIN, ACCOUNT_OWNER, or CRM_BOT.

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Path Params

organisationId

string

required

Your organisation UUID (returned as org from the /token endpoint).

Query Params

status

string

enum

Conversation status. open = not yet resolved (default), resolved = closed/resolved.

Allowed:

channelIds

array of strings

Filter to one or more channels (channel UUIDs from GET /channels). Comma-separated or repeated.

channelIds

assignedToUserIds

array of strings

Filter to chats assigned to any of these user UUIDs (from GET /directory/{org}/users). Comma-separated or repeated. Mutually exclusive with unassigned=true.

assignedToUserIds

assignedToTeamIds

array of strings

Filter to chats assigned to any of these team UUIDs (from GET /directory/{org}/teams). Comma-separated or repeated.

assignedToTeamIds

unassigned

boolean

Filter to chats with NO assignees at all. Cannot be combined with assignedToUserIds.

unanswered

boolean

Filter to chats whose last message is from the customer (i.e. awaiting your reply).

priority

boolean

Filter to high-priority chats only.

archived

boolean

Include archived chats. Omitted/false = exclude archived (default); true = ONLY archived.

labelIds

array of strings

Filter to chats carrying any of these label UUIDs. Comma-separated or repeated.

labelIds

string

Case-insensitive search across the chat name and the attached contact name / phone number.

updatedAfter

string

Only chats updated at/after this time (ISO 8601).

updatedBefore

string

Only chats updated at/before this time (ISO 8601).

sortBy

string

enum

Sort field. updatedAt = last activity (default), name = chat name.

Allowed:

sortOrder

string

enum

Allowed:

limit

number

Page size (1-100, default 50).

offset

number

Offset (default 0).

Responses

401

Unauthorized — invalid/expired token or wrong organisation

403

Forbidden — role not permitted

429

Too many requests

200