Time entries

id

identifier · pattern: ^\d+$

A unique record identifier

administration_id

administration_id · pattern: ^\d+$

A unique record identifier

contact_id

identifier_nullable · pattern: ^\d+$

A unique record identifier

project_id

identifier_nullable · pattern: ^\d+$

A unique record identifier

sales_invoice_id

identifier_nullable · pattern: ^\d+$

A unique record identifier

user_id

identifier · pattern: ^\d+$

A unique record identifier

started_at

timestamp · date-time

description

string

paused_duration

integer

billable

boolean | null

created_at

timestamp · date-time

updated_at

timestamp · date-time

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

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

Example Responses

{
  "id": "502878469471864720",
  "administration_id": 123,
  "contact_id": null,
  "project_id": null,
  "sales_invoice_id": null,
  "user_id": "502878423469786213",
  "started_at": "2026-11-04T13:25:00.000Z",
  "ended_at": null,
  "description": "Designing the website",
  "paused_duration": 0,
  "billable": true,
  "created_at": "2026-11-04T14:25:02.330Z",
  "updated_at": "2026-11-04T14:25:02.337Z",
  "contact": null,
  "user": {
    "id": "502878423469786213",
    "name": "Moneybird",
    "created_at": "2026-11-04T14:24:18.450Z",
    "updated_at": "2026-11-04T14:24:18.559Z"
  },
  "project": null,
  "sales_invoice": null,
  "events": [
    {
      "administration_id": 123,
      "user_id": "502878423469786213",
      "action": "time_entry_created",
      "link_entity_id": null,
      "link_entity_type": null,
      "data": {},
      "created_at": "2026-11-04T14:25:02.331Z",
      "updated_at": "2026-11-04T14:25:02.331Z"
    },
    {
      "administration_id": 123,
      "user_id": "502878423469786213",
      "action": "time_entry_updated",
      "link_entity_id": null,
      "link_entity_type": null,
      "data": {
        "ended_at": [
          "2026-11-04T15:25:00.000+01:00",
          null
        ],
        "updated_at": [
          "2026-11-04T15:25:02.330+01:00",
          "2026-11-04T15:25:02.337+01:00"
        ]
      },
      "created_at": "2026-11-04T14:25:02.338Z",
      "updated_at": "2026-11-04T14:25:02.338Z"
    }
  ],
  "notes": []
}

json

application/json

Stops an active time entry

PATCH

https://moneybird.com/api/v2

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

Stops an active time entry. If the time entry is already stopped, the time entry is returned unchanged.

When the time entry belongs to another user than the user of the token, the token also needs the sales_invoices scope.

Required scope(s)

time_entries

Stops an active time entry › 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

Stops an active time entry › Responses

Time entry stopped

id

identifier · pattern: ^\d+$

A unique record identifier

administration_id

administration_id · pattern: ^\d+$

A unique record identifier

contact_id

identifier_nullable · pattern: ^\d+$

A unique record identifier

project_id

identifier_nullable · pattern: ^\d+$

A unique record identifier

sales_invoice_id

identifier_nullable · pattern: ^\d+$

A unique record identifier

user_id

identifier · pattern: ^\d+$

A unique record identifier

started_at

timestamp · date-time

description

string

paused_duration

integer

billable

boolean | null

created_at

timestamp · date-time

updated_at

timestamp · date-time

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

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

Example Responses

{
  "id": "502878469115348767",
  "administration_id": 123,
  "contact_id": null,
  "project_id": null,
  "sales_invoice_id": null,
  "user_id": "502878423469786213",
  "started_at": "2026-11-04T14:25:00.000Z",
  "ended_at": "2026-11-04T14:25:00.000Z",
  "description": "Designing the website",
  "paused_duration": 0,
  "billable": true,
  "created_at": "2026-11-04T14:25:01.990Z",
  "updated_at": "2026-11-04T14:25:01.998Z",
  "contact": null,
  "user": {
    "id": "502878423469786213",
    "name": "Moneybird",
    "created_at": "2026-11-04T14:24:18.450Z",
    "updated_at": "2026-11-04T14:24:18.559Z"
  },
  "project": null,
  "sales_invoice": null,
  "events": [
    {
      "administration_id": 123,
      "user_id": "502878423469786213",
      "action": "time_entry_created",
      "link_entity_id": null,
      "link_entity_type": null,
      "data": {},
      "created_at": "2026-11-04T14:25:01.991Z",
      "updated_at": "2026-11-04T14:25:01.991Z"
    },
    {
      "administration_id": 123,
      "user_id": "502878423469786213",
      "action": "time_entry_updated",
      "link_entity_id": null,
      "link_entity_type": null,
      "data": {
        "ended_at": [
          null,
          "2026-11-04T15:25:00.000+01:00"
        ],
        "updated_at": [
          "2026-11-04T15:25:01.990+01:00",
          "2026-11-04T15:25:01.998+01:00"
        ]
      },
      "created_at": "2026-11-04T14:25:01.999Z",
      "updated_at": "2026-11-04T14:25:01.999Z"
    }
  ],
  "notes": []
}

json

application/json

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. When the time entry belongs to another user than the user of the token, the token also needs the sales_invoices scope.

Required scope(s)

time_entries

Get a time entry by id › 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

Get a time entry by id › Responses

A time entry

id

identifier · pattern: ^\d+$

A unique record identifier

administration_id

administration_id · pattern: ^\d+$

A unique record identifier

contact_id

identifier_nullable · pattern: ^\d+$

A unique record identifier

project_id

identifier_nullable · pattern: ^\d+$

A unique record identifier

sales_invoice_id

identifier_nullable · pattern: ^\d+$

A unique record identifier

user_id

identifier · pattern: ^\d+$

A unique record identifier

started_at

timestamp · date-time

description

string

paused_duration

integer

billable

boolean | null

created_at

timestamp · date-time

updated_at

timestamp · date-time

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

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

Example Responses

{
  "id": "502878469510662039",
  "administration_id": 123,
  "contact_id": "502878469505419156",
  "project_id": "502878469507516309",
  "sales_invoice_id": null,
  "user_id": "502878423469786213",
  "started_at": "2026-11-04T14:25:00.000Z",
  "ended_at": "2026-11-04T15:25:00.000Z",
  "description": "Designing the website",
  "paused_duration": 0,
  "billable": true,
  "created_at": "2026-11-04T14:25:02.367Z",
  "updated_at": "2026-11-04T14:25:02.367Z",
  "contact": {
    "id": "502878469505419156",
    "firstname": null,
    "lastname": null,
    "company_name": "Foobar Holding B.V."
  },
  "user": {
    "id": "502878423469786213",
    "name": "Moneybird",
    "created_at": "2026-11-04T14:24:18.450Z",
    "updated_at": "2026-11-04T14:24:18.559Z"
  },
  "project": {
    "id": "502878469507516309",
    "name": "Project 1",
    "state": "active",
    "budget": 10
  },
  "events": [
    {
      "administration_id": 123,
      "user_id": "502878423469786213",
      "action": "time_entry_created",
      "link_entity_id": null,
      "link_entity_type": null,
      "data": {},
      "created_at": "2026-11-04T14:25:02.368Z",
      "updated_at": "2026-11-04T14:25:02.368Z"
    }
  ],
  "notes": []
}

json

application/json

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.

When the time entry belongs to another user than the user of the token, the token also needs the sales_invoices scope. A time entry that is on a sales invoice cannot be updated.

Required scope(s)

time_entries

Update a time entry › 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

Update a time entry › Request Body

object

Update a time entry › Responses

Time entry updated

id

identifier · pattern: ^\d+$

A unique record identifier

administration_id

administration_id · pattern: ^\d+$

A unique record identifier

contact_id

identifier_nullable · pattern: ^\d+$

A unique record identifier

project_id

identifier_nullable · pattern: ^\d+$

A unique record identifier

sales_invoice_id

identifier_nullable · pattern: ^\d+$

A unique record identifier

user_id

identifier · pattern: ^\d+$

A unique record identifier

started_at

timestamp · date-time

description

string

paused_duration

integer

billable

boolean | null

created_at

timestamp · date-time

updated_at

timestamp · date-time

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

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

Example Request Body

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

json

application/json

Example Responses

{
  "id": "502878469348132722",
  "administration_id": 123,
  "contact_id": "502878469342889839",
  "project_id": "502878469344986992",
  "sales_invoice_id": null,
  "user_id": "502878423469786213",
  "started_at": "2026-11-04T14:25:00.000Z",
  "ended_at": "2026-11-04T15:25:00.000Z",
  "description": "Updated description",
  "paused_duration": 0,
  "billable": true,
  "created_at": "2026-11-04T14:25:02.211Z",
  "updated_at": "2026-11-04T14:25:02.218Z",
  "contact": {
    "id": "502878469342889839",
    "firstname": null,
    "lastname": null,
    "company_name": "Foobar Holding B.V."
  },
  "user": {
    "id": "502878423469786213",
    "name": "Moneybird",
    "created_at": "2026-11-04T14:24:18.450Z",
    "updated_at": "2026-11-04T14:24:18.559Z"
  },
  "project": {
    "id": "502878469344986992",
    "name": "Project 1",
    "state": "active",
    "budget": 10
  },
  "sales_invoice": null,
  "events": [
    {
      "administration_id": 123,
      "user_id": "502878423469786213",
      "action": "time_entry_created",
      "link_entity_id": null,
      "link_entity_type": null,
      "data": {},
      "created_at": "2026-11-04T14:25:02.212Z",
      "updated_at": "2026-11-04T14:25:02.212Z"
    },
    {
      "administration_id": 123,
      "user_id": "502878423469786213",
      "action": "time_entry_updated",
      "link_entity_id": null,
      "link_entity_type": null,
      "data": {
        "description": [
          "Designing the website",
          "Updated description"
        ],
        "updated_at": [
          "2026-11-04T15:25:02.211+01:00",
          "2026-11-04T15:25:02.218+01:00"
        ]
      },
      "created_at": "2026-11-04T14:25:02.218Z",
      "updated_at": "2026-11-04T14:25:02.218Z"
    }
  ],
  "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. When the time entry belongs to another user than the user of the token, the token also needs the sales_invoices scope. A time entry that is on a sales invoice cannot be deleted.

Required scope(s)

time_entries

Delete a time entry › 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

Delete a time entry › Responses

Time entry deleted

No data returned

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.

Required scope(s)

time_entries

Destroys note from entity › path Parameters

administration_id

administration_id · pattern: ^\d+$ · required

The unique identifier of the administration

A unique record identifier

time_entry_id

identifier · pattern: ^\d+$ · required

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

Destroys note from entity › Responses

Note deleted

No data returned

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.

Required scope(s)

time_entries

Adds note to entity › path Parameters

administration_id

administration_id · pattern: ^\d+$ · required

The unique identifier of the administration

A unique record identifier

time_entry_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

Adds note to entity › Request Body

object

Adds note to entity › 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}/time_entries/{time_entry_id}/notes{format}

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

Example Request Body

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

json

application/json

Example Responses

{
  "id": "502878469423630214",
  "administration_id": 123,
  "entity_id": "502878469415241604",
  "entity_type": "TimeEntry",
  "user_id": "502878423469786213",
  "assignee_id": "502878469405804414",
  "todo": true,
  "note": "Text of the note",
  "completed_at": null,
  "completed_by_id": null,
  "todo_type": null,
  "data": {},
  "created_at": "2026-11-04T14:25:02.283Z",
  "updated_at": "2026-11-04T14:25:02.283Z"
}

json

application/json

List all time entries

GET

https://moneybird.com/api/v2

/{administration_id}/time_entries{format}

Returns a paginated list of time entries in the administration.

Required scope(s)

time_entries

List all time entries › 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 time entries › query Parameters

filter

string

Filters are key:value terms separated by commas (e.g. period:this_year,state:all). Any filter you pass replaces the defaults below entirely, so include every key you need. Available filters:

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_week`, `prev_week`, `next_week`, `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`). A custom period must have a start and an end date. It must not be longer than 10 years and must be between `20000101` and `21000101`. For one month, use `202401..202401`, not `202401`. Without `period`, the filter does not limit the dates. The default `this_year` applies only when you send no `filter`.
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.

Default: period:this_year

page

integer | string

per_page

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

query

string

Free-text search across the time entry description.

List all time entries › Responses

A list of time entries

time_entry_response[]

id

identifier · pattern: ^\d+$

A unique record identifier

administration_id

administration_id · pattern: ^\d+$

A unique record identifier

contact_id

identifier_nullable · pattern: ^\d+$

A unique record identifier

project_id

identifier_nullable · pattern: ^\d+$

A unique record identifier

sales_invoice_id

identifier_nullable · pattern: ^\d+$

A unique record identifier

user_id

identifier · pattern: ^\d+$

A unique record identifier

started_at

timestamp · date-time

description

string

paused_duration

integer

billable

boolean | null

created_at

timestamp · date-time

updated_at

timestamp · date-time

GET/{administration_id}/time_entries{format}

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

Example Responses

[
  {
    "id": "502878469654316995",
    "administration_id": 123,
    "contact_id": "502878469650122688",
    "project_id": "502878469652219841",
    "sales_invoice_id": null,
    "user_id": "502878423469786213",
    "started_at": "2026-11-04T14:25:00.000Z",
    "ended_at": "2026-11-04T15:25:00.000Z",
    "description": "Designing the website",
    "paused_duration": 0,
    "billable": true,
    "created_at": "2026-11-04T14:25:02.504Z",
    "updated_at": "2026-11-04T14:25:02.504Z",
    "contact": {
      "id": "502878469650122688",
      "firstname": null,
      "lastname": null,
      "company_name": "Foobar Holding B.V."
    },
    "user": {
      "id": "502878423469786213",
      "name": "Moneybird",
      "created_at": "2026-11-04T14:24:18.450Z",
      "updated_at": "2026-11-04T14:24:18.559Z"
    },
    "project": {
      "id": "502878469652219841",
      "name": "Project 1",
      "state": "active",
      "budget": 10
    },
    "sales_invoice": null,
    "events": [
      {
        "administration_id": 123,
        "user_id": "502878423469786213",
        "action": "time_entry_created",
        "link_entity_id": null,
        "link_entity_type": null,
        "data": {},
        "created_at": "2026-11-04T14:25:02.505Z",
        "updated_at": "2026-11-04T14:25:02.505Z"
      }
    ],
    "notes": []
  }
]

json

application/json

Create a time entry

POST

https://moneybird.com/api/v2

/{administration_id}/time_entries{format}

API to post a time entry. Used to create time entries to record time spent by an employee. 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.

Required scope(s)

time_entries

Create a time entry › 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

Create a time entry › Request Body

object

Create a time entry › Responses

Time entry created

id

identifier · pattern: ^\d+$

A unique record identifier

administration_id

administration_id · pattern: ^\d+$

A unique record identifier

contact_id

identifier_nullable · pattern: ^\d+$

A unique record identifier

project_id

identifier_nullable · pattern: ^\d+$

A unique record identifier

sales_invoice_id

identifier_nullable · pattern: ^\d+$

A unique record identifier

user_id

identifier · pattern: ^\d+$

A unique record identifier

started_at

timestamp · date-time

description

string

paused_duration

integer

billable

boolean | null

created_at

timestamp · date-time

updated_at

timestamp · date-time