Skip to main content
GET
/
v1
/
tasks
curl "https://api.v2.dealmachine.com/v1/tasks?status=open" \
  -H "Authorization: Bearer dm_sk_live_xxx"
{
  "data": [
    {
      "id": "task_001",
      "organization_id": 1,
      "opportunity_id": "42",
      "property_id": "prop_12345",
      "person_id": null,
      "created_by_user_id": 5,
      "assigned_to_user_id": 12,
      "assigned_to_agent_id": null,
      "title": "Schedule property walkthrough",
      "description": "Contact seller to arrange a visit",
      "is_completed": false,
      "completed_at": null,
      "completed_by_user_id": null,
      "due_date": "2026-03-10T00:00:00Z",
      "sort_order": 0,
      "created_at": "2026-03-01T09:00:00Z",
      "updated_at": "2026-03-01T09:00:00Z"
    },
    {
      "id": "task_002",
      "organization_id": 1,
      "opportunity_id": null,
      "property_id": null,
      "person_id": "per_67890",
      "created_by_user_id": 5,
      "assigned_to_user_id": null,
      "assigned_to_agent_id": null,
      "title": "Follow up with contact",
      "description": null,
      "is_completed": true,
      "completed_at": "2026-03-02T14:00:00Z",
      "completed_by_user_id": 5,
      "due_date": null,
      "sort_order": 1,
      "created_at": "2026-03-01T09:00:00Z",
      "updated_at": "2026-03-02T14:00:00Z"
    }
  ],
  "pagination": {
    "page": 1,
    "per_page": 25,
    "total": 2,
    "has_more": false
  }
}
Returns a paginated list of tasks. Optionally filter by status, assignee, or search by title.
page
integer
default:1
Page number.
per_page
integer
default:25
Results per page (1-100).
status
string
Filter by status: open, completed, or all (default).
Search tasks by title.
assigned_to_user_id
integer
Filter by assigned user ID.
curl "https://api.v2.dealmachine.com/v1/tasks?status=open" \
  -H "Authorization: Bearer dm_sk_live_xxx"
{
  "data": [
    {
      "id": "task_001",
      "organization_id": 1,
      "opportunity_id": "42",
      "property_id": "prop_12345",
      "person_id": null,
      "created_by_user_id": 5,
      "assigned_to_user_id": 12,
      "assigned_to_agent_id": null,
      "title": "Schedule property walkthrough",
      "description": "Contact seller to arrange a visit",
      "is_completed": false,
      "completed_at": null,
      "completed_by_user_id": null,
      "due_date": "2026-03-10T00:00:00Z",
      "sort_order": 0,
      "created_at": "2026-03-01T09:00:00Z",
      "updated_at": "2026-03-01T09:00:00Z"
    },
    {
      "id": "task_002",
      "organization_id": 1,
      "opportunity_id": null,
      "property_id": null,
      "person_id": "per_67890",
      "created_by_user_id": 5,
      "assigned_to_user_id": null,
      "assigned_to_agent_id": null,
      "title": "Follow up with contact",
      "description": null,
      "is_completed": true,
      "completed_at": "2026-03-02T14:00:00Z",
      "completed_by_user_id": 5,
      "due_date": null,
      "sort_order": 1,
      "created_at": "2026-03-01T09:00:00Z",
      "updated_at": "2026-03-02T14:00:00Z"
    }
  ],
  "pagination": {
    "page": 1,
    "per_page": 25,
    "total": 2,
    "has_more": false
  }
}

Response Fields

FieldTypeDescription
idstringTask ID
organization_idnumberOrganization ID
opportunity_idstring | nullLinked CRM opportunity ID
property_idstring | nullLinked property ID
person_idstring | nullLinked person ID
created_by_user_idnumberUser who created the task
assigned_to_user_idnumber | nullAssigned user
assigned_to_agent_idstring | nullAssigned agent
titlestringTask title
descriptionstring | nullTask description
is_completedbooleanWhether the task is complete
completed_atstring | nullISO 8601 completion timestamp
completed_by_user_idnumber | nullUser who completed the task
due_datestring | nullISO 8601 due date
sort_ordernumberDisplay order
created_atstringISO 8601 creation timestamp
updated_atstringISO 8601 last update timestamp