ChatofyDevelopers
REST APIMCP Server (AI)New
API KeysWebhooks
Chatofy API
/
Getting Started
API Resources
API v1.0 Live
Developer APITasks & Follow-upsList Tasks

List Tasks

Lists scheduled CRM tasks and follow-ups with contact and deal details, overdue status, and derived replied_since_last_followup flag.

GET/api/v1/tasks

Query Parameters

8 parameters
statusstringrequired

Filter: open, done, or cancelled.

owner_iduuid|stringrequired

Filter by owner UUID, or "unassigned".

contact_iduuidrequired

Filter by associated contact UUID.

deal_iduuidrequired

Filter by associated deal UUID.

overduebooleanrequired

If true, returns only overdue open tasks.

due_beforedatetimerequired

Filter tasks due on or before timestamp.

limitnumberrequired

Max 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/tasks?status=open&overdue=true" \
2 -H "Authorization: Bearer YOUR_API_KEY"

Was this endpoint guide helpful?

Previous Endpoint
Export Deals (CSV / JSON)
Next Endpoint
Create Task
© 2026 Chatofy Cloud Platform. All rights reserved.
1curl -X GET "https://app.chatofy.in/api/v1/tasks?status=open&overdue=true" \
2 -H "Authorization: Bearer YOUR_API_KEY"
200 OKapplication/json
1{
2 "success": true,
3 "data": [
4 {
5 "id": "tsk-001",
6 "organization_id": "org-uuid-001",
7 "contact_id": "c1111111-2222-3333-4444-555555555555",
8 "deal_id": "d1111111-2222-3333-4444-555555555555",
9 "owner_id": "u1111111-2222-3333-4444-555555555555",
10 "type": "call",
11 "title": "Product Demo Call",
12 "due_at": "2026-10-27T11:00:00+05:30",
13 "completed_at": null,
14 "snoozed_until": null,
15 "status": "open",
16 "is_overdue": false,
17 "replied_since_last_followup": true,
18 "contact": {
19 "id": "c1111111-2222-3333-4444-555555555555",
20 "phone_number": "919876543210",
21 "display_name": "Aarav Sharma"
22 },
23 "deal": {
24 "id": "d1111111-2222-3333-4444-555555555555",
25 "title": "Enterprise Onboarding",
26 "value": 120000,
27 "status": "open"
28 },
29 "created_at": "2026-10-26T10:00:00+05:30",
30 "updated_at": "2026-10-26T10:00:00+05:30"
31 }
32 ],
33 "message": "Tasks retrieved successfully",
34 "pagination": {
35 "total": 1,
36 "limit": 50,
37 "offset": 0
38 }
39}