Retrieve Task

Retrieve the full details of a specific task, including its board, status, folder, assigned clients, tags, and checklists summary.

Example Request:

curl "https://<your-agency>.smartmatchapp.com/api3/tasks/<task_id>/" \
    -u <token>: \
    -X GET

Example Success Response:

{
    "id": 42,
    "title": "Follow up with client",
    "description": "<p>Call the client to discuss the proposal.</p>",
    "is_archived": false,
    "is_template": false,
    "priority": 2,
    "due_date": "2026-03-15",
    "created": "2026-02-20T10:30:00",
    "user_assigned_id": 5,
    "user_created_id": 3,
    "board": {
        "id": 1,
        "name": "Sales Pipeline"
    },
    "status": {
        "id": 2,
        "name": "In Progress"
    },
    "folder": {
        "id": 3,
        "name": "Q1 Tasks"
    },
    "clients": [
        {
            "id": 101,
            "name": "Jane Doe"
        }
    ],
    "tags": [
        {
            "id": 7,
            "name": "Urgent"
        }
    ],
    "checklists": [
        {
            "id": 1,
            "title": "Pre-call checklist",
            "total": 3,
            "done": 1
        }
    ]
}

Fields board, status, and folder will be null if not set. The clients, tags, and checklists arrays will be empty if none are associated.

Base Request:

Rate Limits:

Error Responses: