DevelopersDocsAPI reference
API reference
Conventions for the Problems.cc problem API: base URL, auth, and the problem object.
On this page
Send JSON to https://www.problems.cc/api/v1 on https://www.problems.cc. The MCP endpoint is https://www.problems.cc/api/mcp. Authenticate with a bearer key. Responses are JSON and are not cacheable.
- Search problems — subject-aware retrieval.
- Draw a random problem — the short mathematics call.
- Retrieve one problem — by the UUID from an earlier response.
- Read the catalog — subjects, filters, topics, and competitions for this key.
- MCP — the same catalogue over Streamable HTTP.
Problem object
| Field | Meaning |
|---|---|
| id | UUID. Use it for GET and for exclude_ids. It is not the public problem code. |
| statement_md | Markdown statement, with $ math. |
| answer_format | multiple_choice, numeric, text, or proof. |
| choices | A–E labels, option_md, and image_url. option_md may be empty when the choice is an image. No correct flag. |
| images | url, alt, and caption_md for statement Storage assets. Markdown /library/… paths stay in statement_md. Audit crops are omitted. |
| subjects | 1–5 objects of slug and name. |
| rating | Integer Maths Rating, or null. |
| rating_scale | maths_rating, or null. |
| rating_source | Where the rating came from, or null. A level-band prior is labelled as such. |
| rating_confidence | empirical, high, medium, low, or null. |
| topics | slug, name, and sometimes axis: domain, technique, curriculum, format, or custom. |
| attribution.text | The line you must display. |
| requires_diagram | Whether the statement needs a figure. |
| level_band | Editorial stage, or null. |
| provenance | Competition, year, paper, and problem number, or null. |
Search wraps problems in { problems, selection, usage }. Random and get return { problem, usage }. Catalog returns { catalog, usage }.