API v2

This describes the resources that make up the first public OpenMensa API v2. On problems contact us.


All API access happens over HTTPS.

Endpoint: https://openmensa.org/api/v2

All paths referenced throughout this document are meant to be relative to the API endpoint above.


All data is sent and received as JSON by default.


Encoding for all requests and responses should be UTF-8.

Date and Time

All timestamps are returned in ISO 8601 format (UTC).


Dates will be returned without time information.



Postal address formats vary by country but at least the following information should be included in given order.

street address, postal code + city/town, country


Geographic coordinates are returned as an array of latitude and longitude.



All examples are given in JSON notion (request as well as response bodies), for general rules how the XML will look see here.

Unless otherwise stated a response will contain all shown fields.


Requests returning multiple items will be paginated to 10 items by default. You can specify the number of items per page using the limit parameter. Allowed values are between 1 and 100. The upper limit may be different for specific resources.

Further pages can be requested by specifying the page parameter. First page (the one you usually retrieve without explicitly specifying the page number) is page number 1.

Client Errors

See here.