Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.nomos.energy/llms.txt

Use this file to discover all available pages before exploring further.

​
Integration Paths

Hosted Components

Send customers to a branded, Nomos-hosted checkout and customer portal. No frontend code required.

Build your own

Quote pricing, collect customer info, and create a subscription against the API end-to-end.

​
Make your first authenticated request

1

Get an access token

The Nomos API uses OAuth 2.0. This quickstart uses the client credentials grant for server-to-server requests; for third-party integrations acting on behalf of a customer, see Authentication.Create a client_id and client_secret in the Nomos dashboard. If you don’t have dashboard access yet, ask your dedicated Nomos contact.Exchange your credentials for a short-lived access token:
curl -X POST https://api.nomos.energy/oauth/token \
  -u "${CLIENT_ID}:${CLIENT_SECRET}" \
  -d grant_type=client_credentials
The access token is valid for 60 minutes. Cache it; when it expires, refresh it instead of asking for a new one.
2

Make a request

List the plans configured on your organization. This proves your token works.
curl https://api.nomos.energy/plans \
  -H "Authorization: Bearer ${ACCESS_TOKEN}"
If you see an UNAUTHORIZED error, your token is missing, malformed, or expired. See Errors.