Ricky logorickyDocs

Search messages

GET
/messages/search

Messages of every conversation that contain the words, newest first. Answers one page of at most limit; next_cursor is always null.

Scope: conversations:read.

Authorization

bearerAuth
headerAuthorizationBearer <token>

An organization API key, rky_live_…, created in Settings → API. Send it only from a server.

Query Parameters

query*string

Words in the message text, or text in what Ricky derived from a voice note or file.

Length1 <= length <= 200
limit?integer

Most results to return.

Range1 <= value <= 30
Default10

Response Body

Success.

application/json
  1. response
data*array<>
next_cursor*|

Pass as cursor for the next page; null on the last page.

curl -X GET 'https://getricky.ai/api/v1/messages/search?query=string'
{  "data": [    {      "message_id": "c41d7e2a-5b6f-4a89-8c3d-0e1f2a3b4c5d",      "conversation_id": "9b2e4c61-7a3f-4d18-b5c2-6e0f1a2b3c4d",      "direction": "inbound",      "type": "text",      "text": "¿Ya están mis lentes?",      "contact": {        "name": "Ana Pérez",        "external_id": "50760001234"      },      "agent_name": null,      "messaged_at": "2026-10-14T15:30:00.000Z"    }  ],  "next_cursor": "string"}