Getting started

Enable the API in Justimmo

To enable the API in your Justimmo Account you must be logged in as an administrator.
Go to “more” -> “Exports” and click on the tab “Custom exports”. With the button “Create new API Export” you can enable the api in your account.
A username and password will be provided to you automatically.

The API is treated like any export in Justimmo and realties have to be booked in accordingly.

Accessing the API

The base URL for all api call is

All possible calls are described in detail in another section of this documentation.


You must use HTTP-Auth for all calls in order to get access to your data. Username and password are provided under the API export settings (see above)


The API will return errors by setting the http status code to the appropriate value and may return a content with further information on the error.

401 Authentication Failure

Username and/or password are not correct. Status code will have the value 401.

404 Not found

The url you are trying to call could not be found. Status code will have the value 404.

<?xml version="1.0" encoding="UTF-8"?>
  <error>Ungültige Anfrage</error>

400 Bad Request

A parameter could not be evaluated or has a not supported value. Status code will have the value 400.

<?xml version="1.0" encoding="UTF-8"?>
  <error>zimmer_von ["test" is not a number.]</error>

500 Server Error

Internal Justimmo error. Status code will have the value 500.

<?xml version="1.0" encoding="UTF-8"?>
  <error>Internal Server Error</error>