ChatofyDevelopers
REST APIMCP Server (AI)New
API KeysWebhooks
Chatofy API
/
Getting Started
API Resources
API v1.0 Live
Developer APIMessagesSearch Message Archive

Search Message Archive

Searches full message content across active, resolved, and snoozed WhatsApp conversations with contextual snippets and contact metadata.

GET/api/v1/inbox/search-messages

Query Parameters

4 parameters
qstringrequired

Search query matching text, captions, templates, or interactive buttons (min 2 chars)

conversation_iduuidrequired

Optional filter to scope search to a single conversation

limitnumberrequired

Max messages to return (default: 20, max: 100)

offsetnumberrequired

Pagination offset (default: 0)

Response Payload

200 OKapplication/json
statusstring

"1" = Success, "0" = Failure.

messageobject

The response data payload.

Code Snippets & Examples

1curl -X GET "https://app.chatofy.in/api/v1/inbox/search-messages?q=invoice&limit=20" \
2 -H "Authorization: Bearer YOUR_API_KEY"

Was this endpoint guide helpful?

Previous Endpoint
Get Conversations & Thread Memory
Next Endpoint
Snooze Conversation
© 2026 Chatofy Cloud Platform. All rights reserved.
1curl -X GET "https://app.chatofy.in/api/v1/inbox/search-messages?q=invoice&limit=20" \
2 -H "Authorization: Bearer YOUR_API_KEY"
200 OKapplication/json
1{
2 "success": true,
3 "data": {
4 "messages": [
5 {
6 "id": "m1111111-2222-3333-4444-555555555555",
7 "conversation_id": "conv-8888-9999-aaaa-bbbbccccdddd",
8 "direction": "OUTBOUND",
9 "type": "TEXT",
10 "status": "DELIVERED",
11 "is_internal": false,
12 "snippet": "...Your invoice number INV-987654 is ready for payment...",
13 "content": {
14 "text": "Hello! Your invoice number INV-987654 is ready for payment."
15 },
16 "created_at": "2026-10-26T10:00:00+05:30",
17 "conversation": {
18 "id": "conv-8888-9999-aaaa-bbbbccccdddd",
19 "status": "OPEN",
20 "contact": {
21 "id": "c1111111-2222-3333-4444-555555555555",
22 "first_name": "Aarav",
23 "last_name": "Patel",
24 "phone_number": "+919876543210",
25 "display_name": "Aarav Patel"
26 }
27 }
28 }
29 ],
30 "pagination": {
31 "total": 1,
32 "limit": 20,
33 "offset": 0,
34 "has_more": false
35 },
36 "query": "invoice"
37 },
38 "message": "Messages retrieved successfully"
39}