Account
The Homesage.ai Account API reports your credit position, and it is free to call. Credit cost varies widely by endpoint, from 0 for autocomplete to 15 for a full report, and search endpoints bill per result, so check the balance before a large batch job. Failed calls (400, 401, 402, 404) never cost credits.
Get the account's current API credit balance
GET /api/usage/credits/
Your account's current API credit balance plus the plan and billing context that puts the number in context — credits_used, credits_remaining, total_credits, usage_percentage, current plan_name and subscription_status, and the renewal_date when the allowance resets.