---
title: "Current usage and limits"
method: GET
path: "/v1/usage"
tags: ["Account"]
---

# Current usage and limits

`GET /v1/usage`

## Request

- Base URL: `https://api.stackdata.io`
- URL: `https://api.stackdata.io/v1/usage`
- Auth: one of:
  - none
  - API key in header `X-API-Key`

Usage counts and remaining allowance for the caller (by key, or by IP on the free tier). Not metered. Takes no query parameters.

## Response `200`

Usage status.

- object
  - `usage` object: Tier, counts used, and remaining allowance.
  - `meta` Meta: Attached to every JSON response. `harvest` maps each source id to its last successful harvest timestamp.
    - `harvest` object
    - `api_version` string

## Other responses

- `400`: An unknown query parameter was supplied. Unknown parameters are **rejected, never silently ignored** — the error names the offenders and lists what is allowed.

---

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