---
title: "List Milestones"
method: GET
path: "/companies/{company_id}/milestones"
tags: ["milestones"]
---

# List Milestones

`GET /companies/{company_id}/milestones`

## Request

- Base URL: `https://api.nanocorp.so` (the document declares no server; this is the origin it was published from)
- URL: `https://api.nanocorp.so/companies/{company_id}/milestones`
- Auth: HTTP bearer

Trophy shelf (achieved), the unseen-marquee modal queue, and the next-goal teaser.

## Path parameters

- `company_id` string, uuid, required

## Response `200`

Successful Response

- MilestonesResponse: The full milestones payload for a company's dashboard.
  - `achieved` MilestoneResponse[], required
    - `id` string, required
    - `company_id` string, required
    - `milestone_key` string, required
    - `category` string, required
    - `tier` string, required
    - `value` object, required
    - `achieved_at` string, date-time, required
    - `seen_at` string, date-time, nullable
    - `source` string, required
  - `unseen_marquee` MilestoneResponse[], required
    - `id` string, required
    - `company_id` string, required
    - `milestone_key` string, required
    - `category` string, required
    - `tier` string, required
    - `value` object, required
    - `achieved_at` string, date-time, required
    - `seen_at` string, date-time, nullable
    - `source` string, required
  - `next` NextMilestoneResponse: The forward-looking teaser shown before the milestone is achieved.
    - `key` string, required
    - `label` string, required
    - `target_cents` integer, required
    - `current_cents` integer, required
    - `achieved` boolean, required

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/nanocorp/apis/nanocorp-api.md) - [All operations](https://skmtc.dev/nanocorp/apis/nanocorp-api/llms.txt) - [OpenAPI document](https://skmtc.dev/nanocorp/apis/nanocorp-api/revisions/291bb76b720b?raw)