---
title: "List Thesis Shapes"
method: GET
path: "/theses/shapes"
tags: ["theses"]
---

# List Thesis Shapes

`GET /theses/shapes`

## Request

- Base URL: `https://api.tickertrac.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.tickertrac.com/theses/shapes`
- Auth: one of:
  - HTTP bearer
  - API key in header `X-API-Key`

The preset thesis shapes, with the ticker already substituted in.

Served rather than hardcoded in the client so the prose has one home: the same
shapes drive the screener, and a starter that drifted from the criteria it is
named after would quietly mislead. No DB access and no model call -- it's static
text, which is exactly why it can be the instant option in the editor.

## Query parameters

- `ticker` string, nullable

## Response `200`

Successful Response

- ThesisShapeOut[]
  - `key` string, required
  - `name` string, required
  - `starter_thesis` string, required

## Other responses

- `422`: Validation Error

---

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