---
title: "Progress toward the REPS hours goal"
method: GET
path: "/goal-progress"
---

# Progress toward the REPS hours goal

`GET /goal-progress`

## Request

- Base URL: `https://api.reps-log.com/v1`
- URL: `https://api.reps-log.com/v1/goal-progress`
- Auth: HTTP bearer

Adapts to the user's case: LTR combined (500/750) and/or STR per-property (100/500).

## Query parameters

- `year` integer

## Response `200`

OK

- object
  - `ok` true, required
  - `data` object, required
    - `year` number
    - `mode` 'ltr' | 'str' | 'both'
    - `ltr` object
      - `goal` number
      - `hours` number
      - `label` string
      - `byParticipant` object[]
        - `name` string
        - `hours` number
    - `str` object
      - `goal` number
      - `properties` object[]
        - `name` string
        - `hours` number

## Other responses

- `400`: Validation / bad request
- `401`: Unauthenticated
- `403`: Forbidden scope / not Premium
- `404`: Not found
- `429`: Rate limited

---

[API](https://skmtc.dev/reps-log/apis/repslog-api.md) · [All operations](https://skmtc.dev/reps-log/apis/repslog-api/llms.txt) · [OpenAPI document](https://skmtc.dev/reps-log/apis/repslog-api/revisions/304ab3847932?raw)
