Get account

Get workspace, key permissions, and billing balance

GET https://api.el.ai/v1/account

Authorization

Authorization header · string Required

Bearer el_live_…, a workspace API key. About keys

Response · 200

application/json

Success.

object string

One of

account
workspace object
- id string · uuid
- name string
key object
- id string · uuid
- name string
- access string
  
  One of
  
  full
  read_only
billing object
- mode string · nullable
  
  One of
  
  prepaid
  invoiced
- balance string · nullable
- currency string
  
  One of
  
  usd
- rate_per_minute string · nullable

Headers

request-id string

Support request identifier.
cache-control string

One of

no-store

Errors

Errors share one shape: an error object with a stable code and a human-readable message. See Errors and retries.

400	Invalid request
401	Missing, invalid or revoked API key
402	Insufficient funds or budget
403	Key or workspace does not allow this operation
404	Resource not found in this workspace
409	Conflict
413	JSON body exceeds 64 KiB
415	Unsupported content type
422	Media or order cannot be processed
429	Shared read limit per API key or write limit per workspace exceeded
500	Internal error
503	temporarily_unavailable: request limit enforcement is unavailable, or job submission is busy. Retry after 5 seconds.

curl https://api.el.ai/v1/account \
  -H "Authorization: Bearer $ECHO_API_KEY"

import os
import requests

response = requests.get(
    "https://api.el.ai/v1/account",
    headers={
        "Authorization": f"Bearer {os.environ['ECHO_API_KEY']}",
    },
)
response.raise_for_status()
print(response.json())

const response = await fetch("https://api.el.ai/v1/account", {
  headers: {
    Authorization: `Bearer ${process.env.ECHO_API_KEY}`,
  },
});
const data = await response.json();
console.log(data);

Response

200

{
  "object": "account",
  "workspace": {
    "id": "cec18557-248a-4916-938a-4cb386bedcb9",
    "name": "Northfield College"
  },
  "key": {
    "id": "cec18557-248a-4916-938a-4cb386bedcb9",
    "name": "Northfield College",
    "access": "full"
  },
  "billing": {
    "mode": "prepaid",
    "balance": "184.20",
    "currency": "usd",
    "rate_per_minute": "0.20"
  }
}

Error

{
  "error": {
    "code": "invalid_request",
    "message": "Send exactly one of media_url or upload_id.",
    "param": "media_url"
  }
}