API Reference

Energy Connect Public API v1 — RESTful JSON over HTTPS

Quickstart

Base URL: https://api.energyconnecter.ai/v1

Authentication

Pass your API key in the X-API-Key header. Keys start with ec_live_ (production) or ec_test_ (sandbox).

curl -H "X-API-Key: ec_live_your_key_here" \
  https://api.energyconnecter.ai/v1/orders

Rate Limits

600 requests/min burst
50,000 billable requests/month
RFC 9239 headers on every response

Response Format

Success: { success: true, data: ... }
List: { success: true, data: [...], meta: { total, page, pageSize, totalPages, hasMore } }
Error: { success: false, error: { code, message } }

Pagination

Use ?page=1&pageSize=20 query params.
Max pageSize is 100 (500 for connections).

Errors

400 Validation • 401 Unauthorized
403 Forbidden • 404 Not found
429 Rate limited