GET /api/v1/task
Personal access token & O auth2

Constrained by the user role. For example, owners and admins can see all tasks. Members can only see tasks within groups they can access and clients can only see tasks they have access to.

Headers

  • X-PLANNR-ACCOUNT-UUID string

Query parameters

  • include string

    Comma separated list of relationships to include in the response. Valid relationships are [author, completed_by, parent_task, related_tasks, custom_fields, workflow_task].

  • per_page integer

    Number of results to return with pagination (Default 15. Max 500).

  • filter[name] string

    Filter Task name.

  • filter[taskable_type] string

    Taskable type. Can be 'plan' or 'case'.

  • filter[taskable_uuid] string

    Taskable uuid.

  • filter[client_uuid] string

    Client Taskable uuid.

  • filter[priority] string

    Priority. Available options are highest, high, medium, and low.

  • filter[assigned_to_uuids] string

    Filter tasks that have been assigned to the account UUIDs.

  • filter[circle_uuids] string

    Filter tasks that have been assigned to the account UUIDs within the specified circles.

  • filter[status_uuid] string

    Status uuid. The task's status uuid.

  • filter[due_before] string

    date Filter tasks that have a due at date before.

  • filter[due_after] string

    date Filter tasks that have a due at date after.

  • filter[has_due_date] boolean

    Filter tasks that have a due at date or not.

  • filter[open_tasks] boolean

    Only show open tasks. When true, this will filter tasks in the "Completed" or "Archived" columns.

  • filter[completed_status] boolean

    Filter tasks which have a system status of type completed.

  • filter[archived_status] boolean

    Filter tasks which have a system status of type archived.

  • filter[not_started_status] boolean

    Filter tasks which have a system status of type not started.

  • filter[show_child_tasks] boolean

    (deprecated, use subtask_visibility instead) Show child tasks in the top-level list. Defaults to false.

  • filter[subtask_visibility] string

    Filter subtasks in the top-level list. options are: include, exclude or only.

  • filter[unassigned_task_visibility] string

    Filter unassigned subtasks in the top-level list. options are: include, exclude or only.

  • filter[is_recurring] boolean

    Filter recurring tasks.

  • sort string

    Field to sort by. Valid fields are [created_at, updated_at, name, priority, due_at, completed_last]. Negative sign to denote DESC. Defaults to 'created_at'.

Responses

  • 200 application/json
    Hide response attribute Show response attribute object
    • data array[object]
      Hide data attributes Show data attributes object
      • uuid string
      • created_at string
      • updated_at string
      • name string
      • priority string
      • position integer
      • due_at string
      • status object
        Hide status attributes Show status attributes object
        • uuid string
        • created_at string
        • updated_at string
        • name string
        • colour string
        • position integer
        • is_type_completed boolean
        • is_archived boolean
        • is_not_started boolean
      • taskable_type string
      • taskable object
        Hide taskable attributes Show taskable attributes object
        • uuid string
        • created_at string
        • updated_at string
        • name string
        • slug string
        • status string
        • type string
        • review_at string
        • assigned_to_uuids array[string]
        • group_uuids array[string]
        • completed_at string
        • value object
          Hide value attributes Show value attributes object
          • amount object
            Hide amount attributes Show amount attributes object
            • example string
            • description string
          • formatted object
            Hide formatted attributes Show formatted attributes object
            • example string
            • description string
          • currency object
            Hide currency attributes Show currency attributes object
            • example string
            • description string
        • status_position integer
        • participants_count integer
        • participants string
        • task_board_uuid string
        • plans string
        • custom_fields string
      • author object
        Hide author attributes Show author attributes object
        • uuid object
          Hide uuid attributes Show uuid attributes object
          • example string
          • description string
          • collection boolean
        • created_at object
          Hide created_at attributes Show created_at attributes object
          • example string
          • description string
          • collection boolean
        • updated_at object
          Hide updated_at attributes Show updated_at attributes object
          • example string
          • description string
          • collection boolean
        • type object
          Hide type attributes Show type attributes object
          • example string
          • description string
          • collection boolean
        • role object
          Hide role attributes Show role attributes object
          • example string
          • description string
          • collection boolean
        • first_name object
          Hide first_name attributes Show first_name attributes object
          • example string
          • description string
          • collection boolean
        • last_name object
          Hide last_name attributes Show last_name attributes object
          • example string
          • description string
          • collection boolean
        • name object
          Hide name attributes Show name attributes object
          • example string
          • description string
          • collection boolean
        • email object
          Hide email attributes Show email attributes object
          • example string
          • description string
          • collection boolean
        • photo_url object
          Hide photo_url attributes Show photo_url attributes object
          • example string
          • description string
          • collection boolean
        • external_references object
          Hide external_references attributes Show external_references attributes object
          • example string
          • description string
          • collection boolean
      • assigned_to object
        Hide assigned_to attributes Show assigned_to attributes object
        • uuid object
          Hide uuid attributes Show uuid attributes object
          • example string
          • description string
          • collection boolean
        • created_at object
          Hide created_at attributes Show created_at attributes object
          • example string
          • description string
          • collection boolean
        • updated_at object
          Hide updated_at attributes Show updated_at attributes object
          • example string
          • description string
          • collection boolean
        • type object
          Hide type attributes Show type attributes object
          • example string
          • description string
          • collection boolean
        • role object
          Hide role attributes Show role attributes object
          • example string
          • description string
          • collection boolean
        • first_name object
          Hide first_name attributes Show first_name attributes object
          • example string
          • description string
          • collection boolean
        • last_name object
          Hide last_name attributes Show last_name attributes object
          • example string
          • description string
          • collection boolean
        • name object
          Hide name attributes Show name attributes object
          • example string
          • description string
          • collection boolean
        • email object
          Hide email attributes Show email attributes object
          • example string
          • description string
          • collection boolean
        • photo_url object
          Hide photo_url attributes Show photo_url attributes object
          • example string
          • description string
          • collection boolean
        • external_references object
          Hide external_references attributes Show external_references attributes object
          • example string
          • description string
          • collection boolean
      • completed_at string
      • completed_by object
        Hide completed_by attributes Show completed_by attributes object
        • uuid object
          Hide uuid attributes Show uuid attributes object
          • example string
          • description string
          • collection boolean
        • created_at object
          Hide created_at attributes Show created_at attributes object
          • example string
          • description string
          • collection boolean
        • updated_at object
          Hide updated_at attributes Show updated_at attributes object
          • example string
          • description string
          • collection boolean
        • type object
          Hide type attributes Show type attributes object
          • example string
          • description string
          • collection boolean
        • role object
          Hide role attributes Show role attributes object
          • example string
          • description string
          • collection boolean
        • first_name object
          Hide first_name attributes Show first_name attributes object
          • example string
          • description string
          • collection boolean
        • last_name object
          Hide last_name attributes Show last_name attributes object
          • example string
          • description string
          • collection boolean
        • name object
          Hide name attributes Show name attributes object
          • example string
          • description string
          • collection boolean
        • email object
          Hide email attributes Show email attributes object
          • example string
          • description string
          • collection boolean
        • photo_url object
          Hide photo_url attributes Show photo_url attributes object
          • example string
          • description string
          • collection boolean
        • external_references object
          Hide external_references attributes Show external_references attributes object
          • example string
          • description string
          • collection boolean
      • workflow_task object
        Hide workflow_task attributes Show workflow_task attributes object
        • uuid object
          Hide uuid attributes Show uuid attributes object
          • example string
          • description string
          • collection boolean
        • created_at object
          Hide created_at attributes Show created_at attributes object
          • example string
          • description string
          • collection boolean
        • updated_at object
          Hide updated_at attributes Show updated_at attributes object
          • example string
          • description string
          • collection boolean
        • name object
          Hide name attributes Show name attributes object
          • example string
          • description string
          • collection boolean
        • description object
          Hide description attributes Show description attributes object
          • example string
          • description string
          • collection boolean
        • priority object
          Hide priority attributes Show priority attributes object
          • example string
          • description string
          • collection boolean
        • position object
          Hide position attributes Show position attributes object
          • example integer
          • description string
          • collection boolean
        • task_status object
          Hide task_status attributes Show task_status attributes object
          • example string
          • description string
          • collection boolean
        • offset_due_at_by object
          Hide offset_due_at_by attributes Show offset_due_at_by attributes object
          • example integer
          • description string
          • collection boolean
        • visible_to_clients object
          Hide visible_to_clients attributes Show visible_to_clients attributes object
          • example boolean
          • description string
          • collection boolean
        • auto_assign_assigned_adviser object
          Hide auto_assign_assigned_adviser attributes Show auto_assign_assigned_adviser attributes object
          • example boolean
          • description string
          • collection boolean
        • auto_assign_assigned_administrator object
          Hide auto_assign_assigned_administrator attributes Show auto_assign_assigned_administrator attributes object
          • example boolean
          • description string
          • collection boolean
        • auto_assign_clients object
          Hide auto_assign_clients attributes Show auto_assign_clients attributes object
          • example boolean
          • description string
          • collection boolean
        • author object
          Hide author attributes Show author attributes object
          • example string
          • description string
          • collection boolean
        • participants object
          Hide participants attributes Show participants attributes object
          • example string
          • description string
          • collection boolean
        • tags object
          Hide tags attributes Show tags attributes object
          • example string
          • description string
          • collection boolean
        • location_uuid object
          Hide location_uuid attributes Show location_uuid attributes object
          • example string
          • description string
          • collection boolean
        • parent object
          Hide parent attributes Show parent attributes object
          • example string
          • description string
          • collection boolean
        • trigger object
          Hide trigger attributes Show trigger attributes object
          • example string
          • description string
          • collection boolean
        • trigger_tasks object
          Hide trigger_tasks attributes Show trigger_tasks attributes object
          • example string
          • description string
          • collection boolean
        • sub_tasks object
          Hide sub_tasks attributes Show sub_tasks attributes object
          • example string
          • description string
          • collection boolean
        • groups object
          Hide groups attributes Show groups attributes object
          • example string
          • description string
          • collection boolean
        • workflow object
          Hide workflow attributes Show workflow attributes object
          • example string
          • description string
          • collection boolean
        • is_trigger_task object
          Hide is_trigger_task attributes Show is_trigger_task attributes object
          • example boolean
          • description string
          • collection boolean
      • is_recurring boolean
      • recurring_frequency string
      • recurring_last_run string
      • recurring_next_run string
      • custom_fields array[object]
        Hide custom_fields attributes Show custom_fields attributes object
        • uuid string
        • created_at string
        • updated_at string
        • type string
        • name string
        • reference string
        • is_required boolean
        • value string
        • selection_options array[string]
        • help_text string
GET /api/v1/task 
curl \
 --request GET 'https://api.plannrcrm.com/api/v1/task' \
 --header "Authorization: Bearer $ACCESS_TOKEN" \
 --header "X-PLANNR-ACCOUNT-UUID: {YOUR_PLANNR_ACCOUNT_UUID}"
Response examples (200) 
{
  "data": [
    [
      {
        "uuid": "d3bf3451-5457-4cb6-a300-05dbd84831eb",
        "created_at": "2026-04-29T12:52:59+01:00",
        "updated_at": "2026-04-29T12:52:59+01:00",
        "name": "Document the transaction",
        "priority": "high",
        "position": 1,
        "due_at": "2021-01-01 00:00:00",
        "status": {
          "uuid": "c9d8cb9c-0813-4558-b9a9-d265ff1df599",
          "created_at": "2026-04-29T12:52:59+01:00",
          "updated_at": "2026-04-29T12:52:59+01:00",
          "name": "Incomplete",
          "colour": "#398898",
          "position": 1,
          "is_type_completed": false,
          "is_archived": false,
          "is_not_started": false
        },
        "taskable_type": "case",
        "taskable": {
          "uuid": "f483e1e4-57ed-4bfd-8177-9a9fffb52e22",
          "created_at": "2026-04-29T12:52:59+01:00",
          "updated_at": "2026-04-29T12:52:59+01:00",
          "name": "finance",
          "slug": "finance",
          "status": "App\\Http\\Resources\\CasesStatusResource",
          "type": "App\\Http\\Resources\\CasesTypeResource",
          "review_at": "2026-04-29T12:52:59+01:00",
          "assigned_to_uuids": [
            "aac74369-5212-426e-8a05-f139a1fa0a9a"
          ],
          "group_uuids": [
            "8004259e-ed1e-4af5-9eef-9a65e7ae9587"
          ],
          "completed_at": "2026-04-29T12:52:59+01:00",
          "value": {
            "amount": {
              "example": "4000",
              "description": "Money amount at their lowest denominator (for example: pennies)"
            },
            "formatted": {
              "example": "£40.00",
              "description": "Money amount formatted with currency"
            },
            "currency": {
              "example": "GBP",
              "description": "Currency of the money"
            }
          },
          "status_position": 4,
          "participants_count": 4,
          "participants": "App\\Http\\Resources\\AccountResource",
          "task_board_uuid": "c2403deb-f363-46c4-8104-9f0b8fcd1927",
          "plans": "App\\Http\\Resources\\Plans\\PlanResource",
          "custom_fields": "App\\Http\\Resources\\CustomFieldValueResource"
        },
        "author": {
          "uuid": {
            "example": "e98e73f5-c9bb-4844-a916-f3f202fb9e76",
            "description": "The UUID of the resource.",
            "collection": false
          },
          "created_at": {
            "example": "2026-04-29T12:52:59+01:00",
            "description": "The timestamp of when the resource was created.",
            "collection": false
          },
          "updated_at": {
            "example": "2026-04-29T12:52:59+01:00",
            "description": "The timestamp of when the resource was updated.",
            "collection": false
          },
          "type": {
            "example": "client",
            "description": "Account type",
            "collection": false
          },
          "role": {
            "example": "client",
            "description": "Account role",
            "collection": false
          },
          "first_name": {
            "example": "Gareth",
            "description": "First name",
            "collection": false
          },
          "last_name": {
            "example": "Thompson",
            "description": "Last name",
            "collection": false
          },
          "name": {
            "example": "Gareth Thompson",
            "description": "Name",
            "collection": false
          },
          "email": {
            "example": "gareth@codepotato.co.uk",
            "description": "(Deprecated - Please use the primary email of the account instead). The email of the account.",
            "collection": false
          },
          "photo_url": {
            "example": "https://eu.ui-avatars.com/api/?name=Gareth+Thompson",
            "description": "The photo URL of the client",
            "collection": false
          },
          "external_references": {
            "example": "App\\Http\\Resources\\ExternalReferenceResource",
            "description": "The external references that have been added to the client.",
            "collection": true
          }
        },
        "assigned_to": {
          "uuid": {
            "example": "fcd98e4b-9246-46b0-a5e5-7ee1401d359f",
            "description": "The UUID of the resource.",
            "collection": false
          },
          "created_at": {
            "example": "2026-04-29T12:52:59+01:00",
            "description": "The timestamp of when the resource was created.",
            "collection": false
          },
          "updated_at": {
            "example": "2026-04-29T12:52:59+01:00",
            "description": "The timestamp of when the resource was updated.",
            "collection": false
          },
          "type": {
            "example": "client",
            "description": "Account type",
            "collection": false
          },
          "role": {
            "example": "client",
            "description": "Account role",
            "collection": false
          },
          "first_name": {
            "example": "Gareth",
            "description": "First name",
            "collection": false
          },
          "last_name": {
            "example": "Thompson",
            "description": "Last name",
            "collection": false
          },
          "name": {
            "example": "Gareth Thompson",
            "description": "Name",
            "collection": false
          },
          "email": {
            "example": "gareth@codepotato.co.uk",
            "description": "(Deprecated - Please use the primary email of the account instead). The email of the account.",
            "collection": false
          },
          "photo_url": {
            "example": "https://eu.ui-avatars.com/api/?name=Gareth+Thompson",
            "description": "The photo URL of the client",
            "collection": false
          },
          "external_references": {
            "example": "App\\Http\\Resources\\ExternalReferenceResource",
            "description": "The external references that have been added to the client.",
            "collection": true
          }
        },
        "completed_at": "2021-01-01 00:00:00",
        "completed_by": {
          "uuid": {
            "example": "e55dd714-eb74-4406-9bae-525f7b4d0777",
            "description": "The UUID of the resource.",
            "collection": false
          },
          "created_at": {
            "example": "2026-04-29T12:52:59+01:00",
            "description": "The timestamp of when the resource was created.",
            "collection": false
          },
          "updated_at": {
            "example": "2026-04-29T12:52:59+01:00",
            "description": "The timestamp of when the resource was updated.",
            "collection": false
          },
          "type": {
            "example": "client",
            "description": "Account type",
            "collection": false
          },
          "role": {
            "example": "client",
            "description": "Account role",
            "collection": false
          },
          "first_name": {
            "example": "Gareth",
            "description": "First name",
            "collection": false
          },
          "last_name": {
            "example": "Thompson",
            "description": "Last name",
            "collection": false
          },
          "name": {
            "example": "Gareth Thompson",
            "description": "Name",
            "collection": false
          },
          "email": {
            "example": "gareth@codepotato.co.uk",
            "description": "(Deprecated - Please use the primary email of the account instead). The email of the account.",
            "collection": false
          },
          "photo_url": {
            "example": "https://eu.ui-avatars.com/api/?name=Gareth+Thompson",
            "description": "The photo URL of the client",
            "collection": false
          },
          "external_references": {
            "example": "App\\Http\\Resources\\ExternalReferenceResource",
            "description": "The external references that have been added to the client.",
            "collection": true
          }
        },
        "workflow_task": {
          "uuid": {
            "example": "b65d08e7-0d3c-4a80-86e3-ca45102b8516",
            "description": "The UUID of the resource.",
            "collection": false
          },
          "created_at": {
            "example": "2026-04-29T12:52:59+01:00",
            "description": "The timestamp of when the resource was created.",
            "collection": false
          },
          "updated_at": {
            "example": "2026-04-29T12:52:59+01:00",
            "description": "The timestamp of when the resource was updated.",
            "collection": false
          },
          "name": {
            "example": "Mortgage Review",
            "description": "The name of the task",
            "collection": false
          },
          "description": {
            "example": "We need to run through a mortgage review with Gareth, as he can probably find a better deal.",
            "description": "The extra description added to a task",
            "collection": false
          },
          "priority": {
            "example": "high",
            "description": "The priority level of the task (e.g p1, p2, p3, p4)",
            "collection": false
          },
          "position": {
            "example": 2,
            "description": "The task position.",
            "collection": false
          },
          "task_status": {
            "example": "App\\Http\\Resources\\TaskStatusResource",
            "description": "Task status.",
            "collection": false
          },
          "offset_due_at_by": {
            "example": 2,
            "description": "How many days from the day the workflow is run should the due at be set by.",
            "collection": false
          },
          "visible_to_clients": {
            "example": true,
            "description": "Indicator for if the task is visible to clients.",
            "collection": false
          },
          "auto_assign_assigned_adviser": {
            "example": true,
            "description": "Denotes if the task will auto-assign the assigned adviser / assigned adviser of the client when it is created.",
            "collection": false
          },
          "auto_assign_assigned_administrator": {
            "example": true,
            "description": "Denotes if the task will auto-assign the administrator of the client when it is created.",
            "collection": false
          },
          "auto_assign_clients": {
            "example": true,
            "description": "Denotes if the task will auto-assign the clients when it is created. If the workflow is run on a case then all the clients on the case will be assigned.",
            "collection": false
          },
          "author": {
            "example": "App\\Http\\Resources\\AccountResource",
            "description": "The author of the task.",
            "collection": false
          },
          "participants": {
            "example": "App\\Http\\Resources\\AccountResource",
            "description": "The participants/assignees of the task.",
            "collection": true
          },
          "tags": {
            "example": "App\\Http\\Resources\\TagResource",
            "description": "The tags added to the task.",
            "collection": true
          },
          "location_uuid": {
            "example": "686770bd-4fd1-4962-aea8-f87712533053",
            "description": "The parent task or workflow trigger task this task is a child of.",
            "collection": false
          },
          "parent": {
            "example": "App\\Http\\Resources\\Board\\WorkflowBoardTaskResource",
            "description": "The parent task.",
            "collection": false
          },
          "trigger": {
            "example": "App\\Http\\Resources\\Board\\WorkflowBoardTaskResource",
            "description": "The task that will trigger this task to be created.",
            "collection": false
          },
          "trigger_tasks": {
            "example": "App\\Http\\Resources\\Board\\WorkflowBoardTaskResource",
            "description": "The tasks that will be triggered when this task is completed.",
            "collection": true
          },
          "sub_tasks": {
            "example": "App\\Http\\Resources\\Board\\WorkflowBoardTaskResource",
            "description": "The tasks sub tasks.",
            "collection": true
          },
          "groups": {
            "example": "App\\Http\\Resources\\GroupResource",
            "description": "The groups that will be added to the task.",
            "collection": true
          },
          "workflow": {
            "example": "App\\Http\\Resources\\Board\\WorkflowResource",
            "description": "The workflow that the workflow task belongs to.",
            "collection": false
          },
          "is_trigger_task": {
            "example": true,
            "description": "Denotes if this is a triggered task.",
            "collection": false
          }
        },
        "is_recurring": true,
        "recurring_frequency": "weekly",
        "recurring_last_run": "2026-01-01 00:00:00",
        "recurring_next_run": "2026-01-01 00:00:00",
        "custom_fields": [
          {
            "uuid": "3675dcdc-8304-4b3f-8309-7a7918876013",
            "created_at": "2026-04-29T12:52:59+01:00",
            "updated_at": "2026-04-29T12:52:59+01:00",
            "type": "string",
            "name": "Favourite Drink",
            "reference": "favourite_drink",
            "is_required": false,
            "value": "Coffee",
            "selection_options": [
              "Coffee",
              "Tea",
              "Water"
            ],
            "help_text": "This is the client's favourite drink."
          }
        ]
      }
    ]
  ]
}