---
title: "List your open tasks"
method: GET
path: "/tasks"
tags: ["Tasks"]
---

# List your open tasks

`GET /tasks`

Returns a paginated, account-wide list of every task (action-item) your account currently has — across ALL cases, not just one. Use GET /cases/{id}/tasks instead to scope this to a single case.

**What is a task?**
A task is something the platform needs YOU to do before a case can proceed — e.g. reply to a chat message, sign a contract, or assign a bank account for payouts. Tasks auto-resolve when the underlying condition clears (for example, once you reply to the case's chat, the ReplyToChat task disappears on its own) — this is a live work queue, not an append-only log. Poll it, don't assume a task you've seen before is still open.

**Every task has a solutionUrl** — an absolute link, identical to the one used inside the Creditor app itself, that a human can open to resolve the task in one click, no matter the task type.

**Some tasks also have an `action`** — a machine-readable hint pointing at the exact existing API call that resolves the task directly, with no human required. Today that's the chat-driven cluster (ReplyToChat, ClientInputRequired, MoreInfoNeeded) — post a message via POST /cases/{caseId}/chats and the task resolves itself once the case leaves its needs-info state. Tasks without an action are `action: null` — resolve those via solutionUrl.

**Filtering:**
- status (default: Open) — Open or Solved
- type (repeatable, e.g. ?type=ReplyToChat&type=SignContract) — restrict to specific task types

**Pagination:**
- Page (default: 1), PageSize (default: 10, max: 100)

## Query parameters

- `status` string
- `type` string[]
- `Page` integer
- `PageSize` integer

## Response `200`

Tasks returned

- DebituraWebExternalApiContractsV1TasksTaskListDto — Paged list of tasks, returned by `GET /tasks`.
  - `page` DebituraDomainModelBasePageData, required
    - `totalResults` integer
    - `pageSize` integer
    - `currentPage` integer
    - `responseCount` integer
    - `totalPages` integer
  - `tasks` DebituraWebExternalApiContractsV1TasksTaskDto[], nullable
    - `id` string, uuid — The task's unique ID.
    - `type` string, nullable — Stable string code for the task type (e.g. `"ReplyToChat"`). This is the public, additive-safe contract — it does NOT track the internal integer enum used in storage.
    - `typeLabel` string, nullable — Human-readable label for Debitura.Web.ExternalApi.Contracts.V1.Tasks.TaskDto.Type (e.g. "Reply to chat").
    - `title` string, nullable — Short task title, as shown in the Creditor app.
    - `description` string, nullable — Optional longer description of what the task requires.
    - `status` string, nullable — Either `"Open"` or `"Solved"`.
    - `caseId` string, uuid, nullable — The case (collection case / invoice) this task belongs to, when applicable. Null for account-level tasks not tied to a single case (e.g. SignContract, AssignBankAccount).
    - `caseReference` string, nullable — Your reference for Debitura.Web.ExternalApi.Contracts.V1.Tasks.TaskDto.CaseId, if any.
    - `leadId` string, uuid, nullable — The lead this task belongs to (e.g. SelectQuoteWinner), if applicable.
    - `deadline` string, date-time, nullable — When this task is due, if a deadline is set.
    - `dateCreated` string, date-time — When the task was created.
    - `dateSolved` string, date-time, nullable — When the task was resolved, if it has been.
    - `solutionUrl` string, nullable — Absolute URL — identical to the one the Creditor app itself links to — where a human can resolve this task. Always present, regardless of whether Debitura.Web.ExternalApi.Contracts.V1.Tasks.TaskDto.Action is populated.
    - `action` DebituraWebExternalApiContractsV1TasksTaskActionDto — A machine-readable hint pointing at the existing API call that resolves a task, e.g. `{ "method": "POST", "path": "/cases/{caseId}/chats" }` for a chat-driven task. Path uses the same `{param}` placeholder style as this API's own documented routes — substitute in the real IDs before calling.
      - `method` string, nullable — HTTP method to use, e.g. `"POST"`.
      - `path` string, nullable — Path template for the resolving call, e.g. `"/cases/{caseId}/chats"`. Relative to the API's base URL.

## Other responses

- `400` — Invalid status, type, or pagination parameters

---

[API](https://skmtc.net/debitura/apis/debitura-customer-api.md) · [All operations](https://skmtc.net/debitura/apis/debitura-customer-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/debitura/debitura-customer-api/versions/46478f2e476f/schema)