Account API

Read your current plan, quota, credits used, balance, and next billing date. Useful for budget tracking in agents, dashboards, and scheduled jobs that need to back off before hitting the cap.

Authentication

Same ApiKey header as every other Ujeebu endpoint.

GET ApiKey: YOUR_API_KEY

Request

GET https://api.ujeebu.com/account

No query parameters. The endpoint returns data for the account that owns the API key.

WARNING — Rate Limit

Calls to this endpoint do not count against your per-second call quota, but they're capped at 10 calls per minute per key. Cache the response client-side if you're polling.

Response

{
    "userid": "90834083",
    "plan": "MEDIUM",
    "quota": 1000000,
    "used": 70,
    "used_percent": 0.01,
    "total_requests": 7,
    "balance": 0,
    "concurrent_requests": 50,
    "next_billing_date": "2024-11-01 18:38:00",
    "days_till_next_billing": 10
}

Field Reference

Code Examples

cURL

curl -X GET 'https://api.ujeebu.com/account' \
  -H "ApiKey: YOUR_API_KEY"

Node.js

const res = await fetch('https://api.ujeebu.com/account', {
  headers: { 'ApiKey': 'YOUR_API_KEY' }
});
const account = await res.json();
console.log(`${account.used} / ${account.quota} credits used (${account.used_percent}%)`);

Python

import requests

res = requests.get(
    'https://api.ujeebu.com/account',
    headers={'ApiKey': 'YOUR_API_KEY'},
)
account = res.json()
print(f"{account['used']} / {account['quota']} credits used ({account['used_percent']}%)")

When to use it

• Budget-aware agents. Check used_percent before kicking off a large batch; pause or alert when it crosses a threshold.
• Dashboards. Render real-time usage without scraping the Ujeebu dashboard.
• Scheduled jobs. Confirm days_till_next_billing before running a billing-period-bound report.
• MCP / agent integrations. This endpoint is also exposed as the account tool by the Ujeebu MCP server.

Errors