DevelopersDocsAPI reference
Read the catalog
GET /api/v1/catalog describes the subjects, filters, topics, and competitions visible to the calling key.
GET/api/v1/catalog
Catalog is authenticated and spends one request in the minute bucket. It tells a caller which filters are stored and which subject slugs exist. It is not a public inventory, and these docs do not reprint its counts.
Request
Response
200 returns catalog and usage. catalog.subjects lists every recognised subject with eligible_problems, rating_supported, and rating_scale. Those counts are for the calling key’s allowlist. Do not publish them as the size of a subject.
catalog.ratingdescribes maths_rating: minimum 400, maximum 4000, the resolver version, and a note.selection_strategiesincludesrandomanddifficulty_ordered.max_problems_per_requestis this key’s batch cap.filterslists supported and unsupported names, with a note and sometimes allowed values.topicsandcompetitionsinclude only eligible problems for this key, with their own counts.
Use the notes in filters when you want the key-specific wording. The subject and rating rules on this site are the ones the API enforces for every key.