Build your first worksheet in five minutes

Create a server-side API key, read the free catalog, and generate a JSON worksheet.

Audience: Personal developers, organization developers, publishers, and authors
Before you start: An Over The Math Wall account and a server or terminal that can make HTTPS requests

1. Create a key

Sign in, open the developer portal, add a recognizable label, accept the API Terms, and create the key. The complete secret is shown once.

export OTMW_API_KEY="otmw_live_..."

2. Read the free catalog

The catalog requires authentication but consumes no credits. Use only topics with implemented: true and a difficulty included in that topic’s list.

curl "https://overthemathwall.com/api/public/v1/catalog?locale=en" \
  -H "Authorization: Bearer $OTMW_API_KEY"

3. Generate ten problems

Copy the grade and topic ids from the catalog. You choose the entry id; it is echoed in the response so you can match results.

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
      }
    ]
  }'

4. Verify the response and usage

A 200 response contains data.entries and problems with prompt and answer. On a prepaid account, X-RateLimit-Remaining is the balance after the request. This ten-problem request costs one credit.

HTTP/2 200
X-RateLimit-Limit: 50
X-RateLimit-Remaining: 49

{
  "data": {
    "entries": [{
      "id": "fractions-1",
      "grade": "grade5",
      "topic": "fractions",
      "difficulty": "medium",
      "problems": [{"id":"...","prompt":"...","answer":"..."}]
    }]
  }
}