# n3rgy Customer Service API V2

**Canonical:** https://apis.io/apis/n3rgy/customer-service-api-v2/  
**Provider:** n3rgy — https://apis.io/providers/n3rgy/  
**Base URL:** https://api-v2.data.n3rgy.com  
**Documentation:** https://customer-api-user-manuals.data.n3rgy.com/

n3rgy Customer Service API V2 is published by [n3rgy](https://apis.io/providers/n3rgy/) on the [APIs.io](https://apis.io/) network, described by a machine-readable OpenAPI specification. Tagged areas include Smart Metering, Consumption, Tariff, Consent, and Electricity. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, an API reference, authentication docs, a changelog, and rate-limit docs.

The consent-scoped smart-meter data API of the n3rgy platform. A business holding a valid n3rgy API key lists the properties (MPxNs) it has active consent for, discovers which utilities (electricity, gas) and reading types (consumption, production, tariff) are available for each, and retrieves the underlying half-hourly data. The same contract also covers meter update-frequency control, MPxN and address lookup, read-inventory / firmware and last-communications checks, on-demand "update now" fetches, push-notification configuration, and an upload/devices surface for non-DCC device data. Every operation is secured with the x-api-key header; consent-bearing operations additionally validate that an active consent exists for the HAN behind the given MPxN. A free sandbox with demonstration MPxNs mirrors the live contract on a separate host.

## Machine-readable artifacts (23)

- **OpenAPI** — https://raw.githubusercontent.com/api-evangelist/n3rgy/refs/heads/main/openapi/n3rgy-customer-service-api-v2-openapi.yaml
- **Documentation** — https://customer-api-user-manuals.data.n3rgy.com/
- **APIReference** — https://customer-api-user-manuals.data.n3rgy.com/api-specification/
- **Authentication** — https://customer-api-user-manuals.data.n3rgy.com/authentication/
- **Documentation** — https://customer-api-user-manuals.data.n3rgy.com/requests/
- **Documentation** — https://customer-api-user-manuals.data.n3rgy.com/schemas/
- **Sandbox** — https://customer-api-user-manuals.data.n3rgy.com/sandbox-requests/
- **Documentation** — https://customer-api-user-manuals.data.n3rgy.com/electricity-format/
- **Documentation** — https://customer-api-user-manuals.data.n3rgy.com/gas-format/
- **ChangeLog** — https://customer-api-user-manuals.data.n3rgy.com/change-log/
- **SignUp** — https://data.n3rgy.com/business-sign-up
- **Overlay** — https://raw.githubusercontent.com/api-evangelist/n3rgy/refs/heads/main/overlays/n3rgy-customer-service-api-v2-overlay.yaml
- **Sandbox** — https://raw.githubusercontent.com/api-evangelist/n3rgy/refs/heads/main/sandbox/n3rgy-sandbox.yml
- **Conventions** — https://raw.githubusercontent.com/api-evangelist/n3rgy/refs/heads/main/conventions/n3rgy-conventions.yml
- **ErrorCatalog** — https://raw.githubusercontent.com/api-evangelist/n3rgy/refs/heads/main/errors/n3rgy-problem-types.yml
- **RateLimits** — https://raw.githubusercontent.com/api-evangelist/n3rgy/refs/heads/main/rate-limits/n3rgy-rate-limits.yml
- **Examples** — https://raw.githubusercontent.com/api-evangelist/n3rgy/refs/heads/main/examples/_index.yml
- **DataModel** — https://raw.githubusercontent.com/api-evangelist/n3rgy/refs/heads/main/data-model/n3rgy-data-model.yml
- **Webhooks** — https://raw.githubusercontent.com/api-evangelist/n3rgy/refs/heads/main/asyncapi/n3rgy-push-notifications-webhooks.yml
- **MCPServer** — https://raw.githubusercontent.com/api-evangelist/n3rgy/refs/heads/main/mcp/n3rgy-mcp.yml
- **ToolCrosswalk** — https://raw.githubusercontent.com/api-evangelist/n3rgy/refs/heads/main/mcp/n3rgy-tool-crosswalk.yml
- **AgentSkill** — https://raw.githubusercontent.com/api-evangelist/n3rgy/refs/heads/main/skills/_index.yml
- **APIsJSON** — https://raw.githubusercontent.com/api-evangelist/n3rgy/refs/heads/main/apis.yml

## Tags

Smart Metering, Consumption, Tariff, Consent, Electricity, Gas

---

Profiled by [API Evangelist](https://apievangelist.com) and published on [APIs.io](https://apis.io/apis/n3rgy/customer-service-api-v2/). The API's provider profile, Kin Score and agent-readiness rating are at https://apis.io/providers/n3rgy/.