# Retrieve a task

Required scopes: task-management:read

Endpoint: GET /tasks/{id}
Version: v1
Security: http, oauth2

## Path parameters:

  - `id` (string, required)

## Query parameters:

  - `find_by` (string)
    The field to search by
    Enum: "id", "uri", "external_id"

  - `origin` (string)
    Used if find_by=external_id by default it will use the integration slug

## Response 200 fields (application/json):

  - `id` (string, required)

  - `project_id` (string, required)

  - `client_id` (string, required)

  - `parent_task_id` (string, required)

  - `external_id` (string,null, required)

  - `external_origin` (string,null, required)
    If originated from external system origin is added

  - `uri` (string, required)

  - `title` (string, required)

  - `description` (string,null, required)

  - `status` (string, required)
    | |
|---|
| Backlog   |
| New  In Todo |
| WIP  In progress |
| Completed   |
| Approved   |
| Closed  Task was archived |
    Enum: "Backlog", "New", "WIP", "Completed", "Approved", "Closed"

  - `type` (string, required)

  - `estimated_hours` (number,null, required)

  - `is_onhold` (boolean, required)

  - `is_public` (boolean, required)
    If false, the task is only visible to the project team - not guest users

  - `due_date` (string,null, required)

  - `due_date_settings` (object, required)

  - `due_date_settings.is_hard_deadline` (boolean, required)

  - `due_date_settings.recurring_type` (any, required)

  - `due_date_settings.recurring_interval` (integer,null, required)
    Integer offset
if recurring_type = daily or NULL -> offset ignored 
if recurring_type = weekly -> 1 = every Monday, 2 = every Tuesday, etc 
if recurring_type = monthly -> 1 = every month, 2 = every 2 months, etc

  - `assignee` (any, required)

  - `priorityOption` (any, required)

  - `phase` (any)

  - `milestone` (any)

  - `epic` (any)

  - `parent_task` (any)

  - `attachements` (array, required)

  - `attachements.file_name` (string, required)

  - `attachements.mime_type` (string, required)

  - `attachements.size` (integer, required)
    File size in bytes

  - `attachements.entity_id` (string, required)
    ID of the entity that the file belongs to

  - `attachements.entity_type` (string, required)
    Type of the entity that the file belongs to

  - `attachements.created_at` (string, required)

  - `watchers` (array)

  - `watchers.first_name` (string, required)

  - `watchers.last_name` (string, required)

  - `watchers.email` (string, required)

  - `watchers.space` (object, required)

  - `watchers.space.name` (string, required)

  - `sub_tasks` (array, required)

  - `completed_at` (string,null, required)

  - `closed_at` (string,null, required)

  - `updated_at` (string,null, required)

  - `list_sorting` (integer, required)

## Response 401 fields (application/json):

  - `message` (string, required)
    Error overview.

## Response 422 fields (application/json):

  - `message` (string, required)
    Errors overview.

  - `errors` (object, required)
    A detailed description of each field that failed validation.