---
title: "Account API — 1 Endpoint | Homesage.ai"
description: "Monitor Homesage.ai API usage and spend. 1 free endpoint returning your credit balance, credits consumed this cycle, and credits remaining in the period."
---

# 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](https://app.homesage.ai/docs/account/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.