Reading

Get registers readings

get

Required permissions: Meter.Organization.Read

Authorizations

BearerOAuth2

HTTPRequired

Please provide your valid JWT bearer token in the text input below

Query parameters

organizationIdinteger · int32Required

The organization identifier

registerIdinteger · int32[]Required

The registers identifiers

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

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-02-02T06%3A39%3A16.093Z&end=2026-02-02T06%3A39%3A16.093Z HTTP/1.1
Host: qa-api.switchmarket.se
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

[
  {
    "registerId": 1,
    "readings": [
      {
        "periodFrom": "2026-02-02T06:39:16.093Z",
        "periodTo": "2026-02-02T06:39:16.093Z",
        "updatedAt": "2026-02-02T06:39:16.093Z",
        "value": 1
      }
    ]
  }
]

Save readings

post

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

Authorizations

BearerOAuth2

HTTPRequired

Please provide your valid JWT bearer token in the text input below

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: qa-api.switchmarket.se
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 154

{
  "meters": [
    {
      "id": "text",
      "registers": [
        {
          "id": "text",
          "values": [
            {
              "timestamp": "2026-02-02T06:39:16.093Z",
              "periodTo": "2026-02-02T06:39:16.093Z",
              "value": 1
            }
          ]
        }
      ]
    }
  ]
}

No content

Get registers hourly average readings

get

Required permissions: Meter.Organization.Read

Authorizations

BearerOAuth2

HTTPRequired

Please provide your valid JWT bearer token in the text input below

Query parameters

organizationIdinteger · int32Required

The organization identifier

registerIdinteger · int32[]Required

The registers identifiers

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

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-02-02T06%3A39%3A16.093Z&end=2026-02-02T06%3A39%3A16.093Z HTTP/1.1
Host: qa-api.switchmarket.se
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

[
  {
    "registerId": 1,
    "readings": [
      {
        "periodFrom": "2026-02-02T06:39:16.093Z",
        "periodTo": "2026-02-02T06:39:16.093Z",
        "updatedAt": "2026-02-02T06:39:16.093Z",
        "value": 1
      }
    ]
  }
]