---
title: "List tasks"
method: GET
path: "/v1/platform/businesses/{business_id}/tasks/"
tags: ["Task Management"]
---

# List tasks

`GET /v1/platform/businesses/{business_id}/tasks/`

## Request

- Base URL: `https://docs.thredfi.com` (the document declares no server; this is the origin it was published from)
- URL: `https://docs.thredfi.com/v1/platform/businesses/{business_id}/tasks/`
- Auth: one of:
  - HTTP bearer
  - HTTP basic
  - HTTP bearer
  - HTTP bearer

List all tasks for a business with filtering and search

## Path parameters

- `business_id` string, required

## Query parameters

- `accounting_period` string, uuid
- `created_after` string, date-time
- `created_before` string, date-time
- `created_by` string, uuid
- `due_date_after` string, date
- `due_date_before` string, date
- `month` integer
- `ordering` string
- `page` integer
- `page_size` integer
- `search` string
- `status` string[]
- `year` integer

## Response `200`

- PaginatedTaskList
  - `count` integer, required: Total number of items
  - `page_info` object, required
    - `total_count` integer, required: Total number of items (same as count)
    - `current_page` integer, required: Current page number (1-indexed)
    - `total_pages` integer, required: Total number of pages
    - `page_size` integer, required: Number of items per page
  - `results` Task[], required
    - `id` string, uuid, required
    - `title` string, required: Short title describing the task. Example: 'Missing receipt for Office Depot'
    - `description` string, required: Detailed description or question from the bookkeeper. Example: 'Please provide the receipt for €250 charge on Jan 6, 2025.'
    - `status` 'pending_response' | 'in_review' | 'closed', required: Current task status: pending_response (waiting for owner), in_review (bookkeeper reviewing), closed (completed) * `pending_response` - Pending Response * `in_review` - In Review * `closed` - Closed
    - `rejection_reason` string, required: Reason provided when bookkeeper rejected the last submission. Empty if not rejected. Example: 'Document is blurry, please upload clearer image.'
    - `accounting_period` string, uuid, nullable: Associated accounting period for monthly grouping
    - `accounting_period_name` string, required: Name of the accounting period. Example: '2025-01'
    - `created_by` string, uuid, nullable
    - `created_by_name` string, required: Display name of the bookkeeper who created this task
    - `closed_at` string, date-time, nullable, required
    - `closed_by` string, uuid, nullable
    - `closed_by_name` string, required: Display name of the bookkeeper who closed this task
    - `due_date` string, date, nullable: Optional due date for task completion. Format: YYYY-MM-DD. Example: '2025-01-15'
    - `message_count` integer, required: Total number of messages in this task thread
    - `question_count` integer, required: Number of questions from bookkeeper
    - `answer_count` integer, required: Number of answers from business owner
    - `document_count` integer, required: Total documents attached across all messages
    - `is_overdue` boolean, required: True if task has passed its due_date and is not closed
    - `has_unanswered_questions` boolean, required: True if there are more questions than answers
    - `has_submission` boolean, required: True if there is a current (non-rejected) submission from the owner
    - `current_submission` object, required: Summary of the current active submission, or null if none exists
    - `related_entity_type` string, required: Type of linked entity: 'banktransaction', 'invoice', 'bill', or null
    - `related_entity_details` object, required: Summary details of the linked entity (amount, date, counterparty, etc.)
    - `metadata` unknown
    - `created_at` string, date-time, required
    - `updated_at` string, date-time, required

---

[API](https://skmtc.dev/thredfi/apis/thredfi-accounting-platform-api.md) - [All operations](https://skmtc.dev/thredfi/apis/thredfi-accounting-platform-api/llms.txt) - [OpenAPI document](https://skmtc.dev/thredfi/apis/thredfi-accounting-platform-api/revisions/0c1918254db3?raw)