Moneybird API

Time entries

Endpointhttps://moneybird.com/api/v2

Time entries are used to track time spent on projects, which can then be billed to customers.

Get a time entry by id

GET

https://moneybird.com/api/v2

/{administration_id}/time_entries/{id}{format}

Returns a time entry in the administration.

Get a time entry by id › path Parameters

administration_id

string | integer · pattern: ^\d+$ · required

The unique identifier of the administration

A unique record identifier

id

string | integer · 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

Get a time entry by id › Responses

A time entry

id

string | integer · pattern: ^\d+$

A unique record identifier

administration_id

string | integer · pattern: ^\d+$

A unique record identifier

contact_id

string | integer | null · pattern: ^\d+$

A unique record identifier

project_id

string | integer | null · pattern: ^\d+$

A unique record identifier

sales_invoice_id

string | integer | null · pattern: ^\d+$

A unique record identifier

user_id

string | integer · pattern: ^\d+$

A unique record identifier

started_at

string · date-time

description

string

paused_duration

integer

billable

boolean | null

created_at

string · date-time

updated_at

string · date-time

object

object[]

GET/{administration_id}/time_entries/{id}{format}

curl --request GET \
  --url https://moneybird.com/api/v2/:administration_id/time_entries/:id:format

shell

Example Responses

{
  "id": "471699918952597432",
  "administration_id": 123,
  "contact_id": "471699918935820212",
  "project_id": "471699918945257398",
  "sales_invoice_id": null,
  "user_id": 17640679459010,
  "started_at": "2025-11-25T10:55:00.000Z",
  "ended_at": "2025-11-25T11:55:00.000Z",
  "description": "Designing the website",
  "paused_duration": 0,
  "billable": true,
  "created_at": "2025-11-25T10:55:19.476Z",
  "updated_at": "2025-11-25T10:55:19.476Z",
  "contact": {
    "id": "471699918935820212",
    "firstname": "",
    "lastname": "",
    "company_name": "Foobar Holding B.V."
  },
  "user": {
    "id": 17640679459010,
    "name": "Moneybird",
    "created_at": "2025-11-25T10:52:25.088Z",
    "updated_at": "2025-11-25T10:52:25.447Z"
  },
  "project": {
    "id": "471699918945257398",
    "name": "Project 1",
    "state": "active",
    "budget": 10
  },
  "sales_invoice": null,
  "events": [
    {
      "administration_id": 123,
      "user_id": 17640679459010,
      "action": "time_entry_created",
      "link_entity_id": null,
      "link_entity_type": null,
      "data": {},
      "created_at": "2025-11-25T10:55:19.478Z",
      "updated_at": "2025-11-25T10:55:19.478Z"
    }
  ],
  "notes": []
}

json

application/json

Delete a time entry

DELETE

https://moneybird.com/api/v2

/{administration_id}/time_entries/{id}{format}

Delete a time entry by id.

Delete a time entry › path Parameters

administration_id

string | integer · pattern: ^\d+$ · required

The unique identifier of the administration

A unique record identifier

id

string | integer · 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

Delete a time entry › Responses

Time entry deleted

No data returned

DELETE/{administration_id}/time_entries/{id}{format}

curl --request DELETE \
  --url https://moneybird.com/api/v2/:administration_id/time_entries/:id:format

shell

Example Responses

No example specified for this content type

Update a time entry

PATCH

https://moneybird.com/api/v2

/{administration_id}/time_entries/{id}{format}

When updating a time entry, provide only the attributes you want to update. The other attributes will not be changed. started_at and ended_at are rounded down to full minutes when updating a time entry, with a minimum of 1 minute between them.

Update a time entry › path Parameters

administration_id

string | integer · pattern: ^\d+$ · required

The unique identifier of the administration

A unique record identifier

id

string | integer · 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

Update a time entry › Request Body

object

Update a time entry › Responses

Time entry updated

id

string | integer · pattern: ^\d+$

A unique record identifier

administration_id

string | integer · pattern: ^\d+$

A unique record identifier

contact_id

string | integer | null · pattern: ^\d+$

A unique record identifier

project_id

string | integer | null · pattern: ^\d+$

A unique record identifier

sales_invoice_id

string | integer | null · pattern: ^\d+$

A unique record identifier

user_id

string | integer · pattern: ^\d+$

A unique record identifier

started_at

string · date-time

description

string

paused_duration

integer

billable

boolean | null

created_at

string · date-time

updated_at

string · date-time

object

object[]

PATCH/{administration_id}/time_entries/{id}{format}

curl --request PATCH \
  --url https://moneybird.com/api/v2/:administration_id/time_entries/:id:format \
  --header 'Content-Type: application/json' \
  --data '
{
  "time_entry": {
    "description": "Updated description"
  }
}
'

shell

Example Request Body

{
  "time_entry": {
    "description": "Updated description"
  }
}

json

application/json

Example Responses

{
  "id": "471699918525826974",
  "administration_id": 123,
  "contact_id": "471699918495418266",
  "project_id": "471699918515341212",
  "sales_invoice_id": null,
  "user_id": 17640679459010,
  "started_at": "2025-11-25T10:55:00.000Z",
  "ended_at": "2025-11-25T11:55:00.000Z",
  "description": "Updated description",
  "paused_duration": 0,
  "billable": true,
  "created_at": "2025-11-25T10:55:19.069Z",
  "updated_at": "2025-11-25T10:55:19.098Z",
  "contact": {
    "id": "471699918495418266",
    "firstname": "",
    "lastname": "",
    "company_name": "Foobar Holding B.V."
  },
  "user": {
    "id": 17640679459010,
    "name": "Moneybird",
    "created_at": "2025-11-25T10:52:25.088Z",
    "updated_at": "2025-11-25T10:52:25.447Z"
  },
  "project": {
    "id": "471699918515341212",
    "name": "Project 1",
    "state": "active",
    "budget": 10
  },
  "sales_invoice": null,
  "events": [
    {
      "administration_id": 123,
      "user_id": 17640679459010,
      "action": "time_entry_created",
      "link_entity_id": null,
      "link_entity_type": null,
      "data": {},
      "created_at": "2025-11-25T10:55:19.071Z",
      "updated_at": "2025-11-25T10:55:19.071Z"
    },
    {
      "administration_id": 123,
      "user_id": 17640679459010,
      "action": "time_entry_updated",
      "link_entity_id": null,
      "link_entity_type": null,
      "data": {
        "description": [
          "Designing the website",
          "Updated description"
        ],
        "updated_at": [
          "2025-11-25T11:55:19.069+01:00",
          "2025-11-25T11:55:19.098+01:00"
        ]
      },
      "created_at": "2025-11-25T10:55:19.101Z",
      "updated_at": "2025-11-25T10:55:19.101Z"
    }
  ],
  "notes": []
}

json

application/json

Destroys note from entity

DELETE

https://moneybird.com/api/v2

/{administration_id}/time_entries/{time_entry_id}/notes/{id}{format}

Deletes a note from a time entry.

Destroys note from entity › path Parameters

administration_id

string | integer · pattern: ^\d+$ · required

The unique identifier of the administration

A unique record identifier

time_entry_id

string | integer · pattern: ^\d+$ · required

A unique record identifier

id

string | integer · 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

Destroys note from entity › Responses

Note deleted

No data returned

DELETE/{administration_id}/time_entries/{time_entry_id}/notes/{id}{format}

curl --request DELETE \
  --url https://moneybird.com/api/v2/:administration_id/time_entries/:time_entry_id/notes/:id:format

shell

Example Responses

No example specified for this content type

Adds note to entity

POST

https://moneybird.com/api/v2

/{administration_id}/time_entries/{time_entry_id}/notes{format}

Adds a note to the time entry.

Adds note to entity › path Parameters

administration_id

string | integer · pattern: ^\d+$ · required

The unique identifier of the administration

A unique record identifier

time_entry_id

string | integer · 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

Adds note to entity › Request Body

object

Adds note to entity › Responses

Note created

id

string | integer · pattern: ^\d+$

A unique record identifier

administration_id

string | integer · pattern: ^\d+$

A unique record identifier

entity_id

string | integer | null · pattern: ^\d+$

A unique record identifier

entity_type

string

user_id

string | integer · pattern: ^\d+$

A unique record identifier

assignee_id

string | integer | null · pattern: ^\d+$

A unique record identifier

todo

boolean | string | null

Default: false

note

string | null

completed_at

string | null · date-time

completed_by_id

string | integer | null · 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

string · date-time

updated_at

string · date-time

POST/{administration_id}/time_entries/{time_entry_id}/notes{format}

curl --request POST \
  --url https://moneybird.com/api/v2/:administration_id/time_entries/:time_entry_id/notes:format \
  --header 'Content-Type: application/json' \
  --data '
{
  "note": {
    "note": "Text of the note",
    "assignee_id": 471699919048017860,
    "todo": true
  }
}
'

shell

Example Request Body

{
  "note": {
    "note": "Text of the note",
    "assignee_id": 471699919048017860,
    "todo": true
  }
}

json

application/json

Example Responses

{
  "id": "471699919094155212",
  "administration_id": 123,
  "entity_id": "471699919078426570",
  "entity_type": "TimeEntry",
  "user_id": 17640679459010,
  "assignee_id": "471699919048017858",
  "todo": true,
  "note": "Text of the note",
  "completed_at": null,
  "completed_by_id": null,
  "todo_type": null,
  "data": {},
  "created_at": "2025-11-25T10:55:19.612Z",
  "updated_at": "2025-11-25T10:55:19.612Z"
}

json

application/json

List all time entries

GET

https://moneybird.com/api/v2

/{administration_id}/time_entries{format}

Returns a paginated list of all time entries in the administration.

The filter argument allows you to filter the list of time entries. Filters are a combination of keys and values, separated by a comma: period:this_year,state:all. The available options for filtering are:

Filter	Type	Default	Description
state	`String`	`all`	`all`, `open` or `non_billable`
period	`String`	`this_year`	This can either be the description of a period (`this_month`, `prev_month`, `next_month`, `this_quarter`, `prev_quarter`, `next_quarter`, `this_year`, `prev_year`, `next_year`) or a custom period (`201301..201302`, `20130101..20130131`)
contact_id	`Integer`		Select time entries belonging to a certain contact
include_nil_contacts	`Boolean`	false	Whether to include time entries that have no assigned contact
include_active	`Boolean`	false	Whether to include active time entries i.e. time entries without ended_at
project_id	`Integer`		Select time entries belonging to a certain project
user_id	`Integer`		Select time entries belonging to a certain user
day	`Date`		Select time entries on a specific date

You can filter by multiple states at the same time as well. To do this, separate the state values by a pipe: state:open|non_billable.

List all time entries › path Parameters

administration_id

string | integer · 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 time entries › query Parameters

filter

string

page

integer | string

per_page

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

query

string

Allows filtering by time entry description.

List all time entries › Responses

A list of time entries

object[]

id

string | integer · pattern: ^\d+$

A unique record identifier

administration_id

string | integer · pattern: ^\d+$

A unique record identifier

contact_id

string | integer | null · pattern: ^\d+$

A unique record identifier

project_id

string | integer | null · pattern: ^\d+$

A unique record identifier

sales_invoice_id

string | integer | null · pattern: ^\d+$

A unique record identifier

user_id

string | integer · pattern: ^\d+$

A unique record identifier

started_at

string · date-time

description

string

paused_duration

integer

billable

boolean | null

created_at

string · date-time

updated_at

string · date-time

object

object[]

GET/{administration_id}/time_entries{format}

curl --request GET \
  --url https://moneybird.com/api/v2/:administration_id/time_entries:format

shell

Example Responses

[
  {
    "id": "471699911633536828",
    "administration_id": 123,
    "contact_id": "471699911617808184",
    "project_id": "471699911627245370",
    "sales_invoice_id": null,
    "user_id": 17640679459010,
    "started_at": "2025-11-25T10:55:00.000Z",
    "ended_at": "2025-11-25T11:55:00.000Z",
    "description": "Designing the website",
    "paused_duration": 0,
    "billable": true,
    "created_at": "2025-11-25T10:55:12.496Z",
    "updated_at": "2025-11-25T10:55:12.496Z",
    "contact": {
      "id": "471699911617808184",
      "firstname": "",
      "lastname": "",
      "company_name": "Foobar Holding B.V."
    },
    "user": {
      "id": 17640679459010,
      "name": "Moneybird",
      "created_at": "2025-11-25T10:52:25.088Z",
      "updated_at": "2025-11-25T10:52:25.447Z"
    },
    "project": {
      "id": "471699911627245370",
      "name": "Project 1",
      "state": "active",
      "budget": 10
    },
    "sales_invoice": null,
    "events": [
      {
        "administration_id": 123,
        "user_id": 17640679459010,
        "action": "time_entry_created",
        "link_entity_id": null,
        "link_entity_type": null,
        "data": {},
        "created_at": "2025-11-25T10:55:12.498Z",
        "updated_at": "2025-11-25T10:55:12.498Z"
      }
    ],
    "notes": []
  },
  {
    "id": "471699911650314047",
    "administration_id": 123,
    "contact_id": null,
    "project_id": null,
    "sales_invoice_id": null,
    "user_id": 1,
    "started_at": "2025-11-25T10:55:00.000Z",
    "ended_at": "2025-11-25T11:55:00.000Z",
    "description": "Designing the website",
    "paused_duration": 0,
    "billable": false,
    "created_at": "2025-11-25T10:55:12.512Z",
    "updated_at": "2025-11-25T10:55:12.512Z",
    "contact": null,
    "user": {
      "id": 1,
      "name": "Edwin Vlieg",
      "created_at": "2025-11-25T10:55:12.504Z",
      "updated_at": "2025-11-25T10:55:12.509Z"
    },
    "project": null,
    "sales_invoice": null,
    "events": [
      {
        "administration_id": 123,
        "user_id": 1,
        "action": "time_entry_created",
        "link_entity_id": null,
        "link_entity_type": null,
        "data": {},
        "created_at": "2025-11-25T10:55:12.514Z",
        "updated_at": "2025-11-25T10:55:12.514Z"
      }
    ],
    "notes": []
  },
  {
    "id": "471699911666042690",
    "administration_id": 123,
    "contact_id": null,
    "project_id": null,
    "sales_invoice_id": null,
    "user_id": 2,
    "started_at": "2025-11-25T10:55:00.000Z",
    "ended_at": "2025-11-25T11:55:00.000Z",
    "description": "Designing the website",
    "paused_duration": 0,
    "billable": true,
    "created_at": "2025-11-25T10:55:12.528Z",
    "updated_at": "2025-11-25T10:55:12.528Z",
    "contact": null,
    "user": {
      "id": 2,
      "name": "Edwin Vlieg",
      "created_at": "2025-11-25T10:55:12.520Z",
      "updated_at": "2025-11-25T10:55:12.524Z"
    },
    "project": null,
    "sales_invoice": null,
    "events": [
      {
        "administration_id": 123,
        "user_id": 2,
        "action": "time_entry_created",
        "link_entity_id": null,
        "link_entity_type": null,
        "data": {},
        "created_at": "2025-11-25T10:55:12.529Z",
        "updated_at": "2025-11-25T10:55:12.529Z"
      }
    ],
    "notes": []
  }
]

json

application/json

Create a time entry

POST

https://moneybird.com/api/v2

/{administration_id}/time_entries{format}

Api user needs access to both sales invoices and time entries for this action. started_at and ended_at are rounded down to full minutes when creating a time entry, with a minimum of 1 minute between them.

Create a time entry › path Parameters

administration_id

string | integer · 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

Create a time entry › Request Body

object

Create a time entry › Responses

Time entry created

id

string | integer · pattern: ^\d+$

A unique record identifier

administration_id

string | integer · pattern: ^\d+$

A unique record identifier

contact_id

string | integer | null · pattern: ^\d+$

A unique record identifier

project_id

string | integer | null · pattern: ^\d+$

A unique record identifier

sales_invoice_id

string | integer | null · pattern: ^\d+$

A unique record identifier

user_id

string | integer · pattern: ^\d+$

A unique record identifier

started_at

string · date-time

description

string

paused_duration

integer

billable

boolean | null

created_at

string · date-time

updated_at

string · date-time

object

object[]

POST/{administration_id}/time_entries{format}

curl --request POST \
  --url https://moneybird.com/api/v2/:administration_id/time_entries:format \
  --header 'Content-Type: application/json' \
  --data '
{
  "time_entry": {
    "started_at": "2025-11-25 10:55:00 UTC",
    "ended_at": "2025-11-25 11:55:00 UTC",
    "description": "Test",
    "contact_id": 471699919237810100,
    "project_id": 471699919247247300,
    "user_id": 17640679459010,
    "billable": false
  }
}
'

shell

Example Request Body

{
  "time_entry": {
    "started_at": "2025-11-25 10:55:00 UTC",
    "ended_at": "2025-11-25 11:55:00 UTC",
    "description": "Test",
    "contact_id": 471699919237810100,
    "project_id": 471699919247247300,
    "user_id": 17640679459010,
    "billable": false
  }
}

json

application/json

Example Responses

{
  "id": "471699919264024543",
  "administration_id": 123,
  "contact_id": "471699919237810139",
  "project_id": "471699919247247325",
  "sales_invoice_id": null,
  "user_id": 17640679459010,
  "started_at": "2025-11-25T10:55:00.000Z",
  "ended_at": "2025-11-25T11:55:00.000Z",
  "description": "Test",
  "paused_duration": 0,
  "billable": false,
  "created_at": "2025-11-25T10:55:19.773Z",
  "updated_at": "2025-11-25T10:55:19.773Z",
  "contact": {
    "id": "471699919237810139",
    "firstname": "",
    "lastname": "",
    "company_name": "Foobar Holding B.V."
  },
  "user": {
    "id": 17640679459010,
    "name": "Moneybird",
    "created_at": "2025-11-25T10:52:25.088Z",
    "updated_at": "2025-11-25T10:52:25.447Z"
  },
  "project": {
    "id": "471699919247247325",
    "name": "Project 1",
    "state": "active",
    "budget": 10
  },
  "sales_invoice": null,
  "events": [
    {
      "administration_id": 123,
      "user_id": 17640679459010,
      "action": "time_entry_created",
      "link_entity_id": null,
      "link_entity_type": null,
      "data": {},
      "created_at": "2025-11-25T10:55:19.775Z",
      "updated_at": "2025-11-25T10:55:19.775Z"
    }
  ],
  "notes": []
}

json

application/json

Tax rates Users

Moneybird API

Time entries

Endpointhttps://moneybird.com/api/v2

Time entries are used to track time spent on projects, which can then be billed to customers.

Get a time entry by id

GET

https://moneybird.com/api/v2

/{administration_id}/time_entries/{id}{format}

Returns a time entry in the administration.

Get a time entry by id › path Parameters

administration_id

string | integer · pattern: ^\d+$ · required

The unique identifier of the administration

A unique record identifier

id

string | integer · 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

Get a time entry by id › Responses

A time entry

id

string | integer · pattern: ^\d+$

A unique record identifier

administration_id

string | integer · pattern: ^\d+$

A unique record identifier

contact_id

string | integer | null · pattern: ^\d+$

A unique record identifier

project_id

string | integer | null · pattern: ^\d+$

A unique record identifier

sales_invoice_id

string | integer | null · pattern: ^\d+$

A unique record identifier

user_id

string | integer · pattern: ^\d+$

A unique record identifier

started_at

string · date-time

description

string

paused_duration

integer

billable

boolean | null

created_at

string · date-time

updated_at

string · date-time

object

object[]

GET/{administration_id}/time_entries/{id}{format}

curl --request GET \
  --url https://moneybird.com/api/v2/:administration_id/time_entries/:id:format

shell

Example Responses

{
  "id": "471699918952597432",
  "administration_id": 123,
  "contact_id": "471699918935820212",
  "project_id": "471699918945257398",
  "sales_invoice_id": null,
  "user_id": 17640679459010,
  "started_at": "2025-11-25T10:55:00.000Z",
  "ended_at": "2025-11-25T11:55:00.000Z",
  "description": "Designing the website",
  "paused_duration": 0,
  "billable": true,
  "created_at": "2025-11-25T10:55:19.476Z",
  "updated_at": "2025-11-25T10:55:19.476Z",
  "contact": {
    "id": "471699918935820212",
    "firstname": "",
    "lastname": "",
    "company_name": "Foobar Holding B.V."
  },
  "user": {
    "id": 17640679459010,
    "name": "Moneybird",
    "created_at": "2025-11-25T10:52:25.088Z",
    "updated_at": "2025-11-25T10:52:25.447Z"
  },
  "project": {
    "id": "471699918945257398",
    "name": "Project 1",
    "state": "active",
    "budget": 10
  },
  "sales_invoice": null,
  "events": [
    {
      "administration_id": 123,
      "user_id": 17640679459010,
      "action": "time_entry_created",
      "link_entity_id": null,
      "link_entity_type": null,
      "data": {},
      "created_at": "2025-11-25T10:55:19.478Z",
      "updated_at": "2025-11-25T10:55:19.478Z"
    }
  ],
  "notes": []
}

json

application/json

Delete a time entry

DELETE

https://moneybird.com/api/v2

/{administration_id}/time_entries/{id}{format}

Delete a time entry by id.

Delete a time entry › path Parameters

administration_id

string | integer · pattern: ^\d+$ · required

The unique identifier of the administration

A unique record identifier

id

string | integer · 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

Delete a time entry › Responses

Time entry deleted

No data returned

DELETE/{administration_id}/time_entries/{id}{format}

curl --request DELETE \
  --url https://moneybird.com/api/v2/:administration_id/time_entries/:id:format

shell

Example Responses

No example specified for this content type

Update a time entry

PATCH

https://moneybird.com/api/v2

/{administration_id}/time_entries/{id}{format}

Update a time entry › path Parameters

administration_id

string | integer · pattern: ^\d+$ · required

The unique identifier of the administration

A unique record identifier

id

string | integer · 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

Update a time entry › Request Body

object

Update a time entry › Responses

Time entry updated

id

string | integer · pattern: ^\d+$

A unique record identifier

administration_id

string | integer · pattern: ^\d+$

A unique record identifier

contact_id

string | integer | null · pattern: ^\d+$

A unique record identifier

project_id

string | integer | null · pattern: ^\d+$

A unique record identifier

sales_invoice_id

string | integer | null · pattern: ^\d+$

A unique record identifier

user_id

string | integer · pattern: ^\d+$

A unique record identifier

started_at

string · date-time

description

string

paused_duration

integer

billable

boolean | null

created_at

string · date-time

updated_at

string · date-time

object

object[]

PATCH/{administration_id}/time_entries/{id}{format}

curl --request PATCH \
  --url https://moneybird.com/api/v2/:administration_id/time_entries/:id:format \
  --header 'Content-Type: application/json' \
  --data '
{
  "time_entry": {
    "description": "Updated description"
  }
}
'

shell

Example Request Body

{
  "time_entry": {
    "description": "Updated description"
  }
}

json

application/json

Example Responses

{
  "id": "471699918525826974",
  "administration_id": 123,
  "contact_id": "471699918495418266",
  "project_id": "471699918515341212",
  "sales_invoice_id": null,
  "user_id": 17640679459010,
  "started_at": "2025-11-25T10:55:00.000Z",
  "ended_at": "2025-11-25T11:55:00.000Z",
  "description": "Updated description",
  "paused_duration": 0,
  "billable": true,
  "created_at": "2025-11-25T10:55:19.069Z",
  "updated_at": "2025-11-25T10:55:19.098Z",
  "contact": {
    "id": "471699918495418266",
    "firstname": "",
    "lastname": "",
    "company_name": "Foobar Holding B.V."
  },
  "user": {
    "id": 17640679459010,
    "name": "Moneybird",
    "created_at": "2025-11-25T10:52:25.088Z",
    "updated_at": "2025-11-25T10:52:25.447Z"
  },
  "project": {
    "id": "471699918515341212",
    "name": "Project 1",
    "state": "active",
    "budget": 10
  },
  "sales_invoice": null,
  "events": [
    {
      "administration_id": 123,
      "user_id": 17640679459010,
      "action": "time_entry_created",
      "link_entity_id": null,
      "link_entity_type": null,
      "data": {},
      "created_at": "2025-11-25T10:55:19.071Z",
      "updated_at": "2025-11-25T10:55:19.071Z"
    },
    {
      "administration_id": 123,
      "user_id": 17640679459010,
      "action": "time_entry_updated",
      "link_entity_id": null,
      "link_entity_type": null,
      "data": {
        "description": [
          "Designing the website",
          "Updated description"
        ],
        "updated_at": [
          "2025-11-25T11:55:19.069+01:00",
          "2025-11-25T11:55:19.098+01:00"
        ]
      },
      "created_at": "2025-11-25T10:55:19.101Z",
      "updated_at": "2025-11-25T10:55:19.101Z"
    }
  ],
  "notes": []
}

json

application/json

Destroys note from entity

DELETE

https://moneybird.com/api/v2

/{administration_id}/time_entries/{time_entry_id}/notes/{id}{format}

Deletes a note from a time entry.

Destroys note from entity › path Parameters

administration_id

string | integer · pattern: ^\d+$ · required

The unique identifier of the administration

A unique record identifier

time_entry_id

string | integer · pattern: ^\d+$ · required

A unique record identifier

id

string | integer · 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

Destroys note from entity › Responses

Note deleted

No data returned

DELETE/{administration_id}/time_entries/{time_entry_id}/notes/{id}{format}

curl --request DELETE \
  --url https://moneybird.com/api/v2/:administration_id/time_entries/:time_entry_id/notes/:id:format

shell

Example Responses

No example specified for this content type

Adds note to entity

POST

https://moneybird.com/api/v2

/{administration_id}/time_entries/{time_entry_id}/notes{format}

Adds a note to the time entry.

Adds note to entity › path Parameters

administration_id

string | integer · pattern: ^\d+$ · required

The unique identifier of the administration

A unique record identifier

time_entry_id

string | integer · 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

Adds note to entity › Request Body

object

Adds note to entity › Responses

Note created

id

string | integer · pattern: ^\d+$

A unique record identifier

administration_id

string | integer · pattern: ^\d+$

A unique record identifier

entity_id

string | integer | null · pattern: ^\d+$

A unique record identifier

entity_type

string

user_id

string | integer · pattern: ^\d+$

A unique record identifier

assignee_id

string | integer | null · pattern: ^\d+$

A unique record identifier

todo

boolean | string | null

Default: false

note

string | null

completed_at

string | null · date-time

completed_by_id

string | integer | null · 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

string · date-time

updated_at

string · date-time

POST/{administration_id}/time_entries/{time_entry_id}/notes{format}

curl --request POST \
  --url https://moneybird.com/api/v2/:administration_id/time_entries/:time_entry_id/notes:format \
  --header 'Content-Type: application/json' \
  --data '
{
  "note": {
    "note": "Text of the note",
    "assignee_id": 471699919048017860,
    "todo": true
  }
}
'

shell

Example Request Body

{
  "note": {
    "note": "Text of the note",
    "assignee_id": 471699919048017860,
    "todo": true
  }
}

json

application/json

Example Responses

{
  "id": "471699919094155212",
  "administration_id": 123,
  "entity_id": "471699919078426570",
  "entity_type": "TimeEntry",
  "user_id": 17640679459010,
  "assignee_id": "471699919048017858",
  "todo": true,
  "note": "Text of the note",
  "completed_at": null,
  "completed_by_id": null,
  "todo_type": null,
  "data": {},
  "created_at": "2025-11-25T10:55:19.612Z",
  "updated_at": "2025-11-25T10:55:19.612Z"
}

json

application/json

List all time entries

GET

https://moneybird.com/api/v2

/{administration_id}/time_entries{format}

Returns a paginated list of all time entries in the administration.

Filter	Type	Default	Description
state	`String`	`all`	`all`, `open` or `non_billable`
period	`String`	`this_year`	This can either be the description of a period (`this_month`, `prev_month`, `next_month`, `this_quarter`, `prev_quarter`, `next_quarter`, `this_year`, `prev_year`, `next_year`) or a custom period (`201301..201302`, `20130101..20130131`)
contact_id	`Integer`		Select time entries belonging to a certain contact
include_nil_contacts	`Boolean`	false	Whether to include time entries that have no assigned contact
include_active	`Boolean`	false	Whether to include active time entries i.e. time entries without ended_at
project_id	`Integer`		Select time entries belonging to a certain project
user_id	`Integer`		Select time entries belonging to a certain user
day	`Date`		Select time entries on a specific date

You can filter by multiple states at the same time as well. To do this, separate the state values by a pipe: state:open|non_billable.

List all time entries › path Parameters

administration_id

string | integer · 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 time entries › query Parameters

filter

string

page

integer | string

per_page

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

query

string

Allows filtering by time entry description.

List all time entries › Responses

A list of time entries

object[]

id

string | integer · pattern: ^\d+$

A unique record identifier

administration_id

string | integer · pattern: ^\d+$

A unique record identifier

contact_id

string | integer | null · pattern: ^\d+$

A unique record identifier

project_id

string | integer | null · pattern: ^\d+$

A unique record identifier

sales_invoice_id

string | integer | null · pattern: ^\d+$

A unique record identifier

user_id

string | integer · pattern: ^\d+$

A unique record identifier

started_at

string · date-time

description

string

paused_duration

integer

billable

boolean | null

created_at

string · date-time

updated_at

string · date-time

object

object[]

GET/{administration_id}/time_entries{format}

curl --request GET \
  --url https://moneybird.com/api/v2/:administration_id/time_entries:format

shell

Example Responses

[
  {
    "id": "471699911633536828",
    "administration_id": 123,
    "contact_id": "471699911617808184",
    "project_id": "471699911627245370",
    "sales_invoice_id": null,
    "user_id": 17640679459010,
    "started_at": "2025-11-25T10:55:00.000Z",
    "ended_at": "2025-11-25T11:55:00.000Z",
    "description": "Designing the website",
    "paused_duration": 0,
    "billable": true,
    "created_at": "2025-11-25T10:55:12.496Z",
    "updated_at": "2025-11-25T10:55:12.496Z",
    "contact": {
      "id": "471699911617808184",
      "firstname": "",
      "lastname": "",
      "company_name": "Foobar Holding B.V."
    },
    "user": {
      "id": 17640679459010,
      "name": "Moneybird",
      "created_at": "2025-11-25T10:52:25.088Z",
      "updated_at": "2025-11-25T10:52:25.447Z"
    },
    "project": {
      "id": "471699911627245370",
      "name": "Project 1",
      "state": "active",
      "budget": 10
    },
    "sales_invoice": null,
    "events": [
      {
        "administration_id": 123,
        "user_id": 17640679459010,
        "action": "time_entry_created",
        "link_entity_id": null,
        "link_entity_type": null,
        "data": {},
        "created_at": "2025-11-25T10:55:12.498Z",
        "updated_at": "2025-11-25T10:55:12.498Z"
      }
    ],
    "notes": []
  },
  {
    "id": "471699911650314047",
    "administration_id": 123,
    "contact_id": null,
    "project_id": null,
    "sales_invoice_id": null,
    "user_id": 1,
    "started_at": "2025-11-25T10:55:00.000Z",
    "ended_at": "2025-11-25T11:55:00.000Z",
    "description": "Designing the website",
    "paused_duration": 0,
    "billable": false,
    "created_at": "2025-11-25T10:55:12.512Z",
    "updated_at": "2025-11-25T10:55:12.512Z",
    "contact": null,
    "user": {
      "id": 1,
      "name": "Edwin Vlieg",
      "created_at": "2025-11-25T10:55:12.504Z",
      "updated_at": "2025-11-25T10:55:12.509Z"
    },
    "project": null,
    "sales_invoice": null,
    "events": [
      {
        "administration_id": 123,
        "user_id": 1,
        "action": "time_entry_created",
        "link_entity_id": null,
        "link_entity_type": null,
        "data": {},
        "created_at": "2025-11-25T10:55:12.514Z",
        "updated_at": "2025-11-25T10:55:12.514Z"
      }
    ],
    "notes": []
  },
  {
    "id": "471699911666042690",
    "administration_id": 123,
    "contact_id": null,
    "project_id": null,
    "sales_invoice_id": null,
    "user_id": 2,
    "started_at": "2025-11-25T10:55:00.000Z",
    "ended_at": "2025-11-25T11:55:00.000Z",
    "description": "Designing the website",
    "paused_duration": 0,
    "billable": true,
    "created_at": "2025-11-25T10:55:12.528Z",
    "updated_at": "2025-11-25T10:55:12.528Z",
    "contact": null,
    "user": {
      "id": 2,
      "name": "Edwin Vlieg",
      "created_at": "2025-11-25T10:55:12.520Z",
      "updated_at": "2025-11-25T10:55:12.524Z"
    },
    "project": null,
    "sales_invoice": null,
    "events": [
      {
        "administration_id": 123,
        "user_id": 2,
        "action": "time_entry_created",
        "link_entity_id": null,
        "link_entity_type": null,
        "data": {},
        "created_at": "2025-11-25T10:55:12.529Z",
        "updated_at": "2025-11-25T10:55:12.529Z"
      }
    ],
    "notes": []
  }
]

json

application/json

Create a time entry

POST

https://moneybird.com/api/v2

/{administration_id}/time_entries{format}

Create a time entry › path Parameters

administration_id

string | integer · 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

Create a time entry › Request Body

object

Create a time entry › Responses

Time entry created

id

string | integer · pattern: ^\d+$

A unique record identifier

administration_id

string | integer · pattern: ^\d+$

A unique record identifier

contact_id

string | integer | null · pattern: ^\d+$

A unique record identifier

project_id

string | integer | null · pattern: ^\d+$

A unique record identifier

sales_invoice_id

string | integer | null · pattern: ^\d+$

A unique record identifier

user_id

string | integer · pattern: ^\d+$

A unique record identifier

started_at

string · date-time

description

string

paused_duration

integer

billable

boolean | null

created_at

string · date-time

updated_at

string · date-time

object

object[]

POST/{administration_id}/time_entries{format}

curl --request POST \
  --url https://moneybird.com/api/v2/:administration_id/time_entries:format \
  --header 'Content-Type: application/json' \
  --data '
{
  "time_entry": {
    "started_at": "2025-11-25 10:55:00 UTC",
    "ended_at": "2025-11-25 11:55:00 UTC",
    "description": "Test",
    "contact_id": 471699919237810100,
    "project_id": 471699919247247300,
    "user_id": 17640679459010,
    "billable": false
  }
}
'

shell

Example Request Body

{
  "time_entry": {
    "started_at": "2025-11-25 10:55:00 UTC",
    "ended_at": "2025-11-25 11:55:00 UTC",
    "description": "Test",
    "contact_id": 471699919237810100,
    "project_id": 471699919247247300,
    "user_id": 17640679459010,
    "billable": false
  }
}

json

application/json

Example Responses

{
  "id": "471699919264024543",
  "administration_id": 123,
  "contact_id": "471699919237810139",
  "project_id": "471699919247247325",
  "sales_invoice_id": null,
  "user_id": 17640679459010,
  "started_at": "2025-11-25T10:55:00.000Z",
  "ended_at": "2025-11-25T11:55:00.000Z",
  "description": "Test",
  "paused_duration": 0,
  "billable": false,
  "created_at": "2025-11-25T10:55:19.773Z",
  "updated_at": "2025-11-25T10:55:19.773Z",
  "contact": {
    "id": "471699919237810139",
    "firstname": "",
    "lastname": "",
    "company_name": "Foobar Holding B.V."
  },
  "user": {
    "id": 17640679459010,
    "name": "Moneybird",
    "created_at": "2025-11-25T10:52:25.088Z",
    "updated_at": "2025-11-25T10:52:25.447Z"
  },
  "project": {
    "id": "471699919247247325",
    "name": "Project 1",
    "state": "active",
    "budget": 10
  },
  "sales_invoice": null,
  "events": [
    {
      "administration_id": 123,
      "user_id": 17640679459010,
      "action": "time_entry_created",
      "link_entity_id": null,
      "link_entity_type": null,
      "data": {},
      "created_at": "2025-11-25T10:55:19.775Z",
      "updated_at": "2025-11-25T10:55:19.775Z"
    }
  ],
  "notes": []
}

json

application/json

Tax rates Users