Perform your first API call

The goal of this page is to give examples on how to perform an API call in your application.

Tip! Use the following applications

Anchor link to the article.

Performing a request in

Go to and add the endpoint URL in the URL-box. Depending on the API, select a POST or GET request. Be sure to select "DE" or "EXT" as the server for faster processed requests. Add the message / request in the Content tab. Add the x-api-key header for authentication to the Headers tab.
Press "send" to perform the request.
curl -X POST -H "x-api-key: m2ipzWVV3e9yPU9TduqpY4oZTbcEHCGj31GLVLYB" -H "Content-Type: application/json" --data-binary @- <<DATA
"postcode" : "1234AB",
"housenumber" : "1"

Performing a request in Insomnia

Download and install the free program Insomnia. Create a new 'Request collection'. Add a 'New Request' (CTRL + N) and gives this request a name. Select POST or GET depending on the API and use JSON for the Body Text when Posting.
Add the endpoint URL of the API behind the POST/GET function into the endpoint URL box. Then add the JSON message to the JSON entry field. Lastly, configure the headers to include the Content-Type and the x-api-key for authentication and press "Send".
curl --request POST \
--url \
--header 'Content-Type: application/json' \
--header 'x-api-key: m2ipzWVV3e9yPU9TduqpY4oZTbcEHCGj31GLVLYB' \
--data '{
"data": {
"lock_measures": {
"lock": [
"max_investment": 20000,
"gas_usage": 3000,
"post_code": "2771DS",
"house_number": "87",
"target_label": "A",
"inner_surface_area": 130,
"inhabitants": 3,
"replace_boiler": true,
"heat_pump_allowed": true,
"search_criteria": 1,
"search_options": 2,
"house-type": 1,
"natural_gas": 0,
"solar_panels_surface": 1,
"watt_panels": true,
"wall_insulation": 1,
"roof_insulation": 1,
"floor_insulation": 1,
"living_room_windows": 1,
"bedroom_windows": 1,
"installation": 4,
"shower": 0,
"ventilation": 0,
"solar_panels": 10

Performing a request in Postman

Download the Postman app. Create a new HTTP Request. Select the method GET or POST depending on the API and add the endpoint URL. Set authorization to No Auth.
Add the x-api-key header and API key for authentication. Set the Body to raw and JSON when performing a POST request. Press "Send"
Last modified 2mo ago