Messaging

Search chats

Free-text search of the connected account's own inbox, matching participant names and message content. Served from chats and messages already retrieved, so it costs no platform call. A chat never retrieved cannot match; the response's coverage block says how complete that is.

get/v1/{account_id}/chats/search

Request

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

Path parameters

account_idstring required

The account ID (acc_...) whose inbox to search.

Query parameters

querystring required

Search term, matches participant names and message content. Minimum 3 characters.

limitinteger

Maximum chats to return per page (1-100, default 20). The server may walk a few internal pages to fill one page.

cursorstring

Pagination cursor from a previous response; decodable, wraps a zero-based item offset, pass it back verbatim.

Response

A page of chats matching the search term (participant names and/or message content), the next-page cursor, and how much of the stored inbox the search could see.

object'chat_list'

Response type discriminator.

cursorstring nullable

Opaque next-page cursor; null on the last page.

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.