---
title: "Summary statistics: latest, previous, all-time min/max, mean, change vs previous period and vs a year ago."
method: GET
path: "/v1/sources/{source}/series/{seriesId}/stats"
---

# Summary statistics: latest, previous, all-time min/max, mean, change vs previous period and vs a year ago.

`GET /v1/sources/{source}/series/{seriesId}/stats`

## Request

- Base URL: `https://starwell.dev/api/starwell`
- URL: `https://starwell.dev/api/starwell/v1/sources/{source}/series/{seriesId}/stats`
- Auth: one of:
  - HTTP bearer
  - none

## Path parameters

- `source` string, required
- `seriesId` string, required

## Response `200`

OK

- object
  - `success` true, required
  - `data` object, required
  - `meta` object
    - `series` object
    - `verification` Verification
      - `status` 'passing' | 'stale' | 'failing' | 'unverified', required: passing: golden-value + freshness checks pass against the live source. stale: newer official data exists (or the source has not been re-checked within its cadence window). failing: a golden check disagrees with the source — do not rely on it. unverified: not yet through the harness.
      - `lastVerifiedAt` string, date-time, nullable
    - `license` License
      - `code` 'public-domain' | 'statcan-open' | 'cc-by-4.0' | 'open-government' | 'third-party-restricted' | 'unknown'
      - `url` string, nullable
      - `attribution` string, nullable: The exact attribution line to print alongside the data.
      - `redistributable` boolean
      - `trainingEligible` boolean
    - `citation` Citation
      - `source` string
      - `authority` string, nullable
      - `dataset` string
      - `datasetExternalId` string
      - `url` string, nullable: Human-facing official table page.
      - `termsUrl` string, nullable
      - `text` string: Ready-to-print citation line.

## Other responses

- `404`: Unknown source, dataset, or series.
- `451`: The series exists but its license does not permit redistribution; no values are served.

---

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