---
title: "Api Get Paper Challenge"
method: GET
path: "/api/paper/challenges/{slug}"
---

# Api Get Paper Challenge

`GET /api/paper/challenges/{slug}`

## Request

- Base URL: `https://www.oxfordledge.com` (the document declares no server; this is the origin it was published from)
- URL: `https://www.oxfordledge.com/api/paper/challenges/{slug}`
- Auth: none declared

Single challenge by slug. 404 on unknown slug.

Returns: the challenge dict (unwrapped — caller already knows
they asked for one challenge by slug, no need for envelope).

## Path parameters

- `slug` string, required

## Response `200`

Successful Response

- PaperChallenge: One lesson-linked paper-trading challenge from `static/data/paper-challenges.json`. Shape is canonical — the forcing function is `tests/test_paper_challenges_contract.py`. Frontend (`/practice/` lesson links + `/learn/` deep-links via `?challenge=<slug>`) dereferences slug + title + summary + prefill_thesis without null-check; declared REQUIRED.
  - `slug` string, required: URL-safe identifier (lowercase + hyphens). Primary key.
  - `title` string, required: One-line challenge title shown on cards.
  - `summary` string, required: 2-4 sentence challenge brief.
  - `level` string, required: beginner | intermediate | advanced.
  - `module_ids` string[], required: LEARN module IDs this challenge maps to (≥1; forcing function in contract test).
  - `journey_slug` string, nullable: Optional curated-journey slug (one of SF-22's 8 journeys).
  - `prefill_thesis` string, required: Pre-filled thesis text the order modal opens with — placeholders in [SQUARE_BRACKETS].
  - `expected_duration_days` integer, required: Recommended hold horizon for the practice exercise.
  - `success_criteria` string, required: Plain-English completion definition (no automated grading at v1).

## Other responses

- `422`: Validation Error

---

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