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 20 more developer resources.

🌐 Visit website 📡 Source on GitHub

49.9/100 developing ▬ flat Agent 42/100 agent ready Full breakdown ↓
scored 2026-08-20 · rubric v0.12.0

AccessSelf serve

12 APIs 1 MCP Servers

CompanyEnergyElectricityUtilitiesEmbedded FinanceDynamic PricingBillingMeteringSmart MeterGermanyAuthenticationWebhook

Kin Score

Kin Score How this is scored →
scored 2026-08-20 · rubric v0.12.0

Composite quality — 49.9/100 · developing

Contract Quality 13.3 / 21

Developer Ergonomics 9.7 / 17

Access Clarity 1.8 / 17

Operational Transparency 3.5 / 11

Contract Governance 3.1 / 10

Discoverability 6.9 / 9

Regulatory Posture 7.7 / 15

Agent readiness — 42/100 · agent ready

Machine-Readable Contract 18 / 18

Agentic Access Contract 10 / 10

Documented Reversibility 0 / 6

MCP Server 0 / 12

Machine-Readable Auth 10 / 10

Idempotency 0 / 9

Stable Error Semantics 8 / 8

Request/Response Examples 7 / 7

Rate-Limit Signaling 0 / 7

Typed Event Surface 6 / 6

Agent Skills 5 / 5

Well-Known Catalog 0 / 4

Consent & Bot Identity 0 / 3

A2A Agent Card 0 / 8

Dry-Run / Simulate Mode 0 / 4

Regulatory Posture applies to this provider. Its tags matched the Energy & Utilities regime, so Regulatory Posture carries 15 points of the composite. If this regime is wrong for your business, say so on your provider repo — the applicability map is public and we will correct it.

The six quality facets above are damped to 85 points between them, because the conditional facet above carries the other 15. That is why each facet's contribution is shown against a damped maximum: raising a quality facet moves the composite by 85% of its nominal weight, not 100%. The full arithmetic is at apis.io/rating/.

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.

Open Collections 13

Open, tool-agnostic API collections (OpenAPI-derived and Bruno).

MCP Servers 1

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

Scopes 1

OAuth scopes governing access to this provider's APIs.

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

MCPServer

AgenticAccess

LLMsTxt

WellKnown

Design & Contract 7

Pagination, idempotency, versioning, errors, and events

Conventions

ErrorCatalog

DataModel

Components

Lifecycle

Webhooks

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

Other 1

Properties that don't map to a standard resource type

Overlay

Overlay

Source (apis.yml)

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.23'
created: '2026-07-17'
modified: '2026-07-20'
tags:
- Company
- Energy
- Electricity
- Utilities
- Embedded Finance
- Dynamic Pricing
- Billing
- Metering
- Smart Meter
- Germany
- Authentication
- Webhook
tags_raw:
- 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:
  - Event
  tags_raw:
  - 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:
  - Subscription
  tags_raw:
  - 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: Overlay
  url: overlays/nomos-openapi-overlay.yaml
- 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