# List Task Statuses

`lawmatics_list-task-statuses` · Lawmatics MCP tool · Task Statuses

List task statuses from Lawmatics with optional pagination and sorting.

## Input

- **page** `integer` (> 0) — Page number (1-based)
- **sortBy** `string` (enum: "id", "created_at", "updated_at", "name") — Column to sort by
- **sortOrder** `string` (enum: "asc", "desc") — Sort direction; ascending or descending

## Output

- **taskStatuses** `array` (required) — Task statuses on this page of results
  - **[]** `object`
    - **id** `string` (required) — Lawmatics task status ID
    - **name** `string` (required) — Task status name (e.g. Waiting for Client, In Progress)
    - **color** `string` (required) — Hex color code for the status, e.g. #A7783B
    - **createdAt** `string` (required) — When the task status was created, as an ISO 8601 timestamp
    - **updatedAt** `string` (required) — When the task status was last updated, as an ISO 8601 timestamp
- **pagination** `object | null` (required) — Pagination metadata from the API response; null when the endpoint returns no meta envelope
  - **totalPages** `number | null` (required) — Total number of pages available; null if not reported
  - **limitPerPage** `number | null` (required) — Maximum task statuses returned per page; null if not reported
  - **totalEntries** `number | null` (required) — Total number of task statuses across all pages; null if not reported