---
title: "Get Public Live Series"
method: GET
path: "/s/{share_id}/series"
tags: ["sharing-public"]
---

# Get Public Live Series

`GET /s/{share_id}/series`

## Request

- Base URL: `https://api.usekeel.io` (the document declares no server; this is the origin it was published from)
- URL: `https://api.usekeel.io/s/{share_id}/series`
- Auth: none declared

Return a bounded canonical live series; never increments page views.

## Path parameters

- `share_id` string, required

## Query parameters

- `range` '1w' | '1m' | '3m' | 'all'

## Response `200`

Successful Response

- union
  - PublicLiveSeriesV1
    - `schema_version` 1
    - `share_id` string, required
    - `policy_revision` integer, required
    - `range` '1w' | '1m' | '3m' | 'all', required
    - `as_of` string, nullable
    - `freshness` PublicMoneyFreshness
      - `state` 'COVERED' | 'SYNCING' | 'LEGACY' | 'UNMANAGED', required
      - `fresh_as_of` string, nullable
      - `synced_through` string, nullable
    - `segments` PublicManagedSegment[], required
      - `start` string, required
      - `end` string, required
      - `managed` boolean, required
    - `points` PublicLiveSeriesPoint[], required
      - `timestamp` string, required
      - `return_pct` number, required
      - `account_value` number, nullable
      - `cumulative_pnl` number, nullable
      - `flow_direction` 'in' | 'out', nullable
  - PublicLiveSeriesV2
    - `schema_version` 2
    - `share_id` string, required
    - `policy_revision` integer, required
    - `range` '1w' | '1m' | '3m' | 'all', required
    - `as_of` string, required
    - `basis_id` string, nullable, required
    - `quality` 'complete' | 'pending' | 'partial' | 'unavailable', required
    - `points` PublicLiveMeasuredPoint[], required
      - `timestamp` string, required
      - `segment_id` string, required
      - `return_pct` number, nullable, required
      - `return_quality` 'valuation_linked' | 'estimated' | 'unavailable', required
      - `validity` 'complete' | 'pending' | 'held' | 'unavailable', required
      - `account_value` number, nullable
      - `cumulative_pnl` number, nullable

## Other responses

- `422`: Validation Error

---

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