Reading

Get registers readings

get

Required permissions: Meter.Organization.Read

Authorizations
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
get
/api/readings
GET /api/readings?organizationId=1&registerId=1&start=2025-11-03T15%3A51%3A44.667Z&end=2025-11-03T15%3A51%3A44.667Z HTTP/1.1
Host: api.switchmarket.se
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

[
  {
    "registerId": 1,
    "readings": [
      {
        "periodFrom": "2025-11-03T15:51:44.667Z",
        "periodTo": "2025-11-03T15:51:44.667Z",
        "updatedAt": "2025-11-03T15:51:44.667Z",
        "value": 1
      }
    ]
  }
]

Save readings

post

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

Authorizations
Body
all ofOptional
Responses
204

The readings were saved

No content
post
/api/readings
POST /api/readings HTTP/1.1
Host: api.switchmarket.se
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 154

{
  "meters": [
    {
      "id": "text",
      "registers": [
        {
          "id": "text",
          "values": [
            {
              "timestamp": "2025-11-03T15:51:44.667Z",
              "periodTo": "2025-11-03T15:51:44.667Z",
              "value": 1
            }
          ]
        }
      ]
    }
  ]
}
No content

Get registers hourly average readings

get

Required permissions: Meter.Organization.Read

Authorizations
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
get
/api/readings/average/hourly
GET /api/readings/average/hourly?organizationId=1&registerId=1&start=2025-11-03T15%3A51%3A44.667Z&end=2025-11-03T15%3A51%3A44.667Z HTTP/1.1
Host: api.switchmarket.se
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

[
  {
    "registerId": 1,
    "readings": [
      {
        "periodFrom": "2025-11-03T15:51:44.667Z",
        "periodTo": "2025-11-03T15:51:44.667Z",
        "updatedAt": "2025-11-03T15:51:44.667Z",
        "value": 1
      }
    ]
  }
]
PreviousProductNextResource

Last updated

Was this helpful?