Messaging

List chats

Returns a paginated list of chats for a connected account. Use inbox to select which inbox (primary by default), and filter by unread status, type, or date range.

get/v1/{account_id}/chats

Request

  • Base URL: https://api.curviate.com
  • URL: https://api.curviate.com/v1/{account_id}/chats
  • Auth: HTTP bearer

Path parameters

account_idstring required

The account ID (acc_...) whose chats to list.

Query parameters

inbox'primary' | 'inmail' | 'archived' | 'spam' | 'jobs' | 'starred'

Which inbox to list chats from. Defaults to the primary inbox.

unreadboolean

Filter chats by read status. true returns unread-only; false returns read-only; omit to return all.

type'1to1' | 'group' | 'channel'

Filter chats by conversation type.

beforestring

ISO-8601 UTC datetime (exclusive upper bound). Only entries before this time are returned.

afterstring

ISO-8601 UTC datetime (exclusive lower bound). Only entries after this time are returned.

limitinteger

Number of items to return per page (1-25, default 20).

cursorstring

An opaque cursor for pagination. Pass the cursor from the preceding response to fetch the next page.

expandstring

Extra fields to resolve, comma-separated in one value (expand=public_identifier). Present on every result as a value or null; repeating the key drops values.

Response

A page of chats for the account, plus the next-page cursor.

object'chat_list'

Response type discriminator.

cursorstring nullable

Next-page cursor; follow until items is empty (presence is not a has-more guarantee).

Example response

{
  "safety_warning": {
    "row": "profile_views",
    "reset_at": "2026-09-05T00:00:00.000Z",
    "hint": {
      "parameter": "profile_views.ceiling",
      "message": "This account is at its ceiling for profile_views. This action went through because profile_views.posture is warn, and it counted: 101 of 100 this window. Raise profile_views.ceiling, or wait for the window to reset at 2026-09-05T00:00:00.000Z."
    },
    "reason": "ceiling",
    "blocked": false
  }
}

Changes

No recorded changes to this operation across all 1 revision of this API.