---
title: "Load the previously saved report"
method: POST
path: "/reports/api/v3/shared/{report_token}"
tags: ["saved_reports"]
---

# Load the previously saved report

`POST /reports/api/v3/shared/{report_token}`

## Request

- Base URL: `https://localhost:8080/api/v9`
- URL: `https://localhost:8080/api/v9/reports/api/v3/shared/{report_token}`
- Auth: HTTP basic
- TypeScript: <https://skmtc.dev/toggl/apis/toggl-api/docs/reports/api/v3/shared/:report_token/post.ts> (a function with typed inputs; its response is checked against the schema)

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.

## Path parameters

- `report_token` string, required

## Request body `text/plain`

- string

## Response `200`

Returns report information

- SavedExecuteReportOutput
  - `detailed_results` SavedDetailedReportData
    - `report` DetailedGroupedTimeEntry[]
      - `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` integer[]
      - `tag_names` string[]
      - `task_id` integer
      - `task_name` string
      - `time_entries` DetailedSingleTimeEntry[]
        - `at` string
        - `id` integer
        - `seconds` integer
        - `start` string
        - `stop` string
      - `user_id` integer
      - `username` string
    - `totals` TotalsReportData
      - `billable_amount_in_cents` integer
      - `graph` TotalsGraph[]
        - `billable_amount_in_cents` integer
        - `by_rate` object
        - `labour_cost_in_cents` integer
        - `seconds` integer
      - `labour_cost_in_cents` integer
      - `rates` BaseBillableHourlyRate[]
        - `billable_seconds` integer
        - `currency` string
        - `hourly_rate_in_cents` integer
      - `resolution` string
      - `seconds` integer
      - `tracked_days` integer
  - `dictionaries` SavedReportDictionaries
    - `clients` SavedGeneralDictionary
    - `filters` SavedReportDictionariesData
      - `clients` SavedGeneralDictionary
      - `projects` SavedProjectDictionary
      - `tags` SavedGeneralDictionary
      - `tasks` SavedTaskDictionary
      - `user_groups` SavedGeneralDictionary
      - `users` SavedUserDictionary
    - `projects` SavedProjectDictionary
    - `tags` SavedGeneralDictionary
    - `tasks` SavedTaskDictionary
    - `user_groups` SavedGeneralDictionary
    - `users` SavedUserDictionary
  - `features` object
  - `fixed_daterange` boolean
  - `hide_amounts` boolean
  - `input_params` object
  - `public` boolean
  - `report_name` string
  - `report_type` string
  - `saved_params` object
  - `summary_results` SavedSummaryReportData
    - `report` SummaryReportData
      - `groups` SummaryGroupData[] (unresolved $ref)
    - `totals` TotalsReportData
      - `billable_amount_in_cents` integer
      - `graph` TotalsGraph[]
        - `billable_amount_in_cents` integer
        - `by_rate` object
        - `labour_cost_in_cents` integer
        - `seconds` integer
      - `labour_cost_in_cents` integer
      - `rates` BaseBillableHourlyRate[]
        - `billable_seconds` integer
        - `currency` string
        - `hourly_rate_in_cents` integer
      - `resolution` string
      - `seconds` integer
      - `tracked_days` integer
  - `weekly_results` SavedWeeklyReportData
    - `report` WeeklyDataRow[]
      - `billable_amounts_in_cents` integer[]
      - `billable_seconds` integer[]
      - `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` integer[]
      - `user_id` integer
      - `user_name` string
    - `totals` TotalsReportData
      - `billable_amount_in_cents` integer
      - `graph` TotalsGraph[]
        - `billable_amount_in_cents` integer
        - `by_rate` object
        - `labour_cost_in_cents` integer
        - `seconds` integer
      - `labour_cost_in_cents` integer
      - `rates` BaseBillableHourlyRate[]
        - `billable_seconds` integer
        - `currency` string
        - `hourly_rate_in_cents` integer
      - `resolution` string
      - `seconds` integer
      - `tracked_days` integer
  - `workspace_logo` string

## Other responses

- `400`: Possible error messages:<ul><li>report_type does not exist in params</li><li>The report period is not supported</li/</ul>
- `401`: Possible error messages:<ul><li>Unable to extract authentication data</li><li>Incorrect username and/or password</li></ul>
- `403`: Invalid token
- `404`: Not found
- `500`: report is too big to be exported

---

[API](https://skmtc.dev/toggl/apis/toggl-api.md) - [All operations](https://skmtc.dev/toggl/apis/toggl-api/llms.txt) - [OpenAPI document](https://skmtc.dev/toggl/apis/toggl-api/revisions/3085aee16990?raw)