---
title: "Per-key call counts"
method: GET
path: "/v1/me/usage"
tags: ["Dashboard"]
---

# Per-key call counts

`GET /v1/me/usage`

## Request

- Base URL: `https://api.farofinance.app`
- URL: `https://api.farofinance.app/v1/me/usage`
- Auth: none declared

Daily call counts (by artifact type) for the caller's key over a trailing window. Best-effort — derived from the lightweight usage log.

## Query parameters

- `days` integer

## Response `200`

Successful Response

- UsageOut: Per-key usage over a trailing window.
  - `key_prefix` string, required: The key these counts belong to.
  - `days` integer, required: Size of the trailing window, in days.
  - `total` integer, required: Total calls in the window.
  - `daily` UsageDayOut[], required: Per-day, per-type counts (most recent first).
    - `day` string, date, required: UTC date of the bucket.
    - `artifact_type` string, nullable: `url`, `payee`, `message`, or null for non-verify calls.
    - `count` integer, required: Number of calls in this bucket.

## Other responses

- `401`: Missing or invalid API key.
- `403`: Admin or dev-mode credentials cannot use dashboard routes.
- `422`: Validation Error

---

[API](https://skmtc.dev/farofinance/apis/faro.md) · [All operations](https://skmtc.dev/farofinance/apis/faro/llms.txt) · [OpenAPI document](https://skmtc.dev/farofinance/apis/faro/revisions/205cdf54420b?raw)