---
title: "Get a list of goal cadences"
method: GET
path: "/goals/cadences"
tags: ["goals"]
---

# Get a list of goal cadences

`GET /goals/cadences`

## Request

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

Gets all cadences for the goals requested for the asking user.

## Query parameters

- `amount` integer
- `archived` string
- `goal` integer[]
- `offset` integer

## Response `200`

List of cadences for a given user

- GoalsCadenceResponse[]
  - `goal_id` integer
  - `parameters` GoalsCadenceParameter[]
    - `cadence_period` string
    - `cadences` ModelsGoalCadence[]
      - `achieved` boolean
      - `cadence_end` string
      - `cadence_start` string
      - `goal_cadence_id` integer
      - `goal_parameter_id` integer
      - `streak` integer
      - `tracked_value` integer
    - `comparing` string
    - `created_at` string
    - `deleted_at` string
    - `end_date` string
    - `goal_id` integer
    - `goal_parameter_id` integer
    - `goal_type` ModelsGoalType
      - `billable` boolean: For simplicity's sake we will not use GoalBillableType here
      - `projects` ModelsGoalProjectType[]
        - `project_id` integer
        - `task_id` integer
    - `start_date` string
    - `target_value` integer

## Other responses

- `400`: Invalid parameters
- `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)