ChatofyDevelopers
REST APIMCP Server (AI)New
API KeysWebhooks
Chatofy API
/
Getting Started
API Resources
API v1.0 Live
Developer APIContactsGet Contact Activity Timeline

Get Contact Activity Timeline

Retrieves the complete historical activity timeline for a contact, including messages, task completions, stage movements, and notes.

GET/api/v1/contacts/{id}/timeline

Query Parameters

4 parameters
{id}uuidrequired

Contact UUID

typestringrequired

Optional filter by activity type (e.g. task_created, task_completed, message_sent, stage_changed)

limitnumberrequired

Max items per page (default: 50, max: 100)

offsetnumberrequired

Offset index (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/contacts/c1111111-2222-3333-4444-555555555555/timeline" \
2 -H "Authorization: Bearer YOUR_API_KEY"

Was this endpoint guide helpful?

Previous Endpoint
Commit CSV Import
Next Endpoint
Search Contacts (Typo-Tolerant)
© 2026 Chatofy Cloud Platform. All rights reserved.
1curl -X GET "https://app.chatofy.in/api/v1/contacts/c1111111-2222-3333-4444-555555555555/timeline" \
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 "display_name": "Aarav Sharma",
8 "first_name": "Aarav",
9 "last_name": "Sharma",
10 "lifecycle": "lead"
11 },
12 "activities": [
13 {
14 "id": "act-001",
15 "type": "task_completed",
16 "title": "Task completed: Product Demo Call",
17 "description": "Task completed at 2026-10-26T22:30:00+05:30",
18 "metadata": {
19 "task_id": "tsk-001",
20 "type": "demo"
21 },
22 "created_at": "2026-10-26T22:30:00+05:30"
23 },
24 {
25 "id": "act-002",
26 "type": "task_created",
27 "title": "Task scheduled: Product Demo Call",
28 "description": "Task type: demo, due: 2026-10-26T22:30:00+05:30",
29 "metadata": {
30 "task_id": "tsk-001",
31 "type": "demo"
32 },
33 "created_at": "2026-10-26T10:00:00+05:30"
34 }
35 ]
36 },
37 "message": "Contact timeline retrieved successfully",
38 "pagination": {
39 "total": 2,
40 "limit": 50,
41 "offset": 0
42 }
43}