---
title: "List Task Lists"
method: GET
path: "/v2/company/{company_id}/task_lists"
tags: ["Task Management"]
---

# List Task Lists

`GET /v2/company/{company_id}/task_lists`

## Path parameters

- `company_id` integer, required

## Query parameters

- `user_id` integer
- `location_id` integer
- `uuid` string
- `active_on_date` string

## Headers

- `x-api-version` string — An API version
- `x-company-guid` string, uuid

## Response `200`

OK

- object
  - `object` 'task_list', required
  - `data` object[], required
    - `id` integer, required
    - `task_list_template_uuid` string, required
    - `title` string, required
    - `description` string, required
    - `start` string, date-time, required
    - `due` string, date-time, required
    - `due_date` object, required
      - `start` string, date-time, nullable, required
      - `end` string, date-time, nullable, required
    - `tasks` object[], required
      - `id` integer, required
      - `task_template_uuid` string
      - `title` string, required
      - `description` string
      - `user_id` integer, nullable, required
      - `completed_at` string, date-time, nullable, required
      - `tags` object[], nullable
        - `uuid` string, uuid, required
        - `user_id` integer, required
        - `task_id` integer, required
      - `task_completion` object, nullable
        - `type` 'NUMBER' | 'TEMPERATURE' | 'PHOTO' | 'STRING' | 'WEIGHT' | 'CHECKMARK', required
        - `primitive_type` 'INTEGER' | 'DECIMAL' | 'FILE' | 'STRING' | 'BOOLEAN', required
        - `unit` 'C' | 'F' | 'KG', nullable, required
      - `task_completion_event` object, nullable
        - `user_id` integer, required
        - `completed_at` string, date-time, required
        - `completion_value` string, nullable, required
    - `recurrence` object, required
      - `interval` string, required
      - `rrule` string, required — recurrence rules as defined by the RFC 5545 spec
    - `assignments` object[], required
      - `company_id` integer, required
      - `location_id` integer, required
      - `department_id` integer, nullable
      - `role_id` integer, nullable
      - `user_id` integer, nullable
    - `time_frame` object, nullable
      - `start` string, nullable, required — The time when this task starts
      - `end` string, required — The time when this task ends
      - `start_time` string, date-time, nullable, required — The date and time when this task starts
      - `end_time` string, date-time, required — The date and time when this task ends

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `403` — Forbidden
- `404` — Not found
- `500` — Server Error

---

[API](https://skmtc.net/7shifts/apis/7shifts-api.md) · [All operations](https://skmtc.net/7shifts/apis/7shifts-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/7shifts/7shifts-api/revisions/96a02ef888ab/schema)