# "Summary report" Endpoints - POST Search time entries

**URL:** <https://community.toggl.com/t/summary-report-endpoints-post-search-time-entries/422>\
**Category:** Reports API\
**Tags:** time-entries, summary, api, endpoints, post\
**Created:** [December 2, 2024, 6:25pm UTC](https://community.toggl.com/t/summary-report-endpoints-post-search-time-entries/422 "2024-12-02T18:25:42Z")\
**Posts on this page:** 1\
**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:** [December 2, 2024, 6:25pm UTC](https://community.toggl.com/t/summary-report-endpoints-post-search-time-entries/422/1 "2024-12-02T18:25:42Z")

</div>

```auto
https://api.track.toggl.com/reports/api/v3/workspace/{workspace_id}/summary/time_entries

```

Returns time entries for summary report according to the given filters.

- 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::POST, "https://api.track.toggl.com/reports/api/v3/workspace/{workspace_id}/summary/time_entries".to_string()).json(&serde_json::json!(\{"audit":\{"group_filter":\{"currency":"string","max_amount_cents":"integer","max_duration_seconds":"integer","min_amount_cents":"integer","min_duration_seconds":"integer"\},"show_empty_groups":"boolean","show_tracked_groups":"boolean"\},"billable":"boolean","client_ids":[\{\}],"description":"string","distinguish_rates":"boolean","end_date":"string","group_ids":[\{\}],"grouping":"string","include_time_entry_ids":"boolean","max_duration_seconds":"integer","min_duration_seconds":"integer","project_ids":[\{\}],"rounding":"integer","rounding_minutes":"integer","startTime":"string","start_date":"string","sub_grouping":"string","tag_ids":[\{\}],"task_ids":[\{\}],"time_entry_ids":[\{\}],"user_ids":[\{\}]\})) .header(CONTENT_TYPE, "application/json") .send() .await? .json() .await?; println!("{:#?}", json); Ok(())}

```

### Parameters[​](https://engineering.toggl.com/docs/reports/summary_reports/#parameters-2)

#### Path[​](https://engineering.toggl.com/docs/reports/summary_reports/#path-2)

| name | type | required | description |
| --- | --- | --- | --- |
| workspace\_id | integer | true | Workspace ID |

#### Body[​](https://engineering.toggl.com/docs/reports/summary_reports/#body-2)

| Name | Type | Description |
| --- | --- | --- |
| audit | object | - |
| billable | boolean | Whether the time entry is set as billable, optional, premium feature. |
| client\_ids | Array of integer | Client IDs, optional, filtering attribute. To filter records with no clients, use [null]. |
| description | string | Description, optional, filtering attribute. |
| distinguish\_rates | boolean | DistinguishRates will create new subgroups for each rate, optional, default false. |
| end\_date | string | End date, example time.DateOnly. Should be greater than Start date. |
| group\_ids | Array of integer | Group IDs, optional, filtering attribute. |
| grouping | string | Grouping option, optional. |
| include\_time\_entry\_ids | boolean | Whether time entry IDs should be included in the results, optional, default false. Not applicable for export. |
| max\_duration\_seconds | integer | Max duration seconds, optional, filtering attribute. Time Audit only, should be greater than MinDurationSeconds. |
| min\_duration\_seconds | integer | Min duration seconds, optional, filtering attribute. Time Audit only, should be less than MaxDurationSeconds. |
| project\_ids | Array of integer | Project IDs, optional, filtering attribute. To filter records with no projects, use [null]. |
| rounding | integer | Whether time should be rounded, optional, default from user preferences. |
| rounding\_minutes | integer | Rounding minutes value, optional, default from user preferences. Should be 0, 1, 5, 6, 10, 12, 15, 30, 60 or 240. |
| startTime | string | - |
| start\_date | string | Start date, example time.DateOnly. Should be less than End date. |
| sub\_grouping | string | SubGrouping option, optional. |
| tag\_ids | Array of integer | Tag IDs, optional, filtering attribute. To filter records with no tags, use [null]. |
| task\_ids | Array of integer | Task IDs, optional, filtering attribute. To filter records with no tasks, use [null]. |
| time\_entry\_ids | Array of integer | TimeEntryIDs filters by time entries. This was added to support retro-compatibility with reports v2. |
| user\_ids | Array of integer | User IDs, optional, filtering attribute. |

##### audit[​](https://engineering.toggl.com/docs/reports/summary_reports/#audit)

| Name | Type | Description |
| --- | --- | --- |
| group\_filter | object | - |
| show\_empty\_groups | boolean | Whether empty groups should be displayed, default false, premium feature. |
| show\_tracked\_groups | boolean | Whether tacked groups should be displayed, default true, premium feature. |

##### group\_filter[​](https://engineering.toggl.com/docs/reports/summary_reports/#group_filter)

| Name | Type | Description |
| --- | --- | --- |
| currency | string | Audit currency, optional, example “USD”, premium feature. |
| max\_amount\_cents | integer | Audit max amount in cents, optional, premium feature. |
| max\_duration\_seconds | integer | Audit max duration in seconds, optional, premium feature. |
| min\_amount\_cents | integer | Audit min amount in cents, optional, premium feature. |
| min\_duration\_seconds | integer | Audit min duration in seconds, optional, premium feature. |

### Response[​](https://engineering.toggl.com/docs/reports/summary_reports/#response-2)

#### 200[​](https://engineering.toggl.com/docs/reports/summary_reports/#200-2)

Returns the summary time entries

#### 400[​](https://engineering.toggl.com/docs/reports/summary_reports/#400-2)

Possible error messages:

- At least one parameter must be set
- Invalid workspace id
- Invalid ‘{parameter}’ value, allowed values are: ‘{valid\_values}’

#### 402[​](https://engineering.toggl.com/docs/reports/summary_reports/#402-1)

Workspace needs to have this feature enabled

#### 403[​](https://engineering.toggl.com/docs/reports/summary_reports/#403-1)

Workspace not found/accessible

#### 500[​](https://engineering.toggl.com/docs/reports/summary_reports/#500-2)

Internal Server Error
