Monitor Your Usage
Your Pro plan comes with a monthly pool of tokens, and these endpoints let you keep an eye on it. See how much you’ve used this period, what’s left, and exactly which actions are spending the most.
By default your account never bills overage — access pauses once your included tokens are spent. See How overage works for the details and how to change it. These endpoints stay free and available even while access is paused.
Two endpoints report your token usage, and both are free (0 tokens):
| Endpoint | Returns |
|---|---|
get_usage | Current-period totals. |
get_usage_breakdown | The same period, broken down by day, endpoint, and mode. |
Current-period totals
Section titled “Current-period totals”GET /usage/ returns a compact,
fixed-size summary for the current billing period: tokens used, tokens included
with your tier, any overage and its dollar cost, and the period start and end.
curl "https://app-api.landinsights.co/api/public/v1/usage/" \ -H "Authorization: Bearer lipk_your_key_here"Per-request cost
Section titled “Per-request cost”Every billable response also reports its own cost in the
X-Tokens-Used header, so you can
attribute spend at the call site without a separate lookup.
Breakdown dimensions
Section titled “Breakdown dimensions”GET /usage/breakdown/ returns
one record per (day, endpoint, mode) bucket for the current period, sorted by
date, then endpoint, then mode:
- day — the calendar day the usage occurred.
- endpoint — which endpoint the tokens went to.
- mode — how the call arrived: direct REST API vs. the MCP server.
This is the endpoint to reach for when you want to attribute usage — to see which endpoints or which access mode account for a period’s tokens.