Time entries

cURL Ruby

List all time entries

GET /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.

Parameters

Parameter Type Description
filter String
per_page Integer
query String

Allows filtering by time entry description.

Example: returns all time entries of an administration

Request

curl -s -H "Content-Type: application/json" -H "Authorization: Bearer 84ec207ad0154a508f798e615a998ac1fd752926d00f955fb1df3e144cba44ab" \
  -XGET \
  https://moneybird.com/api/v2/123/time_entries.json?

Response

        
          
          Status: 200 OK
        
      
[
  {
    "id": "451599650189739395",
    "administration_id": 123,
    "contact_id": "451599650162476415",
    "project_id": "451599650176107905",
    "sales_invoice_id": null,
    "user_id": 1744898730990,
    "started_at": "2025-04-17T14:10:00.000Z",
    "ended_at": "2025-04-17T15:10:00.000Z",
    "description": "Test",
    "paused_duration": 0,
    "billable": true,
    "created_at": "2025-04-17T14:10:09.405Z",
    "updated_at": "2025-04-17T14:10:09.405Z",
    "contact": {
      "id": "451599650162476415",
      "firstname": "",
      "lastname": "",
      "company_name": "Foobar Holding B.V."
    },
    "detail": null,
    "user": {
      "id": 1744898730990,
      "name": "Moneybird",
      "created_at": "2025-04-17T14:05:30.282Z",
      "updated_at": "2025-04-17T14:05:30.482Z"
    },
    "project": {
      "id": "451599650176107905",
      "name": "My project name",
      "state": "active",
      "budget": 10
    },
    "sales_invoice": null,
    "events": [
      {
        "administration_id": 123,
        "user_id": 1744898730990,
        "action": "time_entry_created",
        "link_entity_id": null,
        "link_entity_type": null,
        "data": {},
        "created_at": "2025-04-17T14:10:09.408Z",
        "updated_at": "2025-04-17T14:10:09.408Z"
      }
    ],
    "notes": []
  },
  {
    "id": "451599650202322309",
    "administration_id": 123,
    "contact_id": null,
    "project_id": null,
    "sales_invoice_id": null,
    "user_id": 1744898730990,
    "started_at": "2025-04-17T14:10:00.000Z",
    "ended_at": "2025-04-17T14:11:00.000Z",
    "description": "Test",
    "paused_duration": 0,
    "billable": false,
    "created_at": "2025-04-17T14:10:09.417Z",
    "updated_at": "2025-04-17T14:10:09.417Z",
    "contact": null,
    "detail": null,
    "user": {
      "id": 1744898730990,
      "name": "Moneybird",
      "created_at": "2025-04-17T14:05:30.282Z",
      "updated_at": "2025-04-17T14:05:30.482Z"
    },
    "project": null,
    "sales_invoice": null,
    "events": [
      {
        "administration_id": 123,
        "user_id": 1744898730990,
        "action": "time_entry_created",
        "link_entity_id": null,
        "link_entity_type": null,
        "data": {},
        "created_at": "2025-04-17T14:10:09.418Z",
        "updated_at": "2025-04-17T14:10:09.418Z"
      }
    ],
    "notes": []
  },
  {
    "id": "451599650215953799",
    "administration_id": 123,
    "contact_id": null,
    "project_id": null,
    "sales_invoice_id": null,
    "user_id": 1744898730990,
    "started_at": "2025-04-17T14:10:00.000Z",
    "ended_at": "2025-04-17T14:11:00.000Z",
    "description": "Test",
    "paused_duration": 0,
    "billable": true,
    "created_at": "2025-04-17T14:10:09.430Z",
    "updated_at": "2025-04-17T14:10:09.430Z",
    "contact": null,
    "detail": null,
    "user": {
      "id": 1744898730990,
      "name": "Moneybird",
      "created_at": "2025-04-17T14:05:30.282Z",
      "updated_at": "2025-04-17T14:05:30.482Z"
    },
    "project": null,
    "sales_invoice": null,
    "events": [
      {
        "administration_id": 123,
        "user_id": 1744898730990,
        "action": "time_entry_created",
        "link_entity_id": null,
        "link_entity_type": null,
        "data": {},
        "created_at": "2025-04-17T14:10:09.432Z",
        "updated_at": "2025-04-17T14:10:09.432Z"
      }
    ],
    "notes": []
  }
]

Example: returns all time entries filtered on period

Request

curl -s -H "Content-Type: application/json" -H "Authorization: Bearer 84ec207ad0154a508f798e615a998ac1fd752926d00f955fb1df3e144cba44ab" \
  -XGET \
  https://moneybird.com/api/v2/123/time_entries.json?filter=period%3Athis_month

Response

        
          
          Status: 200 OK
        
      
[
  {
    "id": "451599650434057615",
    "administration_id": 123,
    "contact_id": "451599650371143051",
    "project_id": "451599650410988941",
    "sales_invoice_id": null,
    "user_id": 1744898730990,
    "started_at": "2025-04-17T14:10:00.000Z",
    "ended_at": "2025-04-17T15:10:00.000Z",
    "description": "Test",
    "paused_duration": 0,
    "billable": true,
    "created_at": "2025-04-17T14:10:09.638Z",
    "updated_at": "2025-04-17T14:10:09.638Z",
    "contact": {
      "id": "451599650371143051",
      "firstname": "",
      "lastname": "",
      "company_name": "Foobar Holding B.V."
    },
    "detail": null,
    "user": {
      "id": 1744898730990,
      "name": "Moneybird",
      "created_at": "2025-04-17T14:05:30.282Z",
      "updated_at": "2025-04-17T14:05:30.482Z"
    },
    "project": {
      "id": "451599650410988941",
      "name": "My project name",
      "state": "active",
      "budget": 10
    },
    "sales_invoice": null,
    "events": [
      {
        "administration_id": 123,
        "user_id": 1744898730990,
        "action": "time_entry_created",
        "link_entity_id": null,
        "link_entity_type": null,
        "data": {},
        "created_at": "2025-04-17T14:10:09.640Z",
        "updated_at": "2025-04-17T14:10:09.640Z"
      }
    ],
    "notes": []
  },
  {
    "id": "451599650447689105",
    "administration_id": 123,
    "contact_id": null,
    "project_id": null,
    "sales_invoice_id": null,
    "user_id": 1744898730990,
    "started_at": "2025-04-17T14:10:00.000Z",
    "ended_at": "2025-04-17T14:11:00.000Z",
    "description": "Test",
    "paused_duration": 0,
    "billable": false,
    "created_at": "2025-04-17T14:10:09.651Z",
    "updated_at": "2025-04-17T14:10:09.651Z",
    "contact": null,
    "detail": null,
    "user": {
      "id": 1744898730990,
      "name": "Moneybird",
      "created_at": "2025-04-17T14:05:30.282Z",
      "updated_at": "2025-04-17T14:05:30.482Z"
    },
    "project": null,
    "sales_invoice": null,
    "events": [
      {
        "administration_id": 123,
        "user_id": 1744898730990,
        "action": "time_entry_created",
        "link_entity_id": null,
        "link_entity_type": null,
        "data": {},
        "created_at": "2025-04-17T14:10:09.652Z",
        "updated_at": "2025-04-17T14:10:09.652Z"
      }
    ],
    "notes": []
  },
  {
    "id": "451599650460272019",
    "administration_id": 123,
    "contact_id": null,
    "project_id": null,
    "sales_invoice_id": null,
    "user_id": 1744898730990,
    "started_at": "2025-04-17T14:10:00.000Z",
    "ended_at": "2025-04-17T14:11:00.000Z",
    "description": "Test",
    "paused_duration": 0,
    "billable": true,
    "created_at": "2025-04-17T14:10:09.663Z",
    "updated_at": "2025-04-17T14:10:09.663Z",
    "contact": null,
    "detail": null,
    "user": {
      "id": 1744898730990,
      "name": "Moneybird",
      "created_at": "2025-04-17T14:05:30.282Z",
      "updated_at": "2025-04-17T14:05:30.482Z"
    },
    "project": null,
    "sales_invoice": null,
    "events": [
      {
        "administration_id": 123,
        "user_id": 1744898730990,
        "action": "time_entry_created",
        "link_entity_id": null,
        "link_entity_type": null,
        "data": {},
        "created_at": "2025-04-17T14:10:09.664Z",
        "updated_at": "2025-04-17T14:10:09.664Z"
      }
    ],
    "notes": []
  }
]

Example: returns all time entries filtered on search query

Request

curl -s -H "Content-Type: application/json" -H "Authorization: Bearer 84ec207ad0154a508f798e615a998ac1fd752926d00f955fb1df3e144cba44ab" \
  -XGET \
  https://moneybird.com/api/v2/123/time_entries.json?query=Custom

Response

        
          
          Status: 200 OK
        
      
[
  {
    "id": "451599653512676771",
    "administration_id": 123,
    "contact_id": null,
    "project_id": null,
    "sales_invoice_id": null,
    "user_id": 1744898730990,
    "started_at": "2025-04-17T14:10:00.000Z",
    "ended_at": "2025-04-17T14:11:00.000Z",
    "description": "Custom description",
    "paused_duration": 0,
    "billable": true,
    "created_at": "2025-04-17T14:10:12.574Z",
    "updated_at": "2025-04-17T14:10:12.574Z",
    "contact": null,
    "detail": null,
    "user": {
      "id": 1744898730990,
      "name": "Moneybird",
      "created_at": "2025-04-17T14:05:30.282Z",
      "updated_at": "2025-04-17T14:05:30.482Z"
    },
    "project": null,
    "sales_invoice": null,
    "events": [
      {
        "administration_id": 123,
        "user_id": 1744898730990,
        "action": "time_entry_created",
        "link_entity_id": null,
        "link_entity_type": null,
        "data": {},
        "created_at": "2025-04-17T14:10:12.575Z",
        "updated_at": "2025-04-17T14:10:12.575Z"
      }
    ],
    "notes": []
  }
]

Example: returns all time entries filtered on state

Request

curl -s -H "Content-Type: application/json" -H "Authorization: Bearer 84ec207ad0154a508f798e615a998ac1fd752926d00f955fb1df3e144cba44ab" \
  -XGET \
  https://moneybird.com/api/v2/123/time_entries.json?filter=state%3Anon_billable

Response

        
          
          Status: 200 OK
        
      
[
  {
    "id": "451599653727634861",
    "administration_id": 123,
    "contact_id": null,
    "project_id": null,
    "sales_invoice_id": null,
    "user_id": 1744898730990,
    "started_at": "2025-04-17T14:10:00.000Z",
    "ended_at": "2025-04-17T14:11:00.000Z",
    "description": "Test",
    "paused_duration": 0,
    "billable": false,
    "created_at": "2025-04-17T14:10:12.779Z",
    "updated_at": "2025-04-17T14:10:12.779Z",
    "contact": null,
    "detail": null,
    "user": {
      "id": 1744898730990,
      "name": "Moneybird",
      "created_at": "2025-04-17T14:05:30.282Z",
      "updated_at": "2025-04-17T14:05:30.482Z"
    },
    "project": null,
    "sales_invoice": null,
    "events": [
      {
        "administration_id": 123,
        "user_id": 1744898730990,
        "action": "time_entry_created",
        "link_entity_id": null,
        "link_entity_type": null,
        "data": {},
        "created_at": "2025-04-17T14:10:12.781Z",
        "updated_at": "2025-04-17T14:10:12.781Z"
      }
    ],
    "notes": []
  }
]

Example: returns paginated time entries on page 1

Request

curl -s -H "Content-Type: application/json" -H "Authorization: Bearer 84ec207ad0154a508f798e615a998ac1fd752926d00f955fb1df3e144cba44ab" \
  -XGET \
  https://moneybird.com/api/v2/123/time_entries.json?per_page=1

Response

        
          
          Status: 200 OK
        
      
[
  {
    "id": "451599653895407031",
    "administration_id": 123,
    "contact_id": "451599653862901171",
    "project_id": "451599653878629813",
    "sales_invoice_id": null,
    "user_id": 1744898730990,
    "started_at": "2025-04-17T14:10:00.000Z",
    "ended_at": "2025-04-17T15:10:00.000Z",
    "description": "Test",
    "paused_duration": 0,
    "billable": true,
    "created_at": "2025-04-17T14:10:12.939Z",
    "updated_at": "2025-04-17T14:10:12.939Z",
    "contact": {
      "id": "451599653862901171",
      "firstname": "",
      "lastname": "",
      "company_name": "Foobar Holding B.V."
    },
    "detail": null,
    "user": {
      "id": 1744898730990,
      "name": "Moneybird",
      "created_at": "2025-04-17T14:05:30.282Z",
      "updated_at": "2025-04-17T14:05:30.482Z"
    },
    "project": {
      "id": "451599653878629813",
      "name": "My project name",
      "state": "active",
      "budget": 10
    },
    "sales_invoice": null,
    "events": [
      {
        "administration_id": 123,
        "user_id": 1744898730990,
        "action": "time_entry_created",
        "link_entity_id": null,
        "link_entity_type": null,
        "data": {},
        "created_at": "2025-04-17T14:10:12.942Z",
        "updated_at": "2025-04-17T14:10:12.942Z"
      }
    ],
    "notes": []
  }
]

Example: returns paginated time entries on page 2

Request

curl -s -H "Content-Type: application/json" -H "Authorization: Bearer 84ec207ad0154a508f798e615a998ac1fd752926d00f955fb1df3e144cba44ab" \
  -XGET \
  https://moneybird.com/api/v2/123/time_entries.json?page=2&per_page=1

Response

        
          
          Status: 200 OK
        
      
[
  {
    "id": "451599654083102149",
    "administration_id": 123,
    "contact_id": null,
    "project_id": null,
    "sales_invoice_id": null,
    "user_id": 1744898730990,
    "started_at": "2025-04-17T14:10:00.000Z",
    "ended_at": "2025-04-17T14:11:00.000Z",
    "description": "Test",
    "paused_duration": 0,
    "billable": false,
    "created_at": "2025-04-17T14:10:13.118Z",
    "updated_at": "2025-04-17T14:10:13.118Z",
    "contact": null,
    "detail": null,
    "user": {
      "id": 1744898730990,
      "name": "Moneybird",
      "created_at": "2025-04-17T14:05:30.282Z",
      "updated_at": "2025-04-17T14:05:30.482Z"
    },
    "project": null,
    "sales_invoice": null,
    "events": [
      {
        "administration_id": 123,
        "user_id": 1744898730990,
        "action": "time_entry_created",
        "link_entity_id": null,
        "link_entity_type": null,
        "data": {},
        "created_at": "2025-04-17T14:10:13.120Z",
        "updated_at": "2025-04-17T14:10:13.120Z"
      }
    ],
    "notes": []
  }
]

Example: returns an error when too many time entries are requested

Request

curl -s -H "Content-Type: application/json" -H "Authorization: Bearer 84ec207ad0154a508f798e615a998ac1fd752926d00f955fb1df3e144cba44ab" \
  -XGET \
  https://moneybird.com/api/v2/123/time_entries.json?per_page=101

Response

        
          
          Status: 400 Bad Request
        
      
{
  "error": "per_page does not have a valid value"
}

Example: returns an error message if filter contact_id is not found

Request

curl -s -H "Content-Type: application/json" -H "Authorization: Bearer 84ec207ad0154a508f798e615a998ac1fd752926d00f955fb1df3e144cba44ab" \
  -XGET \
  https://moneybird.com/api/v2/123/time_entries.json?filter=contact_id%3A123

Response

        
          
          Status: 404 Not Found
        
      
{
  "error": "record not found",
  "symbolic": {
    "contact_id": "not_found"
  }
}

Example: returns an error message if filter user_id is not found

Request

curl -s -H "Content-Type: application/json" -H "Authorization: Bearer 84ec207ad0154a508f798e615a998ac1fd752926d00f955fb1df3e144cba44ab" \
  -XGET \
  https://moneybird.com/api/v2/123/time_entries.json?filter=user_id%3A123

Response

        
          
          Status: 404 Not Found
        
      
{
  "error": "record not found",
  "symbolic": {
    "user_id": "not_found"
  }
}

Get a time entry by id

GET /time_entries/:id(.:format)

Returns a time entry in the administration.

Example: returns time entry by given id

Request

curl -s -H "Content-Type: application/json" -H "Authorization: Bearer 84ec207ad0154a508f798e615a998ac1fd752926d00f955fb1df3e144cba44ab" \
  -XGET \
  https://moneybird.com/api/v2/123/time_entries/451599654696519155.json?

Response

        
          
          Status: 200 OK
        
      
{
  "id": "451599654696519155",
  "administration_id": 123,
  "contact_id": "451599654671353327",
  "project_id": "451599654684984817",
  "sales_invoice_id": null,
  "user_id": 1744898730990,
  "started_at": "2025-04-17T14:10:00.000Z",
  "ended_at": "2025-04-17T15:10:00.000Z",
  "description": "Test",
  "paused_duration": 0,
  "billable": true,
  "created_at": "2025-04-17T14:10:13.703Z",
  "updated_at": "2025-04-17T14:10:13.703Z",
  "contact": {
    "id": "451599654671353327",
    "firstname": "",
    "lastname": "",
    "company_name": "Foobar Holding B.V."
  },
  "detail": null,
  "user": {
    "id": 1744898730990,
    "name": "Moneybird",
    "created_at": "2025-04-17T14:05:30.282Z",
    "updated_at": "2025-04-17T14:05:30.482Z"
  },
  "project": {
    "id": "451599654684984817",
    "name": "My project name",
    "state": "active",
    "budget": 10
  },
  "sales_invoice": null,
  "events": [
    {
      "administration_id": 123,
      "user_id": 1744898730990,
      "action": "time_entry_created",
      "link_entity_id": null,
      "link_entity_type": null,
      "data": {},
      "created_at": "2025-04-17T14:10:13.705Z",
      "updated_at": "2025-04-17T14:10:13.705Z"
    }
  ],
  "notes": []
}

Example: returns 404 when time entry does not exist

Request

curl -s -H "Content-Type: application/json" -H "Authorization: Bearer 84ec207ad0154a508f798e615a998ac1fd752926d00f955fb1df3e144cba44ab" \
  -XGET \
  https://moneybird.com/api/v2/123/time_entries/34123123.json?

Response

        
          
          Status: 404 Not Found
        
      
{
  "error": "record not found",
  "symbolic": {
    "id": "not_found"
  }
}

Create a time entry

POST /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.

Parameters

Parameter Type Description
time_entry[user_id] Integer

Required

Should be a valid user id.
time_entry[started_at] Datetime

Required
time_entry[ended_at] Datetime

Required.
time_entry[description] String

Required
time_entry[contact_id] Integer

Should be a valid contact id.
time_entry[project_id] Integer

Should be a valid project id.
time_entry[sales_invoice_id] Integer

Should be a valid sales invoice id.
time_entry[detail_id] Integer

Deprecated after 2025-07-31. Should be a valid detail id.
time_entry[billable] Boolean
time_entry[paused_duration] Integer

Total paused duration in seconds, is rounded down to full minutes.

Example: create a basic time entry

Request

curl -s -H "Content-Type: application/json" -H "Authorization: Bearer 84ec207ad0154a508f798e615a998ac1fd752926d00f955fb1df3e144cba44ab" \
  -XPOST \
  -d '{"time_entry":{"started_at":"2025-04-17 14:10:00 UTC","ended_at":"2025-04-17 15:10:00 UTC","description":"Test","contact_id":451599654993266175,"project_id":451599655006897665,"user_id":1744898730990,"billable":false}}' \
  https://moneybird.com/api/v2/123/time_entries

Response

        
          
          Status: 201 Created
        
      
{
  "id": "451599655069812227",
  "administration_id": 123,
  "contact_id": "451599654993266175",
  "project_id": "451599655006897665",
  "sales_invoice_id": null,
  "user_id": 1744898730990,
  "started_at": "2025-04-17T14:10:00.000Z",
  "ended_at": "2025-04-17T15:10:00.000Z",
  "description": "Test",
  "paused_duration": 0,
  "billable": false,
  "created_at": "2025-04-17T14:10:14.059Z",
  "updated_at": "2025-04-17T14:10:14.059Z",
  "contact": {
    "id": "451599654993266175",
    "firstname": "",
    "lastname": "",
    "company_name": "Foobar Holding B.V."
  },
  "detail": null,
  "user": {
    "id": 1744898730990,
    "name": "Moneybird",
    "created_at": "2025-04-17T14:05:30.282Z",
    "updated_at": "2025-04-17T14:05:30.482Z"
  },
  "project": {
    "id": "451599655006897665",
    "name": "My project name",
    "state": "active",
    "budget": 10
  },
  "sales_invoice": null,
  "events": [
    {
      "administration_id": 123,
      "user_id": 1744898730990,
      "action": "time_entry_created",
      "link_entity_id": null,
      "link_entity_type": null,
      "data": {},
      "created_at": "2025-04-17T14:10:14.061Z",
      "updated_at": "2025-04-17T14:10:14.061Z"
    }
  ],
  "notes": []
}

Example: returns an error when invalid details are provided

Request

curl -s -H "Content-Type: application/json" -H "Authorization: Bearer 84ec207ad0154a508f798e615a998ac1fd752926d00f955fb1df3e144cba44ab" \
  -XPOST \
  -d '{"time_entry":{"started_at":"2025-04-17 14:10:00 UTC","ended_at":"2025-04-17 13:10:00 UTC","user_id":1744898730990,"billable":false}}' \
  https://moneybird.com/api/v2/123/time_entries

Response

        
          
          Status: 422 Unprocessable Entity
        
      
{
  "error": {
    "ended_at": [
      "cannot be before the start time"
    ],
    "description": [
      "can't be blank"
    ]
  },
  "details": {
    "ended_at": [
      {
        "error": "ended_at_before_started_at"
      }
    ],
    "description": [
      {
        "error": "blank"
      }
    ]
  }
}

Update a time entry

PATCH /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.

Parameters

Parameter Type Description
time_entry[started_at] Datetime
time_entry[ended_at] Datetime

Required.
time_entry[paused_duration] Integer

Total paused duration in seconds, is rounded down to full minutes.
time_entry[contact_id] Integer

Should be a valid contact id.
time_entry[project_id] Integer

Should be a valid project id.
time_entry[sales_invoice_id] Integer

Should be a valid sales invoice id.
time_entry[description] String
time_entry[billable] Boolean

Example: updating the time entry description

Request

curl -s -H "Content-Type: application/json" -H "Authorization: Bearer 84ec207ad0154a508f798e615a998ac1fd752926d00f955fb1df3e144cba44ab" \
  -XPATCH \
  -d '{"time_entry":{"description":"Updated description"}}' \
  https://moneybird.com/api/v2/123/time_entries/451599655278478859

Response

        
          
          Status: 200 OK
        
      
{
  "id": "451599655278478859",
  "administration_id": 123,
  "contact_id": "451599655253313031",
  "project_id": "451599655264847369",
  "sales_invoice_id": null,
  "user_id": 1744898730990,
  "started_at": "2025-04-17T14:10:00.000Z",
  "ended_at": "2025-04-17T15:10:00.000Z",
  "description": "Updated description",
  "paused_duration": 0,
  "billable": true,
  "created_at": "2025-04-17T14:10:14.257Z",
  "updated_at": "2025-04-17T14:10:14.323Z",
  "contact": {
    "id": "451599655253313031",
    "firstname": "",
    "lastname": "",
    "company_name": "Foobar Holding B.V."
  },
  "detail": null,
  "user": {
    "id": 1744898730990,
    "name": "Moneybird",
    "created_at": "2025-04-17T14:05:30.282Z",
    "updated_at": "2025-04-17T14:05:30.482Z"
  },
  "project": {
    "id": "451599655264847369",
    "name": "My project name",
    "state": "active",
    "budget": 10
  },
  "sales_invoice": null,
  "events": [
    {
      "administration_id": 123,
      "user_id": 1744898730990,
      "action": "time_entry_created",
      "link_entity_id": null,
      "link_entity_type": null,
      "data": {},
      "created_at": "2025-04-17T14:10:14.260Z",
      "updated_at": "2025-04-17T14:10:14.260Z"
    },
    {
      "administration_id": 123,
      "user_id": 1744898730990,
      "action": "time_entry_updated",
      "link_entity_id": null,
      "link_entity_type": null,
      "data": {
        "description": [
          "Test",
          "Updated description"
        ],
        "updated_at": [
          "2025-04-17T16:10:14.257+02:00",
          "2025-04-17T16:10:14.323+02:00"
        ]
      },
      "created_at": "2025-04-17T14:10:14.327Z",
      "updated_at": "2025-04-17T14:10:14.327Z"
    }
  ],
  "notes": []
}

Delete a time entry

DELETE /time_entries/:id(.:format)

Example: deletes given time entry

Request

curl -s -H "Content-Type: application/json" -H "Authorization: Bearer 84ec207ad0154a508f798e615a998ac1fd752926d00f955fb1df3e144cba44ab" \
  -XDELETE \
  -d '{}' \
  https://moneybird.com/api/v2/123/time_entries/451599655475611156.json

Response

        
          
          Status: 204 No Content

Adds note to entity

POST /time_entries/:time_entry_id/notes(.:format)

Parameters

Parameter Type Description
note[note] String

Required. Text for the note or to-do.
note[todo] Boolean

If true the note is a to-do.
note[assignee_id] Integer

Assign to-do to user. Should be a valid user id. If assignee_id is provided the note will be a to-do.

Example: create a note

Request

curl -s -H "Content-Type: application/json" -H "Authorization: Bearer 84ec207ad0154a508f798e615a998ac1fd752926d00f955fb1df3e144cba44ab" \
  -XPOST \
  -d '{"note":{"note":"Text of the note","assignee_id":451599655609828887,"todo":true}}' \
  https://moneybird.com/api/v2/123/time_entries/451599655665403423/notes.json

Response

        
          
          Status: 201 Created
        
      
{
  "id": "451599655744046625",
  "administration_id": 123,
  "entity_id": "451599655665403423",
  "entity_type": "TimeEntry",
  "user_id": 1744898730990,
  "assignee_id": "451599655609828887",
  "todo": true,
  "note": "Text of the note",
  "completed_at": null,
  "completed_by_id": null,
  "todo_type": null,
  "data": {},
  "created_at": "2025-04-17T14:10:14.698Z",
  "updated_at": "2025-04-17T14:10:14.698Z"
}

Destroys note from entity

DELETE /time_entries/:time_entry_id/notes/:id(.:format)

Example: destroy a note

Request

curl -s -H "Content-Type: application/json" -H "Authorization: Bearer 84ec207ad0154a508f798e615a998ac1fd752926d00f955fb1df3e144cba44ab" \
  -XDELETE \
  -d '{}' \
  https://moneybird.com/api/v2/123/time_entries/451599655843661353/notes/451599655854147115.json

Response

        
          
          Status: 204 No Content