---
title: "Get detailed usage statistics"
method: GET
path: "/v1/me/usage"
tags: ["Account"]
---

# Get detailed usage statistics

`GET /v1/me/usage`

## Request

- Base URL: `https://api.vatnode.dev`
- URL: `https://api.vatnode.dev/v1/me/usage`
- Auth: API key in cookie `better-auth.session_token`

Current billing-period request usage (included + overage), lifetime
request total and monitoring-subscription usage against plan limits.

## Response `200`

Usage statistics for the current billing period.

- MeUsage
  - `periodStart` string, date-time, nullable, required
  - `periodEnd` string, date-time, nullable, required
  - `requests` object, required
    - `used` integer, required: Requests used in the current billing period.
    - `total` integer, required: Lifetime request total across all of the account’s keys.
    - `limit` integer, required: Included monthly quota. `-1` means unlimited.
    - `remaining` integer, required: Remaining inside the included quota (clamped at 0). `-1` when unlimited.
    - `overage` integer, required
    - `overageEnabled` boolean, required
    - `overagePricePerRequest` number, nullable, required
  - `subscriptions` object, required
    - `used` integer, required
    - `limit` integer, required: Plan subscription limit. `-1` means unlimited, `0` means unavailable.

## Other responses

- `401`: No valid session (`UNAUTHORIZED`), or the account has been deleted (`ACCOUNT_DELETED`).

---

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