Daya API

Get PAYG Balance ​

GET https://api.dayaai.com/api/v1/management/payg/balance

Returns the Pay As You Go credit balance for the current account, including the total balance and a breakdown by credit source.

Authentication ​

Authorization Header ​

http
Authorization: Bearer <DAYA_MANAGEMENT_API_KEY>
  • Name: Authorization
  • Format: Bearer <API_KEY>
  • Description: A Management API Key created in the Daya Console

⚠️ Management API Key required

This endpoint only accepts Management API Keys. Standard API Keys are not supported.

Rate Limiting ​

Each endpoint has its own independent rate limit counter. The maximum number of requests per minute is configured at the platform level. Exceeding the limit returns a 422 error.

Returns ​

data.currency string ​

Currency unit. Always "usd".

data.total_credits number ​

The account's current total PAYG credit balance (USD).

data.top_up_credits number ​

Credits obtained through direct top-ups (USD).

data.bonus_credits number ​

Credits obtained through bonuses, gifts, or promotions (USD).

💡 Balance breakdown

total_credits = top_up_credits + bonus_credits (minor floating-point differences may apply).

bash
curl https://api.dayaai.com/api/v1/management/payg/balance \
  -H "Authorization: Bearer $DAYA_MANAGEMENT_API_KEY"
python
import requests

response = requests.get(
    "https://api.dayaai.com/api/v1/management/payg/balance",
    headers={"Authorization": f"Bearer {DAYA_MANAGEMENT_API_KEY}"}
)
print(response.json())
javascript
const response = await fetch("https://api.dayaai.com/api/v1/management/payg/balance", {
  headers: { Authorization: `Bearer ${DAYA_MANAGEMENT_API_KEY}` },
});
const data = await response.json();
json
{
  "success": true,
  "data": {
    "currency": "usd",
    "total_credits": 482.74,
    "top_up_credits": 35.00,
    "bonus_credits": 447.74
  }
}