Generate JSON worksheets

Generate structured prompt and answer data for your own layout or courseware.

Audience: Publishers, application developers, and content authors
Before you start: Valid grade and implemented topic ids from the catalog

Recipe

Call GET /catalog for the desired locale and retain only topics with implemented: true.
Build entries with unique ids, a supported difficulty, and a count from 1 through 30.
POST /worksheets from your server and check response.ok before reading data.
Match each data.entries item by position and id, then present prompt/answer with a compatible math renderer.

curl -i -X POST "https://overthemathwall.com/api/public/v1/worksheets" \
  -H "Authorization: Bearer $OTMW_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "seed": 20260720,
    "locale": "en",
    "entries": [
      {
        "id": "fractions-1",
        "grade": "grade5",
        "topic": "fractions",
        "difficulty": "medium",
        "count": 10
      }
    ]
  }'

Returned data

{
  "data": {
    "entries": [{
      "id": "fractions-1",
      "grade": "grade5",
      "topic": "fractions",
      "difficulty": "medium",
      "problems": [{
        "id": "generated-uuid",
        "prompt": "3 \\times 4 = ?",
        "answer": "12"
      }]
    }]
  }
}

prompt and answer contain LaTeX-style math strings, not sanitized HTML. Treat them as untrusted data when adding them to your UI. Each problem id is opaque and is not deterministic.

Seeds and your own cache

Store seed, locale, and entries when you need to reconstruct the same content. That combination reproduces prompts and answers while v1 behavior remains compatible, but problem UUIDs are newly generated. Assign your own stored identifiers if your product needs stable references.