API Reference

Energy Connect Public API v1 — RESTful JSON over HTTPS

Quickstart

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

Authentication

Pass your API key either as an X-API-Key header or as an Authorization: Bearer token — both are accepted. 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/public/orders

# equivalently, as a Bearer token:
curl -H "Authorization: Bearer ec_live_your_key_here" \
  https://api.energyconnecter.ai/v1/public/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_ERROR • 401 INVALID_API_KEY
403 INSUFFICIENT_SCOPE • 404 NOT_FOUND
429 RATE_LIMIT_EXCEEDED