Reading

Get registers readings

get

Required permissions: Meter.Organization.Read

Query parameters

organizationIdinteger · int32Required

The identifier of the organization

registerIdinteger · int32[]Required

The identifiers of the registers

startstring · date-timeRequired

The start date and time represented using ISO 8601 format and is always in UTC time, e.g. midnight UTC on Jan 1, 2014 would look like this: '2014-01-01T00:00:00Z'.

endstring · date-timeRequired

The end date and time represented using ISO 8601 format and is always in UTC time, e.g. midnight UTC on Jan 1, 2014 would look like this: '2014-01-01T00:00:00Z'.

resolutioninteger · int32Optional

The readings resolution in seconds and if not supplied the default value is 0 seconds

Responses

200

The list of registers readings

application/json

registerIdinteger · int32Optional

400

Input data was invalid

application/json

401

Not authorized

application/json

403

Not allowed

application/json

500

Internal server error

get

/api/readings

HTTPcURLJavaScriptPython

GET /api/readings?organizationId=1&registerId=1&start=2026-03-12T03%3A39%3A51.202Z&end=2026-03-12T03%3A39%3A51.202Z HTTP/1.1
Host: api.switchmarket.se
Accept: */*

[
  {
    "registerId": 1,
    "readings": [
      {
        "periodFrom": "2026-03-12T03:39:51.202Z",
        "periodTo": "2026-03-12T03:39:51.202Z",
        "updatedAt": "2026-03-12T03:39:51.202Z",
        "value": 1
      }
    ]
  }
]

Save readings

post

Required permission is Meter.Organization.ReadWrite in the organization(s) that have access to the meters.

Body

application/json

Responses

204

The readings were saved

400

Input data was invalid

application/json

401

Not authorized

application/json

403

Not allowed

application/json

500

Internal server error

post

/api/readings

HTTPcURLJavaScriptPython

POST /api/readings HTTP/1.1
Host: api.switchmarket.se
Content-Type: application/json
Accept: */*
Content-Length: 154

{
  "meters": [
    {
      "id": "text",
      "registers": [
        {
          "id": "text",
          "values": [
            {
              "timestamp": "2026-03-12T03:39:51.202Z",
              "periodTo": "2026-03-12T03:39:51.202Z",
              "value": 1
            }
          ]
        }
      ]
    }
  ]
}

No content

Get registers hourly average readings

get

Required permissions: Meter.Organization.Read

Query parameters

organizationIdinteger · int32Required

The identifier of the organization

registerIdinteger · int32[]Required

The identifiers of the registers

startstring · date-timeRequired

The start date and time represented using ISO 8601 format and is always in UTC time, e.g. midnight UTC on Jan 1, 2014 would look like this: '2014-01-01T00:00:00Z'.

endstring · date-timeRequired

The end date and time represented using ISO 8601 format and is always in UTC time, e.g. midnight UTC on Jan 1, 2014 would look like this: '2014-01-01T00:00:00Z'.

Responses

200

The list of registers readings

application/json

registerIdinteger · int32Optional

400

Input data was invalid

application/json

401

Not authorized

application/json

403

Not allowed

application/json

500

Internal server error

get

/api/readings/average/hourly

HTTPcURLJavaScriptPython

GET /api/readings/average/hourly?organizationId=1&registerId=1&start=2026-03-12T03%3A39%3A51.202Z&end=2026-03-12T03%3A39%3A51.202Z HTTP/1.1
Host: api.switchmarket.se
Accept: */*

[
  {
    "registerId": 1,
    "readings": [
      {
        "periodFrom": "2026-03-12T03:39:51.202Z",
        "periodTo": "2026-03-12T03:39:51.202Z",
        "updatedAt": "2026-03-12T03:39:51.202Z",
        "value": 1
      }
    ]
  }
]