Skip to main content

Overview

The NOX Control Package provides access to:
  • Device information
  • Energy consumption data.
    • Forecasted consumption (= nomination)
    • Actual consumption
    • Typical consumption if NOX would not have altered the device steering.
  • Changing user Settings
  • Deleting a user
The Partner Control Package provides additional access to:
  • Heat pump current state and forecasted state expressed as a Battery.
  • Controling the heat pump by submitting a control schedule.

Getting Started

Prerequisites

Base URL

All endpoints use the base URL:
  • Sandbox: https://api.sandbox.nox.energy
  • Production: https://api.nox.energy

Core Workflows

All our collection api endpoints use a next_token to paginate through results if the size limit of the response has been reached. To paginate through a response, you can use the next_token received in the response as a query parameter and call the same endpoint with the same parameters again. You can repeat this process until you have received the last page of the response, which is signified by the next_token field becoming null. Pass the next_token back exactly as you received it. A token that was altered or not issued by the API returns a 400. The consumption endpoints also accept an offset query parameter to fetch a page directly: limit=100&offset=200 returns items 201 to 300. Use either offset or next_token in a request, not both. Sending both returns a 400. The device list (/v1/devices) pages by next_token only.

Guide sections

Next Steps