{"openapi":"3.1.0","info":{"title":"engy account read API","version":"1.0.0","description":"Programmatic, read-only access to your account — check your balance, spending/usage, and the live model catalog. Requires a read token (rk-engy-…) issued from the dashboard; it can read these details but cannot spend, and is separate from your sk-engy- inference key."},"servers":[{"url":"https://engy.ai","description":"the dashboard origin"}],"components":{"securitySchemes":{"readToken":{"type":"http","scheme":"bearer","bearerFormat":"rk-engy-…"}},"schemas":{"Error":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"}}}}}}},"security":[{"readToken":[]}],"x-ratelimit":"120 requests per minute per token (429 with Retry-After when exceeded).","paths":{"/api/v1/balance":{"get":{"summary":"Current balance and available (post-holds) balance in µUSD.","responses":{"200":{"description":"balance"},"401":{"description":"unauthorized"}}}},"/api/v1/usage":{"get":{"summary":"Requests and spend, aggregated by day and by model.","parameters":[{"name":"days","in":"query","schema":{"type":"integer","enum":[7,30],"default":30},"description":"window in days: 7 or 30 (default 30)"},{"name":"model","in":"query","schema":{"type":"string"},"description":"optional filter"}],"responses":{"200":{"description":"usage"},"400":{"description":"invalid days"}}}},"/api/v1/models":{"get":{"summary":"Live model catalog with per-1k-token pricing and context limits.","responses":{"200":{"description":"models"}}}}}}