List Tasks

Retrieve a paginated list of tasks, with optional filtering by board, status, assigned user, archive state, template flag, and tag.

Example Requests:

List all tasks:

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

Filter by board and status:

curl "https://<your-agency>.smartmatchapp.com/api3/tasks/?board_id=1&status_id=2" \
    -u <token>: \
    -X GET

List active tasks with pagination:

curl "https://<your-agency>.smartmatchapp.com/api3/tasks/?is_archived=false&count=50&offset=0" \
    -u <token>: \
    -X GET

Filter by tag:

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

Request Parameters:

Example Success Response:

{
    "count": 20,
    "offset": 0,
    "total_count": 2,
    "objects": [
        {
            "id": 42,
            "title": "Follow up with client",
            "is_archived": false,
            "is_template": false,
            "priority": 2,
            "due_date": "2026-03-15",
            "user_assigned_id": 5,
            "board_id": 1,
            "status_new_id": 2,
            "folder_id": null
        },
        {
            "id": 41,
            "title": "Send contract",
            "is_archived": false,
            "is_template": false,
            "priority": 3,
            "due_date": null,
            "user_assigned_id": null,
            "board_id": 1,
            "status_new_id": 1,
            "folder_id": 3
        }
    ]
}

Base Request:

Rate Limits:

Error Responses: