Chargers
Register the account's charger against a MID-certified model from the Joulo catalog.
Chargers
ERE requires MID-metered kWh. Registering the account's charger against a MID-certified model from the Joulo catalog is what makes the account eligible: the catalog carries the verified MID verdict, so you don't assert MID status yourself.
Register a charger
POST /v1/chargers — scope cpo:chargers:write
curl -X POST https://api.joulo.nl/functions/v1/api/v1/chargers \
-H "Authorization: Bearer <token>" \
-H "Content-Type: application/json" \
-d '{
"account_id": "60092124-c768-4191-9c9d-55ef3fc49999",
"catalog_charger_id": "81978554-c5ec-4215-8968-95d34a4e8c68",
"serial_number": "ACE0013982"
}'{
"ok": true,
"charger_id": "…",
"catalog": { "brand": "Alfen", "model": "Eve Double Plus" },
"mid_eligible": true,
"account_ere_eligible": true
}Body
| Field | Required | Description |
|---|---|---|
account_id | yes | The account to register the charger on. |
catalog_charger_id | yes | Id of a MID model in the Joulo catalog. |
serial_number | no | The unit's serial/meter number, for your records. |
Catalog ids. Joulo provides the catalog id for your model(s). The model
must be MID-certified in the catalog; a non-MID model returns
422 catalog_not_mid.
Idempotent. One charger per account — re-posting returns the existing
charger ("idempotent": true).
account_ere_eligible. Registering the MID charger is usually the last
automated gate. When the response returns account_ere_eligible: true, the
account has cleared every requirement — validated EAN, signed machtiging, MID
charger, and IBAN — and its kWh will count toward ERE. If it's false, one of
those is still missing.
Errors
| HTTP | error |
|---|---|
| 400 | invalid_account_id, invalid_catalog_charger_id |
| 404 | account_not_found, catalog_not_found |
| 409 | no_connection (register the account's connection first) |
| 422 | catalog_not_mid |