Nomos

Nomos runs a whitelabel (embedded) energy platform for the German market: partners sell dynamic, EPEX-spot electricity plans under their own brand while Nomos, a licensed and regulated electricity retailer, handles customer onboarding, supplier switching, smart-meter (iMSys) orders, §14a EnWG grid-fee reductions, dynamic pricing, metering, billing and solar feed-in compensation behind a single REST API. The API (api.nomos.energy) uses OAuth 2.0 with read:*/write:* scopes, dated X-API-Version releases, cursor pagination, bracket-notation filtering, a structured error envelope and signed webhooks, plus hosted checkout and customer-portal surfaces.

Nomos publishes 12 APIs on the APIs.io network, including Authentication API, Customers API, Events API, and 9 more. Tagged areas include Company, Energy, Electricity, Utilities, and Embedded Finance.

The Nomos catalog on APIs.io includes 1 event-driven AsyncAPI specification.

Nomos’ developer surface includes documentation, API reference, getting-started guide, signup flow, authentication, changelog, and 19 more developer resources.

🌐 Visit website 📡 Source on GitHub
46.5/100 developing ▬ flat Agent 75/100 agent native Full breakdown ↓
scored 2026-07-27 · rubric v0.5
AccessSelf serve
12 APIs 1 MCP Servers
CompanyEnergyElectricityUtilitiesEmbedded FinanceDynamic PricingBillingMeteringSmart MeterGermanyOAuthWebhooks

Kin Score

Kin Score Kin Score How this is scored →
scored 2026-07-27 · rubric v0.5
Composite quality — 46.5/100 · developing
Contract Quality 15.5 / 25
Developer Ergonomics 12.2 / 20
Commercial Clarity 4.7 / 20
Operational Transparency 4.1 / 13
Governance 0.0 / 12
Discoverability 10.0 / 10
Agent readiness — 75/100 · agent native
Machine-Readable Contract 18 / 18
Agentic Access Contract 15 / 15
MCP Server 12 / 12
Machine-Readable Auth 10 / 10
Idempotency 0 / 9
Stable Error Semantics 8 / 8
Request/Response Examples 0 / 7
Rate-Limit Signaling 0 / 7
Typed Event Surface 6 / 6
Agent Skills 5 / 5
Well-Known Catalog 4 / 4
Consent & Bot Identity 0 / 3
Improve this rating by publishing the missing artifacts — every area above can be raised, and the full rubric is at apis.io/rating/. This rating is computed from github.com/api-evangelist/nomos: open an issue to ask a question, or submit a pull request to add artifacts. Want it done for you? Prioritized profiling — $2,500 →

APIs 12

Individual APIs this provider publishes, each with its own machine-readable definition.

Nomos Authentication API

The Authentication API from Nomos — 3 operation(s) for authentication.

Nomos Customers API

The Customers API from Nomos — 2 operation(s) for customers.

Nomos Events API

The Events API from Nomos — 1 operation(s) for events.

Nomos Grid Fee Reductions API

The Grid Fee Reductions API from Nomos — 2 operation(s) for grid fee reductions.

Nomos Invoices API

The Invoices API from Nomos — 3 operation(s) for invoices.

Nomos Leads API

The Leads API from Nomos — 2 operation(s) for leads.

Nomos Market Partners API

The Market Partners API from Nomos — 1 operation(s) for market partners.

Nomos Plans API

The Plans API from Nomos — 3 operation(s) for plans.

Nomos Prices API

The Prices API from Nomos — 1 operation(s) for prices.

Nomos Smart Meter Orders API

The Smart Meter Orders API from Nomos — 2 operation(s) for smart meter orders.

Nomos Subscriptions API

The Subscriptions API from Nomos — 3 operation(s) for subscriptions.

Nomos Usage API

The Usage API from Nomos — 3 operation(s) for usage.

Scroll for all 12

MCP Servers 1

Model Context Protocol servers that expose these APIs to AI agents.

nomos-mcp.yml

MCP SERVER

Event Specifications 1

AsyncAPI definitions for this provider's event-driven and streaming APIs.

Nomos Webhooks

Real-time webhook events delivered by Nomos as signed HTTPS POST requests. Generated by API Evangelist from the published webhook documentation (https://docs.nomos.energy/webhoo...

ASYNCAPI

Security Posture 2

Authentication, domain security, vulnerability disclosure, and trust-center signals.

Nomos Authentication

oauth2/http · 2 schemes

SECURITY

Nomos Domain Security

TLSv1.3 · DMARC

SECURITY

Scopes 1

OAuth scopes governing access to this provider's APIs.

Nomos Scopes

2 scopes

2 scopes

SCOPES

Agentic Access 1

Recommended x-agentic-access execution contracts for AI agents.

Nomos Agentic Access

33 operations · 11 acting · 1 human-in-the-loop

33 operations · 11 acting

AGENTIC

Resources

Get Started 3

Portal, sign-up, and the first successful call

DeveloperPortal
DeveloperPortal
 GettingStarted
GettingStarted
 SignUp
SignUp

Documentation 3

Reference material describing how the API behaves

Documentation
Documentation
 APIReference
APIReference
 AsyncAPI
AsyncAPI

Agent Surfaces 5

MCP servers, agent skills, and machine-readable catalogs

AgentSkill
AgentSkill
 MCPServer
MCPServer
 AgenticAccess
AgenticAccess
 LLMsTxt
LLMsTxt
 WellKnown
WellKnown

Design & Contract 7

Pagination, idempotency, versioning, errors, and events

Conventions
Conventions
 ErrorCatalog
ErrorCatalog
 DataModel
DataModel
 Components
Components
 Lifecycle
Lifecycle
 Webhooks
Webhooks
 Conformance
Conformance

Scroll for all 7

Access & Security 3

Authentication, authorization, and security posture

Authentication
Authentication
 OAuthScopes
OAuthScopes
 DomainSecurity
DomainSecurity

Operate 2

Status, limits, changes, and where to get help

Deprecation
Deprecation
 ChangeLog
ChangeLog

Commercial 1

Pricing, plans, and the legal terms of use

PrivacyPolicy
PrivacyPolicy

Company 1

The organization behind the API

Website
Website

Source (apis.yml)

apis.yml Raw ↑ 
aid: nomos
accessModel:
  pricing: unknown
  onboarding: self-serve
  trial: false
  try_now: false
  public: false
  label: Self-serve signup
  confidence: medium
  source:
  - authentication
  generated: '2026-07-22'
  method: derived
image: https://kinlane-images.s3.amazonaws.com/shared/apis-json/icons/nomos.png
name: Nomos
description: 'Nomos runs a whitelabel (embedded) energy platform for the German market: partners sell dynamic, EPEX-spot electricity
  plans under their own brand while Nomos, a licensed and regulated electricity retailer, handles customer onboarding, supplier
  switching, smart-meter (iMSys) orders, §14a EnWG grid-fee reductions, dynamic pricing, metering, billing and solar feed-in
  compensation behind a single REST API. The API (api.nomos.energy) uses OAuth 2.0 with read:*/write:* scopes, dated X-API-Version
  releases, cursor pagination, bracket-notation filtering, a structured error envelope and signed webhooks, plus hosted checkout
  and customer-portal surfaces.'
url: https://raw.githubusercontent.com/api-evangelist/nomos/refs/heads/main/apis.yml
x-type: company
x-source: vc-portfolio
x-backed-by:
- speedinvest
x-tier: active
x-tier-reason: has-public-api
specificationVersion: '0.20'
created: '2026-07-17'
modified: '2026-07-20'
tags:
- Company
- Energy
- Electricity
- Utilities
- Embedded Finance
- Dynamic Pricing
- Billing
- Metering
- Smart Meter
- Germany
- OAuth
- Webhooks
apis:
- aid: nomos:nomos-authentication-api
  name: Nomos Authentication API
  description: The Authentication API from Nomos — 3 operation(s) for authentication.
  humanURL: https://docs.nomos.energy
  baseURL: https://api.nomos.energy
  tags:
  - Authentication
  properties:
  - type: OpenAPI
    url: openapi/nomos-authentication-api-openapi.yml
  - type: AsyncAPI
    url: asyncapi/nomos-webhooks-asyncapi.yml
  - type: Documentation
    url: https://docs.nomos.energy
  - type: APIReference
    url: https://docs.nomos.energy/api-references/introduction
- aid: nomos:nomos-customers-api
  name: Nomos Customers API
  description: The Customers API from Nomos — 2 operation(s) for customers.
  humanURL: https://docs.nomos.energy
  baseURL: https://api.nomos.energy
  tags:
  - Customers
  properties:
  - type: OpenAPI
    url: openapi/nomos-customers-api-openapi.yml
  - type: AsyncAPI
    url: asyncapi/nomos-webhooks-asyncapi.yml
  - type: Documentation
    url: https://docs.nomos.energy
  - type: APIReference
    url: https://docs.nomos.energy/api-references/introduction
- aid: nomos:nomos-events-api
  name: Nomos Events API
  description: The Events API from Nomos — 1 operation(s) for events.
  humanURL: https://docs.nomos.energy
  baseURL: https://api.nomos.energy
  tags:
  - Events
  properties:
  - type: OpenAPI
    url: openapi/nomos-events-api-openapi.yml
  - type: AsyncAPI
    url: asyncapi/nomos-webhooks-asyncapi.yml
  - type: Documentation
    url: https://docs.nomos.energy
  - type: APIReference
    url: https://docs.nomos.energy/api-references/introduction
- aid: nomos:nomos-grid-fee-reductions-api
  name: Nomos Grid Fee Reductions API
  description: The Grid Fee Reductions API from Nomos — 2 operation(s) for grid fee reductions.
  humanURL: https://docs.nomos.energy
  baseURL: https://api.nomos.energy
  tags:
  - Grid Fee Reductions
  properties:
  - type: OpenAPI
    url: openapi/nomos-grid-fee-reductions-api-openapi.yml
  - type: AsyncAPI
    url: asyncapi/nomos-webhooks-asyncapi.yml
  - type: Documentation
    url: https://docs.nomos.energy
  - type: APIReference
    url: https://docs.nomos.energy/api-references/introduction
- aid: nomos:nomos-invoices-api
  name: Nomos Invoices API
  description: The Invoices API from Nomos — 3 operation(s) for invoices.
  humanURL: https://docs.nomos.energy
  baseURL: https://api.nomos.energy
  tags:
  - Invoices
  properties:
  - type: OpenAPI
    url: openapi/nomos-invoices-api-openapi.yml
  - type: AsyncAPI
    url: asyncapi/nomos-webhooks-asyncapi.yml
  - type: Documentation
    url: https://docs.nomos.energy
  - type: APIReference
    url: https://docs.nomos.energy/api-references/introduction
- aid: nomos:nomos-leads-api
  name: Nomos Leads API
  description: The Leads API from Nomos — 2 operation(s) for leads.
  humanURL: https://docs.nomos.energy
  baseURL: https://api.nomos.energy
  tags:
  - Leads
  properties:
  - type: OpenAPI
    url: openapi/nomos-leads-api-openapi.yml
  - type: AsyncAPI
    url: asyncapi/nomos-webhooks-asyncapi.yml
  - type: Documentation
    url: https://docs.nomos.energy
  - type: APIReference
    url: https://docs.nomos.energy/api-references/introduction
- aid: nomos:nomos-market-partners-api
  name: Nomos Market Partners API
  description: The Market Partners API from Nomos — 1 operation(s) for market partners.
  humanURL: https://docs.nomos.energy
  baseURL: https://api.nomos.energy
  tags:
  - Market Partners
  properties:
  - type: OpenAPI
    url: openapi/nomos-market-partners-api-openapi.yml
  - type: AsyncAPI
    url: asyncapi/nomos-webhooks-asyncapi.yml
  - type: Documentation
    url: https://docs.nomos.energy
  - type: APIReference
    url: https://docs.nomos.energy/api-references/introduction
- aid: nomos:nomos-plans-api
  name: Nomos Plans API
  description: The Plans API from Nomos — 3 operation(s) for plans.
  humanURL: https://docs.nomos.energy
  baseURL: https://api.nomos.energy
  tags:
  - Plans
  properties:
  - type: OpenAPI
    url: openapi/nomos-plans-api-openapi.yml
  - type: AsyncAPI
    url: asyncapi/nomos-webhooks-asyncapi.yml
  - type: Documentation
    url: https://docs.nomos.energy
  - type: APIReference
    url: https://docs.nomos.energy/api-references/introduction
- aid: nomos:nomos-prices-api
  name: Nomos Prices API
  description: The Prices API from Nomos — 1 operation(s) for prices.
  humanURL: https://docs.nomos.energy
  baseURL: https://api.nomos.energy
  tags:
  - Prices
  properties:
  - type: OpenAPI
    url: openapi/nomos-prices-api-openapi.yml
  - type: AsyncAPI
    url: asyncapi/nomos-webhooks-asyncapi.yml
  - type: Documentation
    url: https://docs.nomos.energy
  - type: APIReference
    url: https://docs.nomos.energy/api-references/introduction
- aid: nomos:nomos-smart-meter-orders-api
  name: Nomos Smart Meter Orders API
  description: The Smart Meter Orders API from Nomos — 2 operation(s) for smart meter orders.
  humanURL: https://docs.nomos.energy
  baseURL: https://api.nomos.energy
  tags:
  - Smart Meter Orders
  properties:
  - type: OpenAPI
    url: openapi/nomos-smart-meter-orders-api-openapi.yml
  - type: AsyncAPI
    url: asyncapi/nomos-webhooks-asyncapi.yml
  - type: Documentation
    url: https://docs.nomos.energy
  - type: APIReference
    url: https://docs.nomos.energy/api-references/introduction
- aid: nomos:nomos-subscriptions-api
  name: Nomos Subscriptions API
  description: The Subscriptions API from Nomos — 3 operation(s) for subscriptions.
  humanURL: https://docs.nomos.energy
  baseURL: https://api.nomos.energy
  tags:
  - Subscriptions
  properties:
  - type: OpenAPI
    url: openapi/nomos-subscriptions-api-openapi.yml
  - type: AsyncAPI
    url: asyncapi/nomos-webhooks-asyncapi.yml
  - type: Documentation
    url: https://docs.nomos.energy
  - type: APIReference
    url: https://docs.nomos.energy/api-references/introduction
- aid: nomos:nomos-usage-api
  name: Nomos Usage API
  description: The Usage API from Nomos — 3 operation(s) for usage.
  humanURL: https://docs.nomos.energy
  baseURL: https://api.nomos.energy
  tags:
  - Usage
  properties:
  - type: OpenAPI
    url: openapi/nomos-usage-api-openapi.yml
  - type: AsyncAPI
    url: asyncapi/nomos-webhooks-asyncapi.yml
  - type: Documentation
    url: https://docs.nomos.energy
  - type: APIReference
    url: https://docs.nomos.energy/api-references/introduction
maintainers:
- FN: Kin Lane
  email: kin@apievangelist.com
- FN: APIs.json
  email: info@apis.io
common:
- type: Website
  url: https://www.nomos.energy/en/
- type: DeveloperPortal
  url: https://docs.nomos.energy
- type: Documentation
  url: https://docs.nomos.energy
- type: APIReference
  url: https://docs.nomos.energy/api-references/introduction
- type: GettingStarted
  url: https://docs.nomos.energy/quickstart
- type: SignUp
  url: https://dashboard.nomos.energy/login
- type: PrivacyPolicy
  url: https://www.nomos.energy/en/privacy
- type: Authentication
  url: authentication/nomos-authentication.yml
- type: OAuthScopes
  url: scopes/nomos-scopes.yml
- type: Conventions
  url: conventions/nomos-conventions.yml
- type: ErrorCatalog
  url: errors/nomos-problem-types.yml
- type: DataModel
  url: data-model/nomos-data-model.yml
- type: Components
  url: components/nomos-components.yml
- type: Lifecycle
  url: lifecycle/nomos-lifecycle.yml
- type: Deprecation
  url: https://docs.nomos.energy/api-references/versioning
- type: ChangeLog
  url: changelog/nomos-changelog.yml
- type: AsyncAPI
  url: asyncapi/nomos-webhooks-asyncapi.yml
- type: Webhooks
  url: https://docs.nomos.energy/webhooks/introduction
- type: AgentSkill
  url: skills/_index.yml
- type: MCPServer
  url: mcp/nomos-mcp.yml
- type: AgenticAccess
  url: agentic-access/nomos-agentic-access.yml
- type: LLMsTxt
  url: llms/nomos-llms.txt
- type: WellKnown
  url: well-known/nomos-well-known.yml
- type: Conformance
  url: conformance/nomos-conformance.yml
- type: DomainSecurity
  url: security/nomos-domain-security.yml
x-enrichment:
  date: '2026-07-20'
  status: enriched
  artifacts_added: 18
  pass: local-v1