# Math.ly API

You can programmatically access Math.ly's question generator using our RESTful API.

All endpoints return JSON results and are currently rate limited to 10 requests per minute.

Our API is in early beta. If you have any questions or feedback, please don't hesitate to contact us.

## GET a Random Question

To get a random math question for a given topic, use the following patern:

https://math.ly/api/v1/algebra/linear-equations.json

The question and answer choices are returned in MathML markup.

You can request a specific difficulty level by assigning the values 'beginner,' 'intermediate,' or 'advanced' to 'difficulty' in the query string, like this:

https://math.ly/api/v1/algebra/linear-equations.json?difficulty=beginner

## GET a Question by ID

To get a specific math question via its ID, use the following patern:

https://math.ly/api/v1/algebra/linear-equations/pbnpd.json