Skip to main content
2025-09-14.anode release notes

​
Connect endpoints

Connect endpoints use a JSON-based session flow rather than the standard REST request/response pattern.

​
All other endpoints

All other endpoints are RESTful and resource-driven, following standard HTTP conventions.

​
Errors

Flatpeak uses standard HTTP status codes to indicate the success or failure of requests.
The 422 status code is used to signal two important conditions.
  • Returns the account_disabled code when your account is out of subscription or disabled.
  • Returns pending_connect, no_tariff_connected, or no_price_data when energy price data is not available.
See the Errors article for implementation guidance.

​
Test mode

Use test (sandbox) mode for development and testing.

​
Versioning

By default, all requests use your Flatpeak account’s default API version, configured in Dashboard. You can override it by including the Flatpeak-Version header in your request: 
❯ curl -s --request GET \
  --url "https://api.flatpeak.com/devices/dev_66b1ea3cbbfa0d30b978ce37" \
  --header "Authorization: Bearer $TOKEN" \
  --header 'Flatpeak-Version: 2025-09-14.anode'
Learn more about working with API versions in the API Versioning guide.