---
title: "Get Public Live Card Input"
method: GET
path: "/s/{share_id}/card-input/{policy_revision}"
tags: ["sharing-public"]
---

# Get Public Live Card Input

`GET /s/{share_id}/card-input/{policy_revision}`

## 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}/card-input/{policy_revision}`
- Auth: none declared

Return the only DTO a Live Share social-card renderer may consume.

## Path parameters

- `share_id` string, required
- `policy_revision` integer, required

## Response `200`

Successful Response

- union
  - PublicLiveSocialCardV1: Fixed percentage-only input accepted by card renderers.
    - `schema_version` 1
    - `share_type` 'live'
    - `share_id` string, required
    - `policy_revision` integer, required
    - `title` string, required
    - `status` 'LIVE' | 'PAUSED' | 'STOPPED', required
    - `total_return_pct` number, nullable
    - `max_drawdown_pct` number, nullable
    - `as_of` string, nullable
    - `creator_name` string, nullable
  - PublicPaperSocialCardV1: ``GET /s/{share_id}/card-input/{policy_revision}`` for a paper link: the inputs of LA2's paper card (S05 §3.12.3). Percentages only. ``sparkline`` is the record's ``return_pct`` series (range ``all``), evenly downsampled to at most 60 points with the last point kept (FDR-7); empty while the record has fewer than two points.
    - `schema_version` 1
    - `share_type` 'paper'
    - `share_id` string, required
    - `policy_revision` integer, required
    - `title` string, required
    - `status` 'LIVE' | 'PAUSED' | 'STOPPED', required
    - `total_return_pct` number, nullable
    - `max_drawdown_pct` number, nullable
    - `as_of` string, nullable
    - `record_age_days` integer, required
    - `sparkline` number[]

## 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)