Moderan API : Knowledge Base

Moderan API enables you/your software partners to integrate Moderan with other software solutions for smooth collaboration.

We provide REST API for accessing your Moderan data, you can use JSON to send/receive data.

Authentication
- API key and domain ID
General API
- Get all Organizations
Rent and fees API
- Get all Rent and Fees for {month}
Costs API

Authentication

API key and domain ID

API key can be copied from your Moderan account > Admin > Integrations > API tokens
Domain ID can be copied from your Moderan account > Admin > Company info

Every request should have 2 HTTP headers:

Content-Type: application / json
Authorization: yourApiTokenPunkt1

General API

Get all Organizations

Make a GET query to the URL https://www.moderan.net/api/domains/DOMAIN_ID/properties/0/organizationsapi

Rent and fees API

Get all Rent and Fees for {month}

Get all rent and fees for December of 2020 (notice two query parameters start and end)

Make a GET query to the URL https://www.moderan.net/api/domains/DOMAIN_ID/properties/0/buildings/0/reports/contracts/rentchanges?start=2020-12-01&end=2020-12-31

Costs API

1. Get all Property/building sets

Make a GET query to the URL https://www.moderan.net/api/domains/DOMAIN_ID/properties/0/distributionsets
The id field received will be used in future and we will call it COST_SET_ID.

2. Get all cost periods for cost set (Needs COST_SET_ID from endpoint 1)

Make a GET query to the URL https://www.moderan.net/api/domains/DOMAIN_ID/properties/0/sets/COST_SET_ID/costperiods
The id field received will be used in future and we will call it PERIOD_ID.

3. Get all costs for specific period (Needs COST_SET_ID from endpoint 1 and PERIOD_ID from endpoint 2)

Make a GET query to the URL https://www.moderan.net/api/domains/DOMAIN_ID/properties/0/sets/COST_SET_ID /periods/PERIOD_ID/utilities

4. Send Reading data

Make a POST request to the URL https://www.moderan.net/api/domains/DOMAIN_ID/readingdumps

Send content to JSON, example:

{
        "date" : "2019-06-17",
        "meter" : "7JK1P",
        "set" : 
{             "id" : 61          }
,
         "reading" : 3803
}

Fields: 

date - the date of the meter Reading 
meter - the name of the Meter 
set - object, the ID of which you can get from point 2 above 
Reading - example reading data

Moderan API Print