---
title: "Get one goal"
method: GET
path: "/goals/{goal_id}"
tags: ["goals"]
---

# Get one goal

`GET /goals/{goal_id}`

## Request

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

Gets a goal that belongs to the calling user

## Path parameters

- `goal_id` integer, required

## Response `200`

the asked goal

- ModelsPlainGoal
  - `archived` boolean
  - `archived_at` string
  - `cadence_period` string
  - `comparing` string
  - `current_cadence` ModelsGoalCadence
    - `achieved` boolean
    - `cadence_end` string
    - `cadence_start` string
    - `goal_cadence_id` integer
    - `goal_parameter_id` integer
    - `streak` integer
    - `tracked_value` integer
  - `description` string
  - `end` 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
  - `icon` integer
  - `icon_color` string
  - `name` string
  - `start` string
  - `target_value` integer
  - `type_name` string
  - `user_id` integer
  - `workspace_id` integer

## Other responses

- `404`: goal not found for this user
- `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)