> ## Documentation Index
> Fetch the complete documentation index at: https://api.tipee.ch/llms.txt
> Use this file to discover all available pages before exploring further.

# List

> Returns all tasks matching the given filters. When both `task.ids` and `task.project_ids` filters are provided, `task.ids` takes precedence.



## OpenAPI

````yaml 26.06.25 post /api/activity/tasks.list
openapi: 3.1.0
info:
  title: tipee
  version: 26.06.25
servers: []
security:
  - basicAuth: []
tags:
  - name: Activity
    description: Activity
  - name: Balances
    description: Balances
  - name: Directory
    description: Directory
  - name: Schedule
    description: Schedule
  - name: Timeclock
    description: Timeclock
paths:
  /api/activity/tasks.list:
    post:
      tags:
        - Activity
      summary: List
      description: >-
        Returns all tasks matching the given filters. When both `task.ids` and
        `task.project_ids` filters are provided, `task.ids` takes precedence.
      operationId: post_app_ui_api_activity_configuration_taskquery_listtasks
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/ListProjectTasksQuery'
      responses:
        '200':
          description: ''
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/TaskView'
components:
  schemas:
    ListProjectTasksQuery:
      properties:
        filters:
          type: array
          items:
            $ref: '#/components/schemas/ListProjectTasksQueryFilter'
      type: object
    TaskView:
      required:
        - id
        - project_id
        - tag_ids
        - name
        - color
        - billable
        - remark_required
        - hourly_budget
        - resource_ids
      properties:
        id:
          $ref: '#/components/schemas/Snowflake'
        project_id:
          $ref: '#/components/schemas/Snowflake'
        tag_ids:
          type: array
          items:
            $ref: '#/components/schemas/Snowflake'
        name:
          type: string
        color:
          type: string
        billable:
          type: boolean
        remark_required:
          type: boolean
        hourly_budget:
          $ref: '#/components/schemas/Duration'
        resource_ids:
          type: array
          items:
            $ref: '#/components/schemas/Snowflake'
      type: object
    ListProjectTasksQueryFilter:
      discriminator:
        propertyName: key
      oneOf:
        - required:
            - key
            - value
          properties:
            key:
              type: string
              example: task.projects_ids
              enum:
                - task.projects_ids
            value:
              type: array
              items:
                $ref: '#/components/schemas/Snowflake'
          type: object
        - required:
            - key
            - value
          properties:
            key:
              type: string
              example: task.ids
              enum:
                - task.ids
            value:
              type: array
              items:
                $ref: '#/components/schemas/Snowflake'
          type: object
        - required:
            - key
            - value
          properties:
            key:
              type: string
              example: task.assigned
              enum:
                - task.assigned
            value:
              type: array
              items:
                $ref: '#/components/schemas/Snowflake'
          type: object
        - required:
            - key
            - value
          properties:
            key:
              type: string
              example: task.project_status
              enum:
                - task.project_status
            value:
              type: array
              items:
                $ref: '#/components/schemas/ProjectStatus'
          type: object
        - required:
            - key
            - value
          properties:
            key:
              type: string
              example: task.projects_date_range
              enum:
                - task.projects_date_range
            value:
              $ref: '#/components/schemas/LocalDateInterval'
          type: object
        - required:
            - key
            - value
          properties:
            key:
              type: string
              example: task.effective
              enum:
                - task.effective
            value:
              $ref: '#/components/schemas/ResourceDateRangeValue'
          type: object
        - required:
            - key
            - value
          properties:
            key:
              type: string
              example: task.billable
              enum:
                - task.billable
            value:
              type: boolean
          type: object
        - required:
            - key
            - value
          properties:
            key:
              type: string
              example: task.search
              enum:
                - task.search
            value:
              type: string
          type: object
        - required:
            - key
            - value
          properties:
            key:
              type: string
              example: task.tags
              enum:
                - task.tags
            value:
              $ref: '#/components/schemas/TaskTagsFilterValue'
          type: object
        - required:
            - key
            - value
          properties:
            key:
              type: string
              example: project.resource_ids
              enum:
                - project.resource_ids
            value:
              type: array
              items:
                $ref: '#/components/schemas/Snowflake'
          type: object
        - required:
            - key
            - value
          properties:
            key:
              type: string
              example: or
              enum:
                - or
            value:
              type: array
              items:
                $ref: '#/components/schemas/ListProjectTasksQueryFilter'
          type: object
        - required:
            - key
            - value
          properties:
            key:
              type: string
              example: and
              enum:
                - and
            value:
              type: array
              items:
                $ref: '#/components/schemas/ListProjectTasksQueryFilter'
          type: object
    Snowflake:
      type: string
      format: snowflake
      example: '872815618512410358'
    Duration:
      description: '[ISO 8601 duration](https://en.wikipedia.org/wiki/ISO_8601#Durations)'
      type: string
      format: duration
      example: PT1H30M20S
    ProjectStatus:
      type: string
      example: draft
      enum:
        - draft
        - active
        - locked
        - archived
    LocalDateInterval:
      type: string
      format: local-date-interval
      example: 2019-11-11/2019-12-12
    ResourceDateRangeValue:
      required:
        - resource_id
        - date_range
      properties:
        resource_id:
          $ref: '#/components/schemas/Snowflake'
        date_range:
          $ref: '#/components/schemas/LocalDateInterval'
      type: object
    TaskTagsFilterValue:
      required:
        - tags
        - operator
      properties:
        tags:
          type: array
          items:
            $ref: '#/components/schemas/Snowflake'
        operator:
          $ref: '#/components/schemas/LogicalOperator'
      type: object
    LogicalOperator:
      type: string
      example: or
      enum:
        - or
        - and

````