Usage
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.