OpenAtlas API

OpenAtlas provides an API which is RESTlike to easily access data entered in OpenAtlas.
A complete overview of possible endpoints and usage is available at our swagger documentation.


The OpenAtlas API tries to follow REST principles, but OpenAtlas provides multiple versions of the API
  • Deprecated version (currently API 0.2)
  • Stable version (currently API 0.3)
    • No breaking changes will be made, but new features and additions may be added
    • Deprecation of endpoints and parameters will be marked for next versions

Error handling

The OpenAtlas API provides two layers of errors catching.
  • First layer: validates a given parameter of an endpoint. Errors are caught by the Flask-RESTful extension, which has its own error handler.
  • Second layer: is a self build error model, for details see: API Error Handling

Output format

Please see API Output Formats for specifications.
  • LinkedPlacesFormat (LPF) with extensions for OpenAtlas (standard)
  • A simpler GeoJSON format
  • RDF (derived from LPF, maybe incomplete)
    • XML
    • Pretty-XML
    • Turtle
    • Notion 3
    • N-Triples


Overview of available endpoints: Endpoints
The API can be accessed via the following schema: {domain}/api/{api version}/{endpoint} for example:

OpenAtlas backend

If advanced layout is selected in your profile, a link to the different formats of entities is shown on their specific page.
If the option Public is activated in site settings (default is off) the API can be used even when not logged in.


Overview of all parameters used in different versions: Parameters
Endpoints can take in multiple parameters entered after the URL e.g.:

The first parameter has to have a ? to mark the parameter sections begin. More parameters can be added with &.


Cross-Origin Resource Sharing

Please visit CORS for more information.

Related OpenAtlas API links


general development


Updated by Silvia Gomez Senovilla over 1 year ago · 138 revisions

Also available in: PDF HTML TXT