---
title: "Account usage history"
method: GET
path: "/me/usage"
tags: ["Account"]
---

# Account usage history

`GET /me/usage`

## Request

- Base URL: `https://api.acuris-geo.com`
- URL: `https://api.acuris-geo.com/me/usage`
- Auth: one of:
  - API key in header `X-Acuris-Key`
  - HTTP bearer
  - API key in header `X-API-Key`
  - API key in query parameter `key`

Per-account usage for the console: the caller's most recent calls plus
7-day daily counts, for the caller's own API key. Summary fields only
(never the request payload). A fresh account returns empty arrays.

**Auth:** the account's own API key — send `X-Acuris-Key: <key>`
(primary). `Authorization: Bearer <key>`, `X-API-Key`, or the legacy
`?key=` query param is also accepted.

## Response `200`

Recent calls and 7-day daily usage counts for the caller's key.

- UsageHistory
  - `recent` object[], required: Up to 15 most recent calls (newest first), summary fields only.
    - `tool` string
    - `at` string: Call timestamp (UTC).
    - `country` string, nullable: Data country of the request, when known.
    - `status` string: Outcome — `ok` or `error`.
  - `days` object[], required: Daily call counts for the trailing 7 days (oldest first); missing days omitted.
    - `date` string
    - `count` integer
    - `ok` integer: Calls with an `ok` result on that day.
  - `calls_7d` integer, required: Total calls across the trailing 7-day window.

## Other responses

- `401`: API key required, or invalid/inactive key.

---

[API](https://skmtc.dev/acuris-geo/apis/acuris-geo-api.md) · [All operations](https://skmtc.dev/acuris-geo/apis/acuris-geo-api/llms.txt) · [OpenAPI document](https://skmtc.dev/acuris-geo/apis/acuris-geo-api/revisions/8547b31dd96a?raw)