---
title: "Rates list"
method: GET
path: "/workspaces/{workspace_id}/rates/{level}/{level_id}"
tags: ["rates"]
---

# Rates list

`GET /workspaces/{workspace_id}/rates/{level}/{level_id}`

## Request

- Base URL: `https://localhost:8080/api/v9`
- URL: `https://localhost:8080/api/v9/workspaces/{workspace_id}/rates/{level}/{level_id}`
- Auth: HTTP basic
- TypeScript: <https://skmtc.dev/toggl/apis/toggl-api/docs/workspaces/:workspace_id/rates/:level/:level_id/get.ts> (a function with typed inputs; its response is checked against the schema)

Get rates by level(workspace|project|user).

## Path parameters

- `workspace_id` integer, required
- `level` string, required
- `level_id` integer, required

## Response `200`

Successful operation.

- DtoGetResponse[]
  - `created_at` string
  - `created_by` integer
  - `creator_name` string
  - `description` string
  - `id` integer
  - `link` DtoLinkResponse
    - `external` boolean
    - `token` string
  - `locked` boolean
  - `name` string
  - `organization_id` integer
  - `permissions` DtoResourcePermissionResponse[]
    - `allowed_actions` string[]
    - `group_id` integer
    - `organization_id` integer
    - `permission_type` string
    - `user_id` integer
    - `workspace_id` integer
  - `pinned` boolean
  - `plan` string
  - `preferences` object
  - `query` DtoQueryResponse
    - `aggregation_filters` DtoAggFilterRequest[]
      - `conditions` DtoAggFilterRequest[]
      - `operator` string
      - `property` string
      - `value` unknown
    - `aggregations` DtoAggregationRequest[]
      - `alias` string
      - `function` string, required
      - `property` string, required
    - `attributes` DtoAttributeRequest[]
      - `property` string
    - `filters` DtoFilterRequest[]
      - `conditions` DtoFilterRequest[]
      - `operator` string
      - `property` string
      - `value` unknown
    - `groupings` DtoGroupingRequest[]
      - `alias` string
      - `property` string, required
      - `show_empty` boolean
    - `limit` integer
    - `ordinations` DtoOrdinationRequest[]
      - `direction` string
      - `nulls` string
      - `property` string, required
    - `period` DtoPeriodRequest, required
      - `from` string
      - `preset` string
      - `to` string
    - `preferences` object
    - `transformations` DtoTransformationRequest[]
      - `name` string, required
      - `parameters` string[], required
    - `v3_query_params` string
  - `source` string
  - `type` string
  - `updated_at` string

## Other responses

- `400`: Possible error messages:<ul><li>Invalid workspace ID</li><li>Invalid entity ID</li><li>Invalid level: it should be workspace, workspace_user, project or project_user</li></ul>
- `402`: Billable rates are available for Starter and higher plans.
- `403`: User cannot access billable rate(s).
- `500`: Internal Server Error

---

[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)