Get balance - Lumenfall

curl https://api.lumenfall.ai/v1/balance \
  -H "Authorization: Bearer $LUMENFALL_API_KEY"

{
  "object": "balance",
  "billing_type": "prepaid",
  "available": {
    "amount": 12.50,
    "currency": "usd"
  }
}

GET

balance

curl https://api.lumenfall.ai/v1/balance \
  -H "Authorization: Bearer $LUMENFALL_API_KEY"

{
  "object": "balance",
  "billing_type": "prepaid",
  "available": {
    "amount": 12.50,
    "currency": "usd"
  }
}

Returns the current balance and billing type for your account.

This endpoint uses the native Lumenfall API path (/v1/balance), not the OpenAI-compatible prefix (/openai/v1).

Response

object

string

Always balance.

billing_type

string

Your account’s billing type - either prepaid or postpaid.

available

object

The available balance.

Show Balance object

amount

number | null

Available balance in USD. null for postpaid accounts or if the balance is temporarily unavailable.

currency

string

Always usd.

curl https://api.lumenfall.ai/v1/balance \
  -H "Authorization: Bearer $LUMENFALL_API_KEY"

{
  "object": "balance",
  "billing_type": "prepaid",
  "available": {
    "amount": 12.50,
    "currency": "usd"
  }
}