ChatofyDevelopers
REST APIMCP Server (AI)New
API KeysWebhooks
Chatofy API
/
Getting Started
API Resources
API v1.0 Live
Developer APIMessagesGet Conversations & Thread Memory

Get Conversations & Thread Memory

Retrieves customer conversation history, calculates 24-hour customer-service window eligibility, and provides delivery receipts for sent messages. Powers AI context memory and CRM thread views.

GET/api/v1/conversations

Note

When phone is provided, is_inside_24h_window indicates if you can send freeform text/media, or if a pre-approved Meta template is required.

Query Parameters

6 parameters
phonestring (query)required

Contact phone number (E.164) to fetch conversation messages and 24-hr window status

message_idstring (query)required

UUID or Meta message ID (wamid) to retrieve delivery status and receipts

conversation_idstring (query)required

Conversation UUID to fetch thread messages

statusstring (query)required

Filter conversations by status: OPEN, CLOSED, PENDING, SNOOZED

limitnumber (query)required

Number of records to return (1-100, default 20)

offsetnumber (query)required

Number of records to skip (default 0)

Response Payload

200 OKapplication/json
successbooleanrequired

Whether request succeeded

data.contactobjectoptional

Contact details when querying by phone or contact_id

data.is_inside_24h_windowbooleanoptional

True if customer messaged within 24 hours, permitting standard messages

data.window_expires_atdatetime|nulloptional

Timestamp when the 24-hour customer service window expires

data.messagesarrayoptional

List of inbound and outbound messages ordered newest first

data.messageobjectoptional

Single message delivery receipt when querying by message_id

Code Snippets & Examples

1curl -X GET "https://app.chatofy.in/api/v1/conversations?phone=+919876543210&limit=20" \
2 -H "Authorization: Bearer YOUR_API_KEY"

Was this endpoint guide helpful?

Previous Endpoint
Send Template (Body Variables Only)
Next Endpoint
Search Message Archive
© 2026 Chatofy Cloud Platform. All rights reserved.
1curl -X GET "https://app.chatofy.in/api/v1/conversations?phone=+919876543210&limit=20" \
2 -H "Authorization: Bearer YOUR_API_KEY"
200 OKapplication/json
1{
2 "success": true,
3 "data": {
4 "contact": {
5 "id": "c1111111-2222-3333-4444-555555555555",
6 "phone_number": "+919876543210",
7 "first_name": "Aarav",
8 "last_name": "Patel",
9 "attributes": {
10 "tier": "VIP"
11 }
12 },
13 "conversation_id": "conv-8888-9999-aaaa-bbbbccccdddd",
14 "is_inside_24h_window": true,
15 "last_inbound_at": "2026-10-26T10:00:00+05:30",
16 "window_expires_at": "2026-10-27T10:00:00+05:30",
17 "messages": [
18 {
19 "id": "m1111111-2222-3333-4444-555555555555",
20 "direction": "OUTBOUND",
21 "type": "TEXT",
22 "status": "DELIVERED",
23 "content": {
24 "text": "Hello Aarav, your order has been confirmed."
25 },
26 "meta_message_id": "wamid.HBgLMTIzNDU2...",
27 "created_at": "2026-10-26T10:05:00+05:30"
28 },
29 {
30 "id": "m2222222-3333-4444-5555-666666666666",
31 "direction": "INBOUND",
32 "type": "TEXT",
33 "status": "READ",
34 "content": {
35 "text": "Could you please confirm my delivery date?"
36 },
37 "meta_message_id": "wamid.HBgLODk3NjU0...",
38 "created_at": "2026-10-26T10:00:00+05:30"
39 }
40 ]
41 },
42 "message": "Conversation messages retrieved successfully",
43 "pagination": {
44 "total": 2,
45 "limit": 20,
46 "offset": 0
47 }
48}