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": "499054030077559902",
  "administration_id": 123,
  "contact_id": null,
  "project_id": null,
  "sales_invoice_id": null,
  "user_id": "499053793376207973",
  "started_at": "2026-09-23T08:17:00.000Z",
  "ended_at": null,
  "description": "Designing the website",
  "paused_duration": 0,
  "billable": true,
  "created_at": "2026-09-23T09:17:12.705Z",
  "updated_at": "2026-09-23T09:17:12.723Z",
  "contact": null,
  "user": {
    "id": "499053793376207973",
    "name": "Moneybird",
    "created_at": "2026-09-23T09:13:26.953Z",
    "updated_at": "2026-09-23T09:13:27.211Z"
  },
  "project": null,
  "sales_invoice": null,
  "events": [
    {
      "administration_id": 123,
      "user_id": "499053793376207973",
      "action": "time_entry_created",
      "link_entity_id": null,
      "link_entity_type": null,
      "data": {},
      "created_at": "2026-09-23T09:17:12.707Z",
      "updated_at": "2026-09-23T09:17:12.707Z"
    },
    {
      "administration_id": 123,
      "user_id": "499053793376207973",
      "action": "time_entry_updated",
      "link_entity_id": null,
      "link_entity_type": null,
      "data": {
        "ended_at": [
          "2026-09-23T11:17:00.000+02:00",
          null
        ],
        "updated_at": [
          "2026-09-23T11:17:12.705+02:00",
          "2026-09-23T11:17:12.723+02:00"
        ]
      },
      "created_at": "2026-09-23T09:17:12.725Z",
      "updated_at": "2026-09-23T09:17:12.725Z"
    }
  ],
  "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.

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": "499054029738869819",
  "administration_id": 123,
  "contact_id": null,
  "project_id": null,
  "sales_invoice_id": null,
  "user_id": "499053793376207973",
  "started_at": "2026-09-23T09:17:00.000Z",
  "ended_at": "2026-09-23T09:17:00.000Z",
  "description": "Designing the website",
  "paused_duration": 0,
  "billable": true,
  "created_at": "2026-09-23T09:17:12.381Z",
  "updated_at": "2026-09-23T09:17:12.399Z",
  "contact": null,
  "user": {
    "id": "499053793376207973",
    "name": "Moneybird",
    "created_at": "2026-09-23T09:13:26.953Z",
    "updated_at": "2026-09-23T09:13:27.211Z"
  },
  "project": null,
  "sales_invoice": null,
  "events": [
    {
      "administration_id": 123,
      "user_id": "499053793376207973",
      "action": "time_entry_created",
      "link_entity_id": null,
      "link_entity_type": null,
      "data": {},
      "created_at": "2026-09-23T09:17:12.383Z",
      "updated_at": "2026-09-23T09:17:12.383Z"
    },
    {
      "administration_id": 123,
      "user_id": "499053793376207973",
      "action": "time_entry_updated",
      "link_entity_id": null,
      "link_entity_type": null,
      "data": {
        "ended_at": [
          null,
          "2026-09-23T11:17:00.000+02:00"
        ],
        "updated_at": [
          "2026-09-23T11:17:12.381+02:00",
          "2026-09-23T11:17:12.399+02:00"
        ]
      },
      "created_at": "2026-09-23T09:17:12.400Z",
      "updated_at": "2026-09-23T09:17:12.400Z"
    }
  ],
  "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.

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": "499054029623526451",
  "administration_id": 123,
  "contact_id": "499054029610943536",
  "project_id": "499054029615137841",
  "sales_invoice_id": null,
  "user_id": "499053793376207973",
  "started_at": "2026-09-23T09:17:00.000Z",
  "ended_at": "2026-09-23T10:17:00.000Z",
  "description": "Designing the website",
  "paused_duration": 0,
  "billable": true,
  "created_at": "2026-09-23T09:17:12.271Z",
  "updated_at": "2026-09-23T09:17:12.271Z",
  "contact": {
    "id": "499054029610943536",
    "firstname": null,
    "lastname": null,
    "company_name": "Foobar Holding B.V."
  },
  "user": {
    "id": "499053793376207973",
    "name": "Moneybird",
    "created_at": "2026-09-23T09:13:26.953Z",
    "updated_at": "2026-09-23T09:13:27.211Z"
  },
  "project": {
    "id": "499054029615137841",
    "name": "Project 1",
    "state": "active",
    "budget": 10
  },
  "events": [
    {
      "administration_id": 123,
      "user_id": "499053793376207973",
      "action": "time_entry_created",
      "link_entity_id": null,
      "link_entity_type": null,
      "data": {},
      "created_at": "2026-09-23T09:17:12.273Z",
      "updated_at": "2026-09-23T09:17:12.273Z"
    }
  ],
  "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.

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

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.

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": "499054029503988774",
  "administration_id": 123,
  "contact_id": "499054029489308707",
  "project_id": "499054029494551588",
  "sales_invoice_id": null,
  "user_id": "499053793376207973",
  "started_at": "2026-09-23T09:17:00.000Z",
  "ended_at": "2026-09-23T10:17:00.000Z",
  "description": "Updated description",
  "paused_duration": 0,
  "billable": true,
  "created_at": "2026-09-23T09:17:12.157Z",
  "updated_at": "2026-09-23T09:17:12.175Z",
  "contact": {
    "id": "499054029489308707",
    "firstname": null,
    "lastname": null,
    "company_name": "Foobar Holding B.V."
  },
  "user": {
    "id": "499053793376207973",
    "name": "Moneybird",
    "created_at": "2026-09-23T09:13:26.953Z",
    "updated_at": "2026-09-23T09:13:27.211Z"
  },
  "project": {
    "id": "499054029494551588",
    "name": "Project 1",
    "state": "active",
    "budget": 10
  },
  "sales_invoice": null,
  "events": [
    {
      "administration_id": 123,
      "user_id": "499053793376207973",
      "action": "time_entry_created",
      "link_entity_id": null,
      "link_entity_type": null,
      "data": {},
      "created_at": "2026-09-23T09:17:12.159Z",
      "updated_at": "2026-09-23T09:17:12.159Z"
    },
    {
      "administration_id": 123,
      "user_id": "499053793376207973",
      "action": "time_entry_updated",
      "link_entity_id": null,
      "link_entity_type": null,
      "data": {
        "description": [
          "Designing the website",
          "Updated description"
        ],
        "updated_at": [
          "2026-09-23T11:17:12.157+02:00",
          "2026-09-23T11:17:12.175+02:00"
        ]
      },
      "created_at": "2026-09-23T09:17:12.177Z",
      "updated_at": "2026-09-23T09:17:12.177Z"
    }
  ],
  "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.

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": 499054029847921700,
    "todo": true
  }
}'

Example Request Body

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

json

application/json

Example Responses

{
  "id": "499054029887767628",
  "administration_id": 123,
  "entity_id": "499054029870990410",
  "entity_type": "TimeEntry",
  "user_id": "499053793376207973",
  "assignee_id": "499054029847921732",
  "todo": true,
  "note": "Text of the note",
  "completed_at": null,
  "completed_by_id": null,
  "todo_type": null,
  "data": {},
  "created_at": "2026-09-23T09:17:12.524Z",
  "updated_at": "2026-09-23T09:17:12.524Z"
}

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 — in particular pass an explicit period (a named period or a YYYYMMDD..YYYYMMDD range) to look beyond the default financial year. 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`)
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": "499054028142938030",
    "administration_id": 123,
    "contact_id": "499054028130355115",
    "project_id": "499054028134549420",
    "sales_invoice_id": null,
    "user_id": "499053793376207973",
    "started_at": "2026-09-23T09:17:00.000Z",
    "ended_at": "2026-09-23T10:17:00.000Z",
    "description": "Designing the website",
    "paused_duration": 0,
    "billable": true,
    "created_at": "2026-09-23T09:17:10.860Z",
    "updated_at": "2026-09-23T09:17:10.860Z",
    "contact": {
      "id": "499054028130355115",
      "firstname": null,
      "lastname": null,
      "company_name": "Foobar Holding B.V."
    },
    "user": {
      "id": "499053793376207973",
      "name": "Moneybird",
      "created_at": "2026-09-23T09:13:26.953Z",
      "updated_at": "2026-09-23T09:13:27.211Z"
    },
    "project": {
      "id": "499054028134549420",
      "name": "Project 1",
      "state": "active",
      "budget": 10
    },
    "sales_invoice": null,
    "events": [
      {
        "administration_id": 123,
        "user_id": "499053793376207973",
        "action": "time_entry_created",
        "link_entity_id": null,
        "link_entity_type": null,
        "data": {},
        "created_at": "2026-09-23T09:17:10.861Z",
        "updated_at": "2026-09-23T09:17:10.861Z"
      }
    ],
    "notes": []
  },
  {
    "id": "499054028160763825",
    "administration_id": 123,
    "contact_id": null,
    "project_id": null,
    "sales_invoice_id": null,
    "user_id": 1,
    "started_at": "2026-09-23T09:17:00.000Z",
    "ended_at": "2026-09-23T10:17:00.000Z",
    "description": "Designing the website",
    "paused_duration": 0,
    "billable": false,
    "created_at": "2026-09-23T09:17:10.877Z",
    "updated_at": "2026-09-23T09:17:10.877Z",
    "contact": null,
    "user": {
      "id": 1,
      "name": "Edwin Vlieg",
      "created_at": "2026-09-23T09:17:10.869Z",
      "updated_at": "2026-09-23T09:17:10.873Z"
    },
    "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": "2026-09-23T09:17:10.878Z",
        "updated_at": "2026-09-23T09:17:10.878Z"
      }
    ],
    "notes": []
  },
  {
    "id": "499054028178589620",
    "administration_id": 123,
    "contact_id": null,
    "project_id": null,
    "sales_invoice_id": null,
    "user_id": 2,
    "started_at": "2026-09-23T09:17:00.000Z",
    "ended_at": "2026-09-23T10:17:00.000Z",
    "description": "Designing the website",
    "paused_duration": 0,
    "billable": true,
    "created_at": "2026-09-23T09:17:10.893Z",
    "updated_at": "2026-09-23T09:17:10.893Z",
    "contact": null,
    "user": {
      "id": 2,
      "name": "Edwin Vlieg",
      "created_at": "2026-09-23T09:17:10.886Z",
      "updated_at": "2026-09-23T09:17:10.890Z"
    },
    "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": "2026-09-23T09:17:10.895Z",
        "updated_at": "2026-09-23T09:17:10.895Z"
      }
    ],
    "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