---
title: "GET /tasks"
method: GET
path: "/tasks"
tags: ["tasks"]
---

# GET /tasks

`GET /tasks`

List and search tasks.

## Query parameters

- `page` integer
- `per_page` integer
- `finishedDateGt` string, date-time
- `finishedDateLt` string, date-time
- `dueDateGt` string, date-time
- `dueDateLt` string, date-time
- `updatedDateGt` string, date-time
- `updatedDateLt` string, date-time
- `createdDateGt` string, date-time
- `createdDateLt` string, date-time
- `metricId` integer
- `finishedEq` 'true' | 'false'

## Response `200`

OK

- object
  - `data` TaskEntity[]
    - `id` integer — Task ID.
    - `accountId` integer — Account ID.
    - `user` object — User that created this task.
      - `accountId` integer — Account ID.
      - `id` integer — User ID.
      - `name` string — User name.
    - `text` string — Text content.
    - `organization` object — Related organization.
      - `id` string — Organization ID.
      - `name` string — Display name (Nome fantasia).
      - `email` string — Contact email.
    - `person` object — Related person.
      - `id` integer — Person ID.
      - `name` string — Person name.
      - `email` string, email — Email address.
    - `deal` object — Related deal.
      - `id` string
      - `title` string
    - `dueDate` unknown
    - `finishedAt` unknown
    - `finishedBy` object — User who finished this task.
      - `accountId` integer — Account ID.
      - `id` integer — User ID.
      - `name` string — User name.
    - `createdAt` unknown
    - `updatedAt` unknown
    - `assignedUsers` LeanUserEntity[] — Users assigned to this task
      - `accountId` integer — Account ID.
      - `id` integer — User ID.
      - `name` string — User name.
    - `metrics` ActivityMetricEntity[] — Metrics associated with this task.
      - `id` integer — Metric ID.
      - `name` string — Metric name.
      - `value` number — Metric value.
    - `type` string — Task type.
    - `_webUrl` string — Web platform URL.

---

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