# List or filter tasks

GET https://api.close.com/api/v1/task/

The `view` parameter can be used to conveniently access the different task views. It accepts one of the following values:

* `inbox`: Shows incomplete tasks up to the end of the user's day only (taking the time zone into account).
* `future`: Shows incomplete tasks starting from the user's tomorrow only (taking the time zone into account).
* `archive`: Shows complete tasks only.

Note that a `view` value of `inbox` or `future` will override any `date__lt` or `date__gte` parameters included in the same request.

The `_order_by` field allows ordering by `date` or `date_created` (descending order by prepending a minus, e.g. `_order_by=-date`).

Reference: https://developer.close.com/api/resources/tasks/list

## OpenAPI Specification

```yaml
openapi: 3.1.0
info:
  title: Close API
  version: 1.0.0
paths:
  /task/:
    get:
      operationId: list
      summary: List or filter tasks
      description: >-
        The `view` parameter can be used to conveniently access the different
        task views. It accepts one of the following values:


        * `inbox`: Shows incomplete tasks up to the end of the user's day only
        (taking the time zone into account).

        * `future`: Shows incomplete tasks starting from the user's tomorrow
        only (taking the time zone into account).

        * `archive`: Shows complete tasks only.


        Note that a `view` value of `inbox` or `future` will override any
        `date__lt` or `date__gte` parameters included in the same request.


        The `_order_by` field allows ordering by `date` or `date_created`
        (descending order by prepending a minus, e.g. `_order_by=-date`).
      tags:
        - subpackage_tasks
      parameters:
        - name: _limit
          in: query
          description: Number of results to return.
          required: false
          schema:
            type: integer
            default: 100
        - name: _skip
          in: query
          description: Number of results to skip before returning, for pagination.
          required: false
          schema:
            type: integer
            default: 0
        - name: assigned_to
          in: query
          required: false
          schema:
            type:
              - string
              - 'null'
        - name: format
          in: query
          required: false
          schema:
            type:
              - string
              - 'null'
        - name: id
          in: query
          required: false
          schema:
            type:
              - string
              - 'null'
        - name: id__in
          in: query
          required: false
          schema:
            type:
              - string
              - 'null'
        - name: is_complete
          in: query
          required: false
          schema:
            type:
              - string
              - 'null'
        - name: lead_id
          in: query
          required: false
          schema:
            type:
              - string
              - 'null'
        - name: _order_by
          in: query
          required: false
          schema:
            type:
              - string
              - 'null'
        - name: organization_id
          in: query
          required: false
          schema:
            type:
              - string
              - 'null'
        - name: _type
          in: query
          required: false
          schema:
            type:
              - string
              - 'null'
        - name: _type__in
          in: query
          required: false
          schema:
            type:
              - string
              - 'null'
        - name: view
          in: query
          required: false
          schema:
            type:
              - string
              - 'null'
        - name: date
          in: query
          required: false
          schema:
            type:
              - string
              - 'null'
        - name: date__lt
          in: query
          required: false
          schema:
            type:
              - string
              - 'null'
        - name: date__lte
          in: query
          required: false
          schema:
            type:
              - string
              - 'null'
        - name: date__gt
          in: query
          required: false
          schema:
            type:
              - string
              - 'null'
        - name: date__gte
          in: query
          required: false
          schema:
            type:
              - string
              - 'null'
        - name: due_date
          in: query
          required: false
          schema:
            type:
              - string
              - 'null'
        - name: due_date__lt
          in: query
          required: false
          schema:
            type:
              - string
              - 'null'
        - name: due_date__lte
          in: query
          required: false
          schema:
            type:
              - string
              - 'null'
        - name: due_date__gt
          in: query
          required: false
          schema:
            type:
              - string
              - 'null'
        - name: due_date__gte
          in: query
          required: false
          schema:
            type:
              - string
              - 'null'
        - name: date_created__lt
          in: query
          required: false
          schema:
            type:
              - string
              - 'null'
        - name: date_created__lte
          in: query
          required: false
          schema:
            type:
              - string
              - 'null'
        - name: date_created__gt
          in: query
          required: false
          schema:
            type:
              - string
              - 'null'
        - name: date_created__gte
          in: query
          required: false
          schema:
            type:
              - string
              - 'null'
        - name: date_updated__lt
          in: query
          required: false
          schema:
            type:
              - string
              - 'null'
        - name: date_updated__lte
          in: query
          required: false
          schema:
            type:
              - string
              - 'null'
        - name: date_updated__gt
          in: query
          required: false
          schema:
            type:
              - string
              - 'null'
        - name: date_updated__gte
          in: query
          required: false
          schema:
            type:
              - string
              - 'null'
        - name: _fields
          in: query
          description: Comma-separated list of fields to include in the response.
          required: false
          schema:
            type: string
        - name: Authorization
          in: header
          description: Basic authentication
          required: true
          schema:
            type: string
      responses:
        '200':
          description: Successful response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/tasks_list_Response_200'
        '400':
          description: Bad request
          content:
            application/json:
              schema:
                description: Any type
        '401':
          description: Unauthorized
          content:
            application/json:
              schema:
                description: Any type
        '404':
          description: Not found
          content:
            application/json:
              schema:
                description: Any type
servers:
  - url: https://api.close.com/api/v1
components:
  schemas:
    tasks_list_Response_200:
      type: object
      properties: {}
      description: Empty response body
      title: tasks_list_Response_200
  securitySchemes:
    ApiKeyAuth:
      type: http
      scheme: basic
    OAuth2:
      type: http
      scheme: bearer

```