Skip to main content
GET
https://api.plane.com/v1
/
time-entries
List time entries
curl --request GET \
  --url https://api.plane.com/v1/time-entries \
  --header 'Authorization: Bearer <token>'
{
  "time_entries": [
    {
      "id": "tme_1HPCXADYAhh5k1NMU0r1WUqs",
      "worker": "wr_CgcLakmx4guire",
      "date": "2024-03-17",
      "duration": "8.0",
      "note": null,
      "created": "2024-03-17T10:30:00Z"
    },
    { "id": "tme_..." },
    { "id": "tme_..." }
  ]
}

​
Parameters

​
limit
string
A limit on the number of objects to be returned. Limit can range between 1 and 100, and the default is 10.
​
starting_after
string
A cursor for use in pagination. starting_after is a time entry ID that defines your place in the list. For example, if you make a list request and receive 10 objects, ending with tme_foo, your subsequent call can include starting_after=tme_foo to fetch the next page.
​
ending_before
string
A cursor for use in pagination. ending_before is a time entry ID that defines your place in the list. For example, if you make a list request and receive 10 objects, starting with tme_bar, your subsequent call can include ending_before=tme_bar to fetch the previous page.

​
Returns

Returns a dictionary with a time_entries property that contains an array of up to limit time entries, ordered by most recent first (stable by created). If no more time entries are available, the array will be empty. 
{
  "time_entries": [
    {
      "id": "tme_1HPCXADYAhh5k1NMU0r1WUqs",
      "worker": "wr_CgcLakmx4guire",
      "date": "2024-03-17",
      "duration": "8.0",
      "note": null,
      "created": "2024-03-17T10:30:00Z"
    },
    { "id": "tme_..." },
    { "id": "tme_..." }
  ]
}