Skip to main content

Quickstart

1. Create an API key​

In the planner, go to Settings → API Keys, create a key with the scopes you need, and copy it (shown once). Keys look like mds_live_….

2. Make a request​

curl https://api.machsdirselbst.solar/v1/projects \
  -H "Authorization: Bearer mds_live_your_key"
{
  "data": [
    { "id": "42", "name": "Dach Müller", "state": "ACTIVE", "customerId": "77", "createdAt": "2026-07-01T10:22:00Z" }
  ],
  "total": 1,
  "limit": 50,
  "offset": 0
}

3. Filter, sort, paginate​

curl "https://api.machsdirselbst.solar/v1/offers?state=ACCEPTED&sort=offer_price.desc&limit=20&offset=0" \
  -H "Authorization: Bearer mds_live_your_key"

4. Create something​

curl -X POST https://api.machsdirselbst.solar/v1/customers \
  -H "Authorization: Bearer mds_live_your_key" \
  -H "Content-Type: application/json" \
  -d '{ "firstName": "Anna", "lastName": "Müller", "email": "anna@example.com" }'

Next: Authentication & scopes.