Task lists

id

identifier · pattern: ^\d+$

A unique record identifier

administration_id

identifier · pattern: ^\d+$

A unique record identifier

name

string

description

string | null

row_order

integer

completed_at

string | null · date-time

report_type

string | null

task_lists_group_id

identifier · pattern: ^\d+$

A unique record identifier

parent_task_id

identifier_nullable · pattern: ^\d+$

A unique record identifier

assignee_id

identifier_nullable · pattern: ^\d+$

A unique record identifier

created_at

timestamp · date-time

updated_at

timestamp · date-time

subtasks

array · task_list_task_response (circular)

POST/{administration_id}/task_list_groups/{task_list_group_id}/tasks{format}

curl https://moneybird.com/api/v2/:administration_id/task_list_groups/:task_list_group_id/tasks:format \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer <token>' \
  --data '{
  "task": {
    "name": "New Task"
  }
}'

Example Request Body

{
  "task": {
    "name": "New Task"
  }
}

json

application/json

Example Responses

{
  "id": "489722976215762669",
  "administration_id": 123,
  "name": "New Task",
  "description": null,
  "row_order": 1,
  "completed_at": null,
  "report_type": null,
  "task_lists_group_id": "489722976185353962",
  "parent_task_id": null,
  "created_at": "2026-06-12T09:24:06.291Z",
  "updated_at": "2026-06-12T09:24:06.291Z",
  "assignee_id": null,
  "subtasks": [],
  "notes": [],
  "events": [
    {
      "administration_id": 123,
      "user_id": "489722927463269477",
      "action": "task_lists_task_created",
      "link_entity_id": null,
      "link_entity_type": null,
      "data": {},
      "created_at": "2026-06-12T09:24:06.293Z",
      "updated_at": "2026-06-12T09:24:06.293Z"
    }
  ]
}

json

application/json

Returns information about a task

GET

https://moneybird.com/api/v2

/{administration_id}/task_list_tasks/{id}{format}

Returns information about a task, including its subtasks, notes, and events.

Returns information about a task › path Parameters

administration_id

administration_id · pattern: ^\d+$ · required

The unique identifier of the administration

A unique record identifier

id

identifier · pattern: ^\d+$ · required

A unique record identifier

format

string · pattern: ^(.(json|xml))?$ · required

The format in which the response is given, can be empty to use the default format

Default: .json

Returns information about a task › Responses

A task

id

identifier · pattern: ^\d+$

A unique record identifier

administration_id

identifier · pattern: ^\d+$

A unique record identifier

name

string

description

string | null

row_order

integer

completed_at

string | null · date-time

report_type

string | null

task_lists_group_id

identifier · pattern: ^\d+$

A unique record identifier

parent_task_id

identifier_nullable · pattern: ^\d+$

A unique record identifier

assignee_id

identifier_nullable · pattern: ^\d+$

A unique record identifier

created_at

timestamp · date-time

updated_at

timestamp · date-time

subtasks

array · task_list_task_response (circular)

GET/{administration_id}/task_list_tasks/{id}{format}

curl https://moneybird.com/api/v2/:administration_id/task_list_tasks/:id:format \
  --header 'Authorization: Bearer <token>'

Example Responses

{
  "id": "489723112680588556",
  "administration_id": 123,
  "name": "Task #1",
  "description": "Description 1",
  "row_order": 0,
  "completed_at": null,
  "report_type": null,
  "task_lists_group_id": "489723112679539979",
  "parent_task_id": null,
  "created_at": "2026-06-12T09:26:16.434Z",
  "updated_at": "2026-06-12T09:26:16.434Z",
  "assignee_id": null,
  "subtasks": [],
  "notes": [],
  "events": [
    {
      "administration_id": 123,
      "user_id": "489722927463269477",
      "action": "task_lists_task_created",
      "link_entity_id": null,
      "link_entity_type": null,
      "data": {},
      "created_at": "2026-06-12T09:26:16.435Z",
      "updated_at": "2026-06-12T09:26:16.435Z"
    }
  ]
}

json

application/json

Deletes a task

DELETE

https://moneybird.com/api/v2

/{administration_id}/task_list_tasks/{id}{format}

Permanently deletes a task and all its subtasks. Generated tasks cannot be deleted.

Deletes a task › path Parameters

administration_id

administration_id · pattern: ^\d+$ · required

The unique identifier of the administration

A unique record identifier

id

identifier · pattern: ^\d+$ · required

A unique record identifier

format

string · pattern: ^(.(json|xml))?$ · required

The format in which the response is given, can be empty to use the default format

Default: .json

Deletes a task › Responses

Task deleted

No data returned

Updates a task

PATCH

https://moneybird.com/api/v2

/{administration_id}/task_list_tasks/{id}{format}

Updates a task's attributes.

Updates a task › path Parameters

administration_id

administration_id · pattern: ^\d+$ · required

The unique identifier of the administration

A unique record identifier

id

identifier · pattern: ^\d+$ · required

A unique record identifier

format

string · pattern: ^(.(json|xml))?$ · required

The format in which the response is given, can be empty to use the default format

Default: .json

Updates a task › Request Body

object

Updates a task › Responses

Task updated

id

identifier · pattern: ^\d+$

A unique record identifier

administration_id

identifier · pattern: ^\d+$

A unique record identifier

name

string

description

string | null

row_order

integer

completed_at

string | null · date-time

report_type

string | null

task_lists_group_id

identifier · pattern: ^\d+$

A unique record identifier

parent_task_id

identifier_nullable · pattern: ^\d+$

A unique record identifier

assignee_id

identifier_nullable · pattern: ^\d+$

A unique record identifier

created_at

timestamp · date-time

updated_at

timestamp · date-time

subtasks

array · task_list_task_response (circular)

PATCH/{administration_id}/task_list_tasks/{id}{format}

curl https://moneybird.com/api/v2/:administration_id/task_list_tasks/:id:format \
  --request PATCH \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer <token>' \
  --data '{
  "task": {
    "name": "Updated Task"
  }
}'

Example Request Body

{
  "task": {
    "name": "Updated Task"
  }
}

json

application/json

Example Responses

{
  "id": "489723113148253543",
  "administration_id": 123,
  "name": "Updated Task",
  "description": "Description 1",
  "row_order": 0,
  "completed_at": null,
  "report_type": null,
  "task_lists_group_id": "489723113147204966",
  "parent_task_id": null,
  "created_at": "2026-06-12T09:26:16.881Z",
  "updated_at": "2026-06-12T09:26:16.898Z",
  "assignee_id": null,
  "subtasks": [],
  "notes": [],
  "events": [
    {
      "administration_id": 123,
      "user_id": "489722927463269477",
      "action": "task_lists_task_created",
      "link_entity_id": null,
      "link_entity_type": null,
      "data": {},
      "created_at": "2026-06-12T09:26:16.882Z",
      "updated_at": "2026-06-12T09:26:16.882Z"
    },
    {
      "administration_id": 123,
      "user_id": "489722927463269477",
      "action": "task_lists_task_name",
      "link_entity_id": null,
      "link_entity_type": null,
      "data": {
        "name": "Updated Task"
      },
      "created_at": "2026-06-12T09:26:16.900Z",
      "updated_at": "2026-06-12T09:26:16.900Z"
    }
  ]
}

json

application/json

Assigns a user to a task

POST

https://moneybird.com/api/v2

/{administration_id}/task_list_tasks/{task_list_task_id}/assignment{format}

Assigns a user to the specified task.

Assigns a user to a task › path Parameters

administration_id

administration_id · pattern: ^\d+$ · required

The unique identifier of the administration

A unique record identifier

task_list_task_id

identifier · pattern: ^\d+$ · required

A unique record identifier

format

string · pattern: ^(.(json|xml))?$ · required

The format in which the response is given, can be empty to use the default format

Default: .json

Assigns a user to a task › Request Body

assignee_id

identifier · pattern: ^\d+$ · required

The ID of the user to assign to the task. A user must have permissions to a task or else a 404 will be thrown.

Assigns a user to a task › Responses

User assigned to task

id

identifier · pattern: ^\d+$

A unique record identifier

administration_id

identifier · pattern: ^\d+$

A unique record identifier

name

string

description

string | null

row_order

integer

completed_at

string | null · date-time

report_type

string | null

task_lists_group_id

identifier · pattern: ^\d+$

A unique record identifier

parent_task_id

identifier_nullable · pattern: ^\d+$

A unique record identifier

assignee_id

identifier_nullable · pattern: ^\d+$

A unique record identifier

created_at

timestamp · date-time

updated_at

timestamp · date-time

subtasks

array · task_list_task_response (circular)

POST/{administration_id}/task_list_tasks/{task_list_task_id}/assignment{format}

curl https://moneybird.com/api/v2/:administration_id/task_list_tasks/:task_list_task_id/assignment:format \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer <token>' \
  --data '{
  "assignee_id": "489722927490532454"
}'

Example Request Body

{
  "assignee_id": "489722927490532454"
}

json

application/json

Example Responses

{
  "id": "489723113622209957",
  "administration_id": 123,
  "name": "Task #1",
  "description": "Description 1",
  "row_order": 0,
  "completed_at": null,
  "report_type": null,
  "task_lists_group_id": "489723113621161380",
  "parent_task_id": null,
  "created_at": "2026-06-12T09:26:17.333Z",
  "updated_at": "2026-06-12T09:26:17.333Z",
  "assignee_id": "489722927490532454",
  "subtasks": [],
  "notes": [],
  "events": [
    {
      "administration_id": 123,
      "user_id": "489722927463269477",
      "action": "task_lists_task_created",
      "link_entity_id": null,
      "link_entity_type": null,
      "data": {},
      "created_at": "2026-06-12T09:26:17.334Z",
      "updated_at": "2026-06-12T09:26:17.334Z"
    },
    {
      "administration_id": 123,
      "user_id": "489722927463269477",
      "action": "task_lists_task_assigned",
      "link_entity_id": null,
      "link_entity_type": null,
      "data": {
        "assignee": "Mo Neybird"
      },
      "created_at": "2026-06-12T09:26:17.355Z",
      "updated_at": "2026-06-12T09:26:17.355Z"
    }
  ]
}

json

application/json

Unassigns the user from a task

DELETE

https://moneybird.com/api/v2

/{administration_id}/task_list_tasks/{task_list_task_id}/assignment{format}

Removes the current assignment from the specified task.

Unassigns the user from a task › path Parameters

administration_id

administration_id · pattern: ^\d+$ · required

The unique identifier of the administration

A unique record identifier

task_list_task_id

identifier · pattern: ^\d+$ · required

A unique record identifier

format

string · pattern: ^(.(json|xml))?$ · required

The format in which the response is given, can be empty to use the default format

Default: .json

Unassigns the user from a task › Responses

User unassigned from task

id

identifier · pattern: ^\d+$

A unique record identifier

administration_id

identifier · pattern: ^\d+$

A unique record identifier

name

string

description

string | null

row_order

integer

completed_at

string | null · date-time

report_type

string | null

task_lists_group_id

identifier · pattern: ^\d+$

A unique record identifier

parent_task_id

identifier_nullable · pattern: ^\d+$

A unique record identifier

assignee_id

identifier_nullable · pattern: ^\d+$

A unique record identifier

created_at

timestamp · date-time

updated_at

timestamp · date-time

subtasks

array · task_list_task_response (circular)

DELETE/{administration_id}/task_list_tasks/{task_list_task_id}/assignment{format}

curl https://moneybird.com/api/v2/:administration_id/task_list_tasks/:task_list_task_id/assignment:format \
  --request DELETE \
  --header 'Authorization: Bearer <token>'

Example Responses

{
  "id": "489723113717630385",
  "administration_id": 123,
  "name": "Task #1",
  "description": "Description 1",
  "row_order": 0,
  "completed_at": null,
  "report_type": null,
  "task_lists_group_id": "489723113716581808",
  "parent_task_id": null,
  "created_at": "2026-06-12T09:26:17.423Z",
  "updated_at": "2026-06-12T09:26:17.423Z",
  "assignee_id": null,
  "subtasks": [],
  "notes": [],
  "events": [
    {
      "administration_id": 123,
      "user_id": "489722927463269477",
      "action": "task_lists_task_created",
      "link_entity_id": null,
      "link_entity_type": null,
      "data": {},
      "created_at": "2026-06-12T09:26:17.425Z",
      "updated_at": "2026-06-12T09:26:17.425Z"
    }
  ]
}

json

application/json

Completes a task

POST

https://moneybird.com/api/v2

/{administration_id}/task_list_tasks/{task_list_task_id}/completion{format}

Marks a task and all its subtasks as completed.

Completes a task › path Parameters

administration_id

administration_id · pattern: ^\d+$ · required

The unique identifier of the administration

A unique record identifier

task_list_task_id

identifier · pattern: ^\d+$ · required

A unique record identifier

format

string · pattern: ^(.(json|xml))?$ · required

The format in which the response is given, can be empty to use the default format

Default: .json

Completes a task › Responses

Task completed

id

identifier · pattern: ^\d+$

A unique record identifier

administration_id

identifier · pattern: ^\d+$

A unique record identifier

name

string

description

string | null

row_order

integer

completed_at

string | null · date-time

report_type

string | null

task_lists_group_id

identifier · pattern: ^\d+$

A unique record identifier

parent_task_id

identifier_nullable · pattern: ^\d+$

A unique record identifier

assignee_id

identifier_nullable · pattern: ^\d+$

A unique record identifier

created_at

timestamp · date-time

updated_at

timestamp · date-time

subtasks

array · task_list_task_response (circular)

POST/{administration_id}/task_list_tasks/{task_list_task_id}/completion{format}

curl https://moneybird.com/api/v2/:administration_id/task_list_tasks/:task_list_task_id/completion:format \
  --request POST \
  --header 'Authorization: Bearer <token>'

Example Responses

{
  "id": "489723113456534928",
  "administration_id": 123,
  "name": "Task #1",
  "description": "Description 1",
  "row_order": 0,
  "completed_at": "2026-06-12T09:26:17.191Z",
  "report_type": null,
  "task_lists_group_id": "489723113455486351",
  "parent_task_id": null,
  "created_at": "2026-06-12T09:26:17.175Z",
  "updated_at": "2026-06-12T09:26:17.191Z",
  "assignee_id": null,
  "subtasks": [],
  "notes": [],
  "events": [
    {
      "administration_id": 123,
      "user_id": "489722927463269477",
      "action": "task_lists_task_created",
      "link_entity_id": null,
      "link_entity_type": null,
      "data": {},
      "created_at": "2026-06-12T09:26:17.176Z",
      "updated_at": "2026-06-12T09:26:17.176Z"
    },
    {
      "administration_id": 123,
      "user_id": "489722927463269477",
      "action": "task_lists_task_completed",
      "link_entity_id": null,
      "link_entity_type": null,
      "data": {},
      "created_at": "2026-06-12T09:26:17.193Z",
      "updated_at": "2026-06-12T09:26:17.193Z"
    }
  ]
}

json

application/json

Reopens a task

DELETE

https://moneybird.com/api/v2

/{administration_id}/task_list_tasks/{task_list_task_id}/completion{format}

Reopens a completed task and possible parent tasks.

Reopens a task › path Parameters

administration_id

administration_id · pattern: ^\d+$ · required

The unique identifier of the administration

A unique record identifier

task_list_task_id

identifier · pattern: ^\d+$ · required

A unique record identifier

format

string · pattern: ^(.(json|xml))?$ · required

The format in which the response is given, can be empty to use the default format

Default: .json

Reopens a task › Responses

Task reopened

id

identifier · pattern: ^\d+$

A unique record identifier

administration_id

identifier · pattern: ^\d+$

A unique record identifier

name

string

description

string | null

row_order

integer

completed_at

string | null · date-time

report_type

string | null

task_lists_group_id

identifier · pattern: ^\d+$

A unique record identifier

parent_task_id

identifier_nullable · pattern: ^\d+$

A unique record identifier

assignee_id

identifier_nullable · pattern: ^\d+$

A unique record identifier

created_at

timestamp · date-time

updated_at

timestamp · date-time

subtasks

array · task_list_task_response (circular)

DELETE/{administration_id}/task_list_tasks/{task_list_task_id}/completion{format}

curl https://moneybird.com/api/v2/:administration_id/task_list_tasks/:task_list_task_id/completion:format \
  --request DELETE \
  --header 'Authorization: Bearer <token>'

Example Responses

{
  "id": "489723113357968771",
  "administration_id": 123,
  "name": "Task #1",
  "description": "Description 1",
  "row_order": 0,
  "completed_at": null,
  "report_type": null,
  "task_lists_group_id": "489723113356920194",
  "parent_task_id": null,
  "created_at": "2026-06-12T09:26:17.080Z",
  "updated_at": "2026-06-12T09:26:17.103Z",
  "assignee_id": null,
  "subtasks": [],
  "notes": [],
  "events": [
    {
      "administration_id": 123,
      "user_id": "489722927463269477",
      "action": "task_lists_task_created",
      "link_entity_id": null,
      "link_entity_type": null,
      "data": {},
      "created_at": "2026-06-12T09:26:17.082Z",
      "updated_at": "2026-06-12T09:26:17.082Z"
    },
    {
      "administration_id": 123,
      "user_id": "489722927463269477",
      "action": "task_lists_task_completed",
      "link_entity_id": null,
      "link_entity_type": null,
      "data": {},
      "created_at": "2026-06-12T09:26:17.089Z",
      "updated_at": "2026-06-12T09:26:17.089Z"
    },
    {
      "administration_id": 123,
      "user_id": "489722927463269477",
      "action": "task_lists_task_reopened",
      "link_entity_id": null,
      "link_entity_type": null,
      "data": {},
      "created_at": "2026-06-12T09:26:17.105Z",
      "updated_at": "2026-06-12T09:26:17.105Z"
    }
  ]
}

json

application/json

Creates a note on a task

POST

https://moneybird.com/api/v2

/{administration_id}/task_list_tasks/{task_list_task_id}/notes{format}

Creates a new note on the specified task.

Creates a note on a task › path Parameters

administration_id

administration_id · pattern: ^\d+$ · required

The unique identifier of the administration

A unique record identifier

task_list_task_id

identifier · pattern: ^\d+$ · required

A unique record identifier

format

string · pattern: ^(.(json|xml))?$ · required

The format in which the response is given, can be empty to use the default format

Default: .json

Creates a note on a task › Request Body

object

Creates a note on a task › Responses

Note created

note_response

id

identifier · pattern: ^\d+$

A unique record identifier

administration_id

administration_id · pattern: ^\d+$

A unique record identifier

entity_id

identifier_nullable · pattern: ^\d+$

A unique record identifier

entity_type

string

user_id

identifier · pattern: ^\d+$

A unique record identifier

assignee_id

identifier_nullable · pattern: ^\d+$

A unique record identifier

todo

boolean | string | null

Default: false

note

string | null

completed_at

string | null · date-time

completed_by_id

identifier_nullable · pattern: ^\d+$

A unique record identifier

todo_type

string | null · enum

Enum values:

sales_invoice_due

purchase_invoice_due

general_document_reminder

general_document_due

new_document_awaiting_processing

new_financial_mutation_awaiting_processing

financial_mutations_not_updated

sales_invoice_payment_not_linked_to_financial_mutation

data

object | null

created_at

timestamp · date-time

updated_at

timestamp · date-time

POST/{administration_id}/task_list_tasks/{task_list_task_id}/notes{format}

curl https://moneybird.com/api/v2/:administration_id/task_list_tasks/:task_list_task_id/notes:format \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer <token>' \
  --data '{
  "note": {
    "note": "Test note",
    "todo": false
  }
}'

Example Request Body

{
  "note": {
    "note": "Test note",
    "todo": false
  }
}

json

application/json

Example Responses

{
  "id": "489723113253111156",
  "administration_id": 123,
  "entity_id": "489723113234236786",
  "entity_type": "TaskLists::Task",
  "user_id": "489722927463269477",
  "assignee_id": null,
  "todo": false,
  "note": "Test note",
  "completed_at": null,
  "completed_by_id": null,
  "todo_type": null,
  "data": {},
  "created_at": "2026-06-12T09:26:16.980Z",
  "updated_at": "2026-06-12T09:26:16.980Z"
}

json

application/json

Creates a task list from a template

POST

https://moneybird.com/api/v2

/{administration_id}/task_list_templates/{task_list_template_id}/task_lists{format}

Creates a new task list based on the specified template.

Creates a task list from a template › path Parameters

administration_id

administration_id · pattern: ^\d+$ · required

The unique identifier of the administration

A unique record identifier

task_list_template_id

identifier · pattern: ^\d+$ · required

A unique record identifier

format

string · pattern: ^(.(json|xml))?$ · required

The format in which the response is given, can be empty to use the default format

Default: .json

Creates a task list from a template › Request Body optional

object

Creates a task list from a template › Responses

Task list created

id

identifier · pattern: ^\d+$

A unique record identifier

administration_id

identifier · pattern: ^\d+$

A unique record identifier

name

string

description

string | null

deadline_on

string | null · date

period_begin

string | null · date

period_end

string | null · date

completed

boolean

template_id

identifier_nullable · pattern: ^\d+$

A unique record identifier

total_tasks_count

integer

completed_tasks_count

integer

created_at

timestamp · date-time

updated_at

timestamp · date-time

POST/{administration_id}/task_list_templates/{task_list_template_id}/task_lists{format}

curl https://moneybird.com/api/v2/:administration_id/task_list_templates/:task_list_template_id/task_lists:format \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer <token>' \
  --data '{}'

Example Request Body

{}

json

application/json

Example Responses

{
  "id": "489723044571383402",
  "administration_id": 123,
  "name": "Task list template #1",
  "description": "Template description",
  "deadline_on": null,
  "period_begin": "2026-05-01",
  "period_end": "2026-05-31",
  "completed": false,
  "template_id": "489723044536780389",
  "total_tasks_count": 1,
  "completed_tasks_count": 0,
  "created_at": "2026-06-12T09:25:11.480Z",
  "updated_at": "2026-06-12T09:25:11.480Z",
  "groups": [
    {
      "id": "489723044574529132",
      "name": "Task list group #1",
      "row_order": 0,
      "report_type": null,
      "created_at": "2026-06-12T09:25:11.483Z",
      "updated_at": "2026-06-12T09:25:11.483Z",
      "tasks": [
        {
          "id": "489723044575577709",
          "administration_id": 123,
          "name": "Task #1",
          "description": "Description 1",
          "row_order": 0,
          "completed_at": null,
          "report_type": null,
          "task_lists_group_id": "489723044574529132",
          "parent_task_id": null,
          "created_at": "2026-06-12T09:25:11.484Z",
          "updated_at": "2026-06-12T09:25:11.484Z",
          "assignee_id": null,
          "subtasks": [],
          "notes": [],
          "events": [
            {
              "administration_id": 123,
              "user_id": "489722927463269477",
              "action": "task_lists_task_created",
              "link_entity_id": null,
              "link_entity_type": null,
              "data": {},
              "created_at": "2026-06-12T09:25:11.486Z",
              "updated_at": "2026-06-12T09:25:11.486Z"
            }
          ]
        }
      ]
    }
  ]
}

json

application/json

Returns information about a task list

GET

https://moneybird.com/api/v2

/{administration_id}/task_lists/{id}{format}

Returns information about a task list, including its groups, tasks, and subtasks.

Returns information about a task list › path Parameters

administration_id

administration_id · pattern: ^\d+$ · required

The unique identifier of the administration

A unique record identifier

id

identifier · pattern: ^\d+$ · required

A unique record identifier

format

string · pattern: ^(.(json|xml))?$ · required

The format in which the response is given, can be empty to use the default format

Default: .json

Returns information about a task list › Responses

A task list

id

identifier · pattern: ^\d+$

A unique record identifier

administration_id

identifier · pattern: ^\d+$

A unique record identifier

name

string

description

string | null

deadline_on

string | null · date

period_begin

string | null · date

period_end

string | null · date

completed

boolean

template_id

identifier_nullable · pattern: ^\d+$

A unique record identifier

total_tasks_count

integer

completed_tasks_count

integer

created_at

timestamp · date-time

updated_at

timestamp · date-time

GET/{administration_id}/task_lists/{id}{format}

curl https://moneybird.com/api/v2/:administration_id/task_lists/:id:format \
  --header 'Authorization: Bearer <token>'

Example Responses

{
  "id": "489722947929376102",
  "administration_id": 123,
  "name": "Task list #1",
  "description": "List description",
  "deadline_on": null,
  "period_begin": "2026-01-01",
  "period_end": "2026-03-31",
  "completed": false,
  "template_id": null,
  "total_tasks_count": 1,
  "completed_tasks_count": 0,
  "created_at": "2026-06-12T09:23:39.315Z",
  "updated_at": "2026-06-12T09:23:39.315Z",
  "groups": [
    {
      "id": "489722947933570408",
      "name": "Task list group #1",
      "row_order": 0,
      "report_type": null,
      "created_at": "2026-06-12T09:23:39.319Z",
      "updated_at": "2026-06-12T09:23:39.319Z",
      "tasks": [
        {
          "id": "489722947934618985",
          "administration_id": 123,
          "name": "Task #1",
          "description": "Description 1",
          "row_order": 0,
          "completed_at": null,
          "report_type": null,
          "task_lists_group_id": "489722947933570408",
          "parent_task_id": null,
          "created_at": "2026-06-12T09:23:39.320Z",
          "updated_at": "2026-06-12T09:23:39.320Z",
          "assignee_id": null,
          "subtasks": [],
          "notes": [],
          "events": [
            {
              "administration_id": 123,
              "user_id": "489722927463269477",
              "action": "task_lists_task_created",
              "link_entity_id": null,
              "link_entity_type": null,
              "data": {},
              "created_at": "2026-06-12T09:23:39.325Z",
              "updated_at": "2026-06-12T09:23:39.325Z"
            }
          ]
        }
      ]
    }
  ]
}

json

application/json

Deletes a task list

DELETE

https://moneybird.com/api/v2

/{administration_id}/task_lists/{id}{format}

Permanently deletes a task list and all its groups and tasks.

Deletes a task list › path Parameters

administration_id

administration_id · pattern: ^\d+$ · required

The unique identifier of the administration

A unique record identifier

id

identifier · pattern: ^\d+$ · required

A unique record identifier

format

string · pattern: ^(.(json|xml))?$ · required

The format in which the response is given, can be empty to use the default format

Default: .json

Deletes a task list › Responses

Task list deleted

No data returned

Updates a task list

PATCH

https://moneybird.com/api/v2

/{administration_id}/task_lists/{id}{format}

Updates a task list's name, description, or deadline.

Updates a task list › path Parameters

administration_id

administration_id · pattern: ^\d+$ · required

The unique identifier of the administration

A unique record identifier

id

identifier · pattern: ^\d+$ · required

A unique record identifier

format

string · pattern: ^(.(json|xml))?$ · required

The format in which the response is given, can be empty to use the default format

Default: .json

Updates a task list › Request Body

object

Updates a task list › Responses

Task list updated

id

identifier · pattern: ^\d+$

A unique record identifier

administration_id

identifier · pattern: ^\d+$

A unique record identifier

name

string

description

string | null

deadline_on

string | null · date

period_begin

string | null · date

period_end

string | null · date

completed

boolean

template_id

identifier_nullable · pattern: ^\d+$

A unique record identifier

total_tasks_count

integer

completed_tasks_count

integer

created_at

timestamp · date-time

updated_at

timestamp · date-time

PATCH/{administration_id}/task_lists/{id}{format}

curl https://moneybird.com/api/v2/:administration_id/task_lists/:id:format \
  --request PATCH \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer <token>' \
  --data '{
  "task_list": {
    "name": "Updated Name"
  }
}'

Example Request Body

{
  "task_list": {
    "name": "Updated Name"
  }
}

json

application/json

Example Responses

{
  "id": "489722947564471627",
  "administration_id": 123,
  "name": "Updated Name",
  "description": "List description",
  "deadline_on": null,
  "period_begin": "2026-01-01",
  "period_end": "2026-03-31",
  "completed": false,
  "template_id": null,
  "total_tasks_count": 1,
  "completed_tasks_count": 0,
  "created_at": "2026-06-12T09:23:38.967Z",
  "updated_at": "2026-06-12T09:23:38.991Z",
  "groups": [
    {
      "id": "489722947567617357",
      "name": "Task list group #1",
      "row_order": 0,
      "report_type": null,
      "created_at": "2026-06-12T09:23:38.971Z",
      "updated_at": "2026-06-12T09:23:38.971Z",
      "tasks": [
        {
          "id": "489722947568665934",
          "administration_id": 123,
          "name": "Task #1",
          "description": "Description 1",
          "row_order": 0,
          "completed_at": null,
          "report_type": null,
          "task_lists_group_id": "489722947567617357",
          "parent_task_id": null,
          "created_at": "2026-06-12T09:23:38.972Z",
          "updated_at": "2026-06-12T09:23:38.972Z",
          "assignee_id": null,
          "subtasks": [],
          "notes": [],
          "events": [
            {
              "administration_id": 123,
              "user_id": "489722927463269477",
              "action": "task_lists_task_created",
              "link_entity_id": null,
              "link_entity_type": null,
              "data": {},
              "created_at": "2026-06-12T09:23:38.973Z",
              "updated_at": "2026-06-12T09:23:38.973Z"
            }
          ]
        }
      ]
    }
  ]
}

json

application/json

Creates a new group in a task list

POST

https://moneybird.com/api/v2

/{administration_id}/task_lists/{task_list_id}/groups{format}

Creates a new group in the specified task list.

Creates a new group in a task list › path Parameters

administration_id

administration_id · pattern: ^\d+$ · required

The unique identifier of the administration

A unique record identifier

task_list_id

identifier · pattern: ^\d+$ · required

A unique record identifier

format

string · pattern: ^(.(json|xml))?$ · required

The format in which the response is given, can be empty to use the default format

Default: .json

Creates a new group in a task list › Request Body

object

Creates a new group in a task list › Responses

Group created

task_list_group_response

id

identifier · pattern: ^\d+$

A unique record identifier

name

string | null

row_order

integer

report_type

string | null

created_at

timestamp · date-time

updated_at

timestamp · date-time

task_list_task_response[]

List all task lists of an administration

GET

https://moneybird.com/api/v2

/{administration_id}/task_lists{format}

Returns a paginated list of task lists in the administration. Each page contains 30 task lists by default. Use the page parameter to fetch the next page.

List all task lists of an administration › path Parameters

administration_id

administration_id · pattern: ^\d+$ · required

The unique identifier of the administration

A unique record identifier

format

string · pattern: ^(.(json|xml))?$ · required

The format in which the response is given, can be empty to use the default format

Default: .json

List all task lists of an administration › query Parameters

per_page

integer | string · min: 1 · max: 100 · pattern: ^\d+$

Amount of task lists per page, default: 30

page

integer | string

The page to fetch, starting at 1.

List all task lists of an administration › Responses

A list of task lists

task_list_response[]

id

identifier · pattern: ^\d+$

A unique record identifier

administration_id

identifier · pattern: ^\d+$

A unique record identifier

name

string

description

string | null

deadline_on

string | null · date

period_begin

string | null · date

period_end

string | null · date

completed

boolean

template_id

identifier_nullable · pattern: ^\d+$

A unique record identifier

total_tasks_count

integer

completed_tasks_count

integer

created_at

timestamp · date-time

updated_at

timestamp · date-time

GET/{administration_id}/task_lists{format}

curl https://moneybird.com/api/v2/:administration_id/task_lists:format \
  --header 'Authorization: Bearer <token>'

Example Responses

[
  {
    "id": "489722946981463331",
    "administration_id": 123,
    "name": "Task list #1",
    "description": "List description",
    "deadline_on": null,
    "period_begin": "2026-01-01",
    "period_end": "2026-03-31",
    "completed": false,
    "template_id": null,
    "total_tasks_count": 1,
    "completed_tasks_count": 0,
    "created_at": "2026-06-12T09:23:38.411Z",
    "updated_at": "2026-06-12T09:23:38.411Z",
    "groups": [
      {
        "id": "489722946985657637",
        "name": "Task list group #1",
        "row_order": 0,
        "report_type": null,
        "created_at": "2026-06-12T09:23:38.415Z",
        "updated_at": "2026-06-12T09:23:38.415Z",
        "tasks": [
          {
            "id": "489722946986706214",
            "administration_id": 123,
            "name": "Task #1",
            "description": "Description 1",
            "row_order": 0,
            "completed_at": null,
            "report_type": null,
            "task_lists_group_id": "489722946985657637",
            "parent_task_id": null,
            "created_at": "2026-06-12T09:23:38.416Z",
            "updated_at": "2026-06-12T09:23:38.416Z",
            "assignee_id": null,
            "subtasks": [],
            "notes": [],
            "events": [
              {
                "administration_id": 123,
                "user_id": "489722927463269477",
                "action": "task_lists_task_created",
                "link_entity_id": null,
                "link_entity_type": null,
                "data": {},
                "created_at": "2026-06-12T09:23:38.418Z",
                "updated_at": "2026-06-12T09:23:38.418Z"
              }
            ]
          }
        ]
      }
    ]
  }
]

json

application/json

Creates a new task list

POST

https://moneybird.com/api/v2

/{administration_id}/task_lists{format}

Creates a new task list. Optionally, you can provide a template_id to create the task list from a template.

Creates a new task list › path Parameters

administration_id

administration_id · pattern: ^\d+$ · required

The unique identifier of the administration

A unique record identifier

format

string · pattern: ^(.(json|xml))?$ · required

The format in which the response is given, can be empty to use the default format

Default: .json

Creates a new task list › Request Body

object

Creates a new task list › Responses

Task list created

id

identifier · pattern: ^\d+$

A unique record identifier

administration_id

identifier · pattern: ^\d+$

A unique record identifier

name

string

description

string | null

deadline_on

string | null · date

period_begin

string | null · date

period_end

string | null · date

completed

boolean

template_id

identifier_nullable · pattern: ^\d+$

A unique record identifier

total_tasks_count

integer

completed_tasks_count

integer

created_at

timestamp · date-time

updated_at

timestamp · date-time