# "Time entries" Endpoints - GET TimeEntries

**URL:** <https://community.toggl.com/t/time-entries-endpoints-get-timeentries/182>\
**Category:** API References\
**Tags:** time-entries, api, endpoints, me-endpoint, get\
**Created:** [November 21, 2024, 12:53pm UTC](https://community.toggl.com/t/time-entries-endpoints-get-timeentries/182 "2024-11-21T12:53:56Z")\
**Posts on this page:** 3\
**Page:** 1

<div class="post-metadata">

**Author:** ![Support](https://yyz2.discourse-cdn.com/flex012/user_avatar/community.toggl.com/support/32/1577_2.png) [@Support](https://community.toggl.com/u/Support)\
**Post date:** [November 21, 2024, 12:53pm UTC](https://community.toggl.com/t/time-entries-endpoints-get-timeentries/182/1 "2024-11-21T12:53:56Z")

</div>

```auto
https://api.track.toggl.com/api/v9/me/time_entries

```

Lists latest time entries.

- cURL
- Go
- Ruby
- JavaScript
- Python
- Rust

```auto
extern crate tokio;extern crate serde_json;use reqwest::{Client};use reqwest::header::{CONTENT_TYPE};#[tokio::main]async fn main() -> Result<(), reqwest::Error> { let client = Client::new().basic_auth("<email>", "<password>"); let json = client.request(Method::GET, "https://api.track.toggl.com/api/v9/me/time_entries".to_string()) .header(CONTENT_TYPE, "application/json") .send() .await? .json() .await?; println!("{:#?}", json); Ok(())}

```

### Parameters[​](https://engineering.toggl.com/docs/api/time_entries/#parameters)

#### Query[​](https://engineering.toggl.com/docs/api/time_entries/#query)

| name | type | required | description |
| --- | --- | --- | --- |
| meta | boolean | false | Should the response contain data for meta entities |
| include\_sharing | boolean | false | Include sharing details in the response |

#### Query[​](https://engineering.toggl.com/docs/api/time_entries/#query-1)

| name | type | required | description |
| --- | --- | --- | --- |
| since | integer | false | Get entries modified since this date using UNIX timestamp, including deleted ones. |
| before | string | false | Get entries with start time, before given date (YYYY-MM-DD) or with time in RFC3339 format. |
| start\_date | string | false | Get entries with start time, from start\_date YYYY-MM-DD or with time in RFC3339 format. To be used with end\_date. |
| end\_date | string | false | Get entries with start time, until end\_date YYYY-MM-DD or with time in RFC3339 format. To be used with start\_date. |

### Response[​](https://engineering.toggl.com/docs/api/time_entries/#response)

#### 200[​](https://engineering.toggl.com/docs/api/time_entries/#200)

| Name | Type | Description |
| --- | --- | --- |
| items | Array of object | - |

##### items[​](https://engineering.toggl.com/docs/api/time_entries/#items)

| Name | Type | Description |
| --- | --- | --- |
| at | string | When was last updated |
| billable | boolean | Whether the time entry is marked as billable |
| client\_name | string | Related entities meta fields - if requested |
| description | string | null |
| duration | integer | Time entry duration. For running entries should be negative, preferable -1 |
| duronly | boolean | Used to create a TE with a duration but without a stop time, this field is deprecated for GET endpoints where the value will always be true. |
| id | integer | Time Entry ID |
| permissions | Array of string | Permission list |
| pid | integer | Project ID, legacy field |
| project\_active | boolean | - |
| project\_billable | boolean | - |
| project\_color | string | - |
| project\_id | integer | null |
| project\_name | string | - |
| shared\_with | Array of object | Indicates who the time entry has been shared with |
| start | string | Start time in UTC |
| stop | string | Stop time in UTC, can be null if it’s still running or created with “duration” and “duronly” fields |
| tag\_ids | Array of integer | Tag IDs, null if tags were not provided or were later deleted |
| tags | Array of string | Tag names, null if tags were not provided or were later deleted |
| task\_id | integer | null |
| task\_name | string | - |
| tid | integer | Task ID, legacy field |
| uid | integer | Time Entry creator ID, legacy field |
| user\_avatar\_url | string | - |
| user\_id | integer | Time Entry creator ID |
| user\_name | string | - |
| wid | integer | Workspace ID, legacy field |
| workspace\_id | integer | Workspace ID |

##### shared\_with[​](https://engineering.toggl.com/docs/api/time_entries/#shared_with)

| Name | Type | Description |
| --- | --- | --- |
| accepted | boolean | - |
| user\_id | integer | - |
| user\_name | string | - |

#### 403[​](https://engineering.toggl.com/docs/api/time_entries/#403)

User does not have access to this resource.

#### 500[​](https://engineering.toggl.com/docs/api/time_entries/#500)

Internal Server Error

---

<div class="post-metadata">

**Author:** ![dschuermans](https://yyz2.discourse-cdn.com/flex012/user_avatar/community.toggl.com/dschuermans/32/1950_2.png) [@dschuermans](https://community.toggl.com/u/dschuermans)\
**Post date:** [August 24, 2025, 9:48pm UTC](https://community.toggl.com/t/time-entries-endpoints-get-timeentries/182/2 "2025-08-24T21:48:23Z")

</div>

Having some problems using this endpoint in combination with dates **and** times

> Trace [0]: Performing GET on me/time\_entries?start\_date=2025-08-24T18:30:00+00:00&end\_date=2025-08-24T20:30:00+00:00  
> Error [0]: Toggl API returned BadRequest - Bad Request: “error parsing date 2025-08-24T18:30:00 00:00”

I’m writing an integration test for my tool, and I know there’s exactly 1 entry inside that window between start & end

Any pointers?

_EDIT_  
As per usual, I figure it out after posting -.-’  
My client I was using to send the request was encoding the query string, replacing + with space 🤦

---

<div class="post-metadata">

**Author:** ![Support](https://yyz2.discourse-cdn.com/flex012/user_avatar/community.toggl.com/support/32/1577_2.png) [@Support](https://community.toggl.com/u/Support)\
**Post date:** [August 25, 2025, 8:09pm UTC](https://community.toggl.com/t/time-entries-endpoints-get-timeentries/182/3 "2025-08-25T20:09:01Z")

</div>

No worries! You’ve got it sorted then?
