Contact us

Nomos

Book Demo

Support

Search Suppliers

Two-letter country code (ISO 3166-1 alpha-2).

bearerAuth

Nomos provides a comprehensive API for building dynamic electricity products. Integrate smart meter data, real-time pricing, and automated billing to create innovative energy solutions for your customers.

Introduction

Get started with Nomos Energy API in minutes

Quickstart

Troubleshoot problems with this comprehensive breakdown of all error codes.

Error Codes

Overview

Authenticate server-to-server API requests

Client Credentials Grant

Authenticate third-party integrations requiring customer consent

Authorization Code Grant

Learn how to create a custom checkout experience using our authentication system

Build Your Own Checkout

Guide to integrating Home Energy Management Systems (HEMS) with our authentication

HEMS Integration

Retrieve a Plan object with the given ID.

Retrieve a Plan

Returns a list of all active plans sorted by creation date, with most recent plans first.

List All Active Plans

Returns a list of all suppliers sorted by creation date, with most recent suppliers first.

List All Suppliers

Retrieve a Quote object for a specific plan, zip code, usage, and meter type.

Retrieve a Quote

Retrieve a Subscription object with the given ID.

Retrieve a Subscription

Returns a list of all subscriptions sorted by creation date, with most recent subscriptions first.

List All Subscriptions

Create a new subscription with the given parameters.

Create a Subscription

Retrieve a price object for a given subscription, including the variable price time series to optimize your consumption against.

Getting Started

Authentication

Guides

API Reference

Search Suppliers

Authorizations

Query Parameters

Response