Skip to main content

machs-dir-selbst Public API

Integrate external systems with your company's data in the machs-dir-selbst planner — projects, offers, customers, materials and more — over a REST API, and subscribe to events via webhooks.

  • Base URL: https://api.machsdirselbst.solar
  • Auth: a company-scoped API key as a Bearer token
  • Format: JSON; cursor-free, offset-paginated lists
note

api.machsdirselbst.solar is still being provisioned. Until it resolves, use the gateway URL from your integration contact — every path below is the same, only the host differs.

Where to next​

  • Quickstart — your first request in one curl.
  • Authentication — API keys and scopes.
  • Webhooks — receive events when data changes.
  • API Reference — every endpoint, generated from the OpenAPI spec (see the sidebar).

Conventions​

  • IDs are returned as strings.
  • Lists accept limit (1–200), offset, sort (field.asc/field.desc, whitelisted per resource) and per-field filters, and respond with { data, total, limit, offset }.
  • Errors are { "error": "<code>", "message"?: "<detail>" } with the matching HTTP status (400 validation, 401 auth, 403 scope, 404 not found).