---
title: "Get Usage"
method: GET
path: "/v1/usage"
tags: ["usage"]
---

# Get Usage

`GET /v1/usage`

## Request

- Base URL: `https://leads.compuute.se` (the document declares no server; this is the origin it was published from)
- URL: `https://leads.compuute.se/v1/usage`
- Auth: none declared

Return current quota status and recent usage log for this API key.

Agents use this to track spend, verify charges, and decide whether
to make more requests before their monthly quota resets.

## Query parameters

- `limit` integer

## Headers

- `X-API-Key` string, nullable

## Response `200`

Successful Response

- UsageSummary
  - `tier` string, required
  - `monthly_limit` integer, required
  - `used_this_month` integer, required
  - `remaining` integer, required
  - `reset_at` string, required
  - `entries` UsageEntry[], required
    - `id` string, uuid, required
    - `endpoint` string, required
    - `leads_returned` integer, required
    - `cost_usd` number, required
    - `request_at` string, date-time, required
  - `total_entries` integer, required

## Other responses

- `422`: Validation Error

---

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