Partner API · Documentation
Partner API · Documentation
messpunkt.io runs the ETL and aggregation layer for German sub-metering — Wärme, Wasser, Heizkostenverteiler. Our Partner API lets your ERP read consumption and meter-reading data on behalf of a landlord, with an auth model a compliance officer will sign off on.
1.0.0-rc.3 · SemVer · changelog/v1 · 6 months deprecation overlapA contract designed so your integration stays the same as the industry standards underneath it evolve.
Generate a client for C#, Java, TypeScript, Python with openapi-generator-cli. No anyOf escape hatches, every field typed.
User-delegated tokens, scoped per Tenant. Send a DPoP proof and the token is bound to your key. DPoP guide →
Landlord picks which Liegenschaften an ERP can see. Out-of-scope queries return 404, never 403 — no scope enumeration.
Month-end readings and the billable consumption per device, computed like the landlord portal. No behavioural profiles of residents.
Device changes are first-class: separate segments, clear installation windows. You never have to diff serials to detect a swap.
Synthetic data from real production distributions. Runs a full OAuth flow. Same fixture every time — reproducible demos.
One source of truth, read over REST.
Read-only today. external_ref is always null; what is planned for writing is on the roadmap.
The one-picture version: landlord consent with a Property picker, runtime requests with server-side scope filtering, and disconnecting from the landlord portal — all three phases in one sequence.
Source: auth-flow.mmd (Mermaid sequence diagram) · SVG generated via mermaid-cli.
Three ways in, depending on what you're here to do.
Four shell commands from zero to your first authenticated call, with the full OAuth 2.1 + PKCE round-trip.
Start the walkthroughClient registration, consent, PKCE and iss check, refresh rotation, revocation, errors and rate limits, step by step against the sandbox.
Who owns which data once an ERP writes occupancies, the planned event feed and webhooks, and the write semantics. Not available today.
Read the roadmapHow landlords connect their own AI assistant to the messpunkt.io MCP server. Live since 30 September 2026; access is enabled per customer organisation.
Anleitung lesenEndpoints, stateless transport, auth challenge, scopes per tool and the tool reference generated from tools/list.
Every endpoint, schema, example, error response — rendered in Redoc with search and code samples.
Open the reference13 pre-wired requests covering every endpoint and scenario. Download the zip, click Get Access Token, send.
Download the collectionEvery status code, the type suffix, whether it's retryable, and the recommended client action.
Sender-constraining tokens with working code in C#, Node, Python, and curl. Optional; fully verified when you use it.
Implement DPoPScalar with built-in OAuth flow, code-sample tabs for 8 languages, and Test Request against the live sandbox.
Open in ScalarThe production API has been running against real data since 30 September 2026. We register your ERP client on request; the landlord's API access is enabled per customer organisation. You want to write occupancies? Read the roadmap — the first partner shapes the interface.