# "Saved reports" Endpoints - POST Load the previously saved report

**URL:** <https://community.toggl.com/t/saved-reports-endpoints-post-load-the-previously-saved-report/416>\
**Category:** Reports API\
**Tags:** saved-report, api, endpoints, post\
**Created:** [December 2, 2024, 6:17pm UTC](https://community.toggl.com/t/saved-reports-endpoints-post-load-the-previously-saved-report/416 "2024-12-02T18:17:18Z")\
**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:17pm UTC](https://community.toggl.com/t/saved-reports-endpoints-post-load-the-previously-saved-report/416/1 "2024-12-02T18:17:18Z")

</div>

```auto
https://api.track.toggl.com/reports/api/v3/shared/{report_token}

```

Returns the previously saved report.

**Authentication**

A public report is accessible by anyone, a private one is only accessible by the report’s owner or workspace admin. If the criteria aren’t met it returns 403 status code.

**Parameters**

The report can be executed without parameters, and in this case the saved or default parameters will be used.

- 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/shared/{report_token}".to_string()) .header(CONTENT_TYPE, "application/json") .send() .await? .json() .await?; println!("{:#?}", json); Ok(())}

```

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

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

Returns report information

| Name | Type | Description |
| --- | --- | --- |
| detailed\_results | object | - |
| dictionaries | object | - |
| features | object | - |
| fixed\_daterange | boolean | - |
| hide\_amounts | boolean | - |
| input\_params | object | - |
| is\_commenting\_enabled | boolean | - |
| public | boolean | - |
| report\_name | string | - |
| report\_type | string | - |
| saved\_params | object | - |
| summary\_results | object | - |
| weekly\_results | object | - |
| workspace\_logo | string | - |

##### detailed\_results[​](https://engineering.toggl.com/docs/reports/saved_reports/#detailed_results)

| Name | Type | Description |
| --- | --- | --- |
| report | Array of object | - |
| totals | object | - |

##### report[​](https://engineering.toggl.com/docs/reports/saved_reports/#report)

| Name | Type | Description |
| --- | --- | --- |
| billable | boolean | - |
| billable\_amount\_in\_cents | integer | - |
| client\_name | string | - |
| currency | string | - |
| description | string | - |
| email | string | - |
| hourly\_rate\_in\_cents | integer | - |
| project\_color | string | - |
| project\_hex | string | - |
| project\_id | integer | - |
| project\_name | string | - |
| row\_number | integer | - |
| tag\_ids | Array of integer | - |
| tag\_names | Array of string | - |
| task\_id | integer | - |
| task\_name | string | - |
| time\_entries | Array of object | - |
| user\_id | integer | - |
| username | string | - |

##### time\_entries[​](https://engineering.toggl.com/docs/reports/saved_reports/#time_entries)

| Name | Type | Description |
| --- | --- | --- |
| at | string | - |
| at\_tz | string | used by reports v2 proxy |
| id | integer | - |
| seconds | integer | - |
| start | string | - |
| stop | string | - |

##### totals[​](https://engineering.toggl.com/docs/reports/saved_reports/#totals)

| Name | Type | Description |
| --- | --- | --- |
| billable\_amount\_in\_cents | integer | - |
| graph | Array of object | - |
| labour\_cost\_in\_cents | integer | - |
| rates | Array of object | - |
| resolution | string | - |
| seconds | integer | - |
| tracked\_days | integer | - |

##### graph[​](https://engineering.toggl.com/docs/reports/saved_reports/#graph)

| Name | Type | Description |
| --- | --- | --- |
| billable\_amount\_in\_cents | integer | - |
| by\_rate | object | - |
| labour\_cost\_in\_cents | integer | - |
| seconds | integer | - |

##### by\_rate[​](https://engineering.toggl.com/docs/reports/saved_reports/#by_rate)

##### rates[​](https://engineering.toggl.com/docs/reports/saved_reports/#rates)

| Name | Type | Description |
| --- | --- | --- |
| billable\_seconds | integer | - |
| currency | string | - |
| hourly\_rate\_in\_cents | integer | - |

##### dictionaries[​](https://engineering.toggl.com/docs/reports/saved_reports/#dictionaries)

| Name | Type | Description |
| --- | --- | --- |
| clients | object | - |
| filters | object | Remove it after FlexQ release. |
| projects | object | - |
| tags | object | - |
| tasks | object | - |
| user\_groups | object | - |
| users | object | - |

##### clients[​](https://engineering.toggl.com/docs/reports/saved_reports/#clients)

##### filters[​](https://engineering.toggl.com/docs/reports/saved_reports/#filters)

| Name | Type | Description |
| --- | --- | --- |
| clients | object | - |
| projects | object | - |
| tags | object | - |
| tasks | object | - |
| user\_groups | object | - |
| users | object | - |

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

##### projects[​](https://engineering.toggl.com/docs/reports/saved_reports/#projects)

##### tags[​](https://engineering.toggl.com/docs/reports/saved_reports/#tags)

##### tasks[​](https://engineering.toggl.com/docs/reports/saved_reports/#tasks)

##### user\_groups[​](https://engineering.toggl.com/docs/reports/saved_reports/#user_groups)

##### users[​](https://engineering.toggl.com/docs/reports/saved_reports/#users)

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

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

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

##### user\_groups[​](https://engineering.toggl.com/docs/reports/saved_reports/#user_groups-1)

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

##### features[​](https://engineering.toggl.com/docs/reports/saved_reports/#features)

##### input\_params[​](https://engineering.toggl.com/docs/reports/saved_reports/#input_params)

##### saved\_params[​](https://engineering.toggl.com/docs/reports/saved_reports/#saved_params)

##### summary\_results[​](https://engineering.toggl.com/docs/reports/saved_reports/#summary_results)

| Name | Type | Description |
| --- | --- | --- |
| report | object | - |
| totals | object | - |

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

| Name | Type | Description |
| --- | --- | --- |
| groups | Array of Object | - |

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

| Name | Type | Description |
| --- | --- | --- |
| billable\_amount\_in\_cents | integer | - |
| graph | Array of object | - |
| labour\_cost\_in\_cents | integer | - |
| rates | Array of object | - |
| resolution | string | - |
| seconds | integer | - |
| tracked\_days | integer | - |

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

| Name | Type | Description |
| --- | --- | --- |
| billable\_amount\_in\_cents | integer | - |
| by\_rate | object | - |
| labour\_cost\_in\_cents | integer | - |
| seconds | integer | - |

##### by\_rate[​](https://engineering.toggl.com/docs/reports/saved_reports/#by_rate-1)

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

| Name | Type | Description |
| --- | --- | --- |
| billable\_seconds | integer | - |
| currency | string | - |
| hourly\_rate\_in\_cents | integer | - |

##### weekly\_results[​](https://engineering.toggl.com/docs/reports/saved_reports/#weekly_results)

| Name | Type | Description |
| --- | --- | --- |
| report | Array of object | - |
| totals | object | - |

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

| Name | Type | Description |
| --- | --- | --- |
| billable\_amounts\_in\_cents | string | - |
| billable\_seconds | string | - |
| client\_name | string | - |
| currency | string | - |
| hourly\_rate\_in\_cents | integer | In cents |
| planned\_task\_id | integer | - |
| project\_color | string | - |
| project\_hex\_color | string | - |
| project\_id | integer | - |
| project\_name | string | - |
| seconds | string | - |
| user\_id | integer | - |
| user\_name | string | - |

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

| Name | Type | Description |
| --- | --- | --- |
| billable\_amount\_in\_cents | integer | - |
| graph | Array of object | - |
| labour\_cost\_in\_cents | integer | - |
| rates | Array of object | - |
| resolution | string | - |
| seconds | integer | - |
| tracked\_days | integer | - |

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

| Name | Type | Description |
| --- | --- | --- |
| billable\_amount\_in\_cents | integer | - |
| by\_rate | object | - |
| labour\_cost\_in\_cents | integer | - |
| seconds | integer | - |

##### by\_rate[​](https://engineering.toggl.com/docs/reports/saved_reports/#by_rate-2)

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

| Name | Type | Description |
| --- | --- | --- |
| billable\_seconds | integer | - |
| currency | string | - |
| hourly\_rate\_in\_cents | integer | - |

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

Possible error messages:

- report\_type does not exist in params
- The report period is not supported

#### 401[​](https://engineering.toggl.com/docs/reports/saved_reports/#401)

Possible error messages:

- Unable to extract authentication data
- Incorrect username and/or password

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

Invalid token

#### 404[​](https://engineering.toggl.com/docs/reports/saved_reports/#404)

Not found

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

report is too big to be exported