---
title: "Get Goal History"
method: GET
path: "/v1/dev/user/goals/{goal_id}/history"
tags: ["Goals"]
---

# Get Goal History

`GET /v1/dev/user/goals/{goal_id}/history`

Get progress history for a goal.

- **goal_id**: The ID of the goal
- **days**: Number of days of history to return (max 365, default 30)

## Path parameters

- `goal_id` string, required

## Query parameters

- `days` integer

## Response `200`

Successful Response

- GoalHistoryEntryResponse[]
  - `date` string, required
  - `recorded_at` string, date-time, required
  - `value` number, required

## Other responses

- `401` — Missing or invalid authentication credentials.
- `403` — Authenticated, but the token does not grant the required scope.
- `404` — Requested resource was not found.
- `422` — Validation Error

## Changes

- **2026-07-04** `c53991da4cbe` — 3 info
  - added the required property `items/date` to the response with the `200` status
  - added the required property `items/recorded_at` to the response with the `200` status
  - added the required property `items/value` to the response with the `200` status
- **2026-06-30** `fbfe4956e141` — 2 warning
  - removed the optional property `detail/items/ctx` from the response with the `422` status
  - removed the optional property `detail/items/input` from the response with the `422` status
- **2026-06-30** `c2ab717efdbc` — 2 info
  - added the optional property `detail/items/ctx` to the response with the `422` status
  - added the optional property `detail/items/input` to the response with the `422` status
- **2026-06-30** `fbfe4956e141` — 2 warning
  - removed the optional property `detail/items/ctx` from the response with the `422` status
  - removed the optional property `detail/items/input` from the response with the `422` status
- **2026-06-30** `c2ab717efdbc` — 2 info
  - added the optional property `detail/items/ctx` to the response with the `422` status
  - added the optional property `detail/items/input` to the response with the `422` status

[Full history](https://skmtc.dev/basedhardware/apis/omi-developer-api/changes/v1/dev/user/goals/:goal_id/history/get.md)

---

[API](https://skmtc.dev/basedhardware/apis/omi-developer-api.md) · [All operations](https://skmtc.dev/basedhardware/apis/omi-developer-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/basedhardware/omi-developer-api/revisions/3add0ce9bc4f/schema)