Nomos

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

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

Troubleshoot problems with this comprehensive breakdown of all error codes.

BAD_REQUEST

NOT_FOUND

UNAUTHORIZED

FORBIDDEN

CONFLICT

UNPROCESSABLE_ENTITY

TOO_MANY_REQUESTS

Error Codes

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

Search 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

Error Codes

INTERNAL SERVER ERROR