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

# Get usage and quota information

`GET /v1/usage`

## Request

- Base URL: `https://api.terranode.co`
- URL: `https://api.terranode.co/v1/usage`
- Auth: API key in header `x-api-key`

Returns current usage counters, tier limits, rate limits, and dataset slot usage for the authenticated user.

## Response `200`

Usage information.

- UsageResponse
  - `tier` 'free' | 'paid' | 'scale', required
  - `requests` object, required
    - `used` integer, required: Requests consumed this billing period.
    - `limit` integer, required: Monthly request quota for this tier.
    - `resets_at` string, date-time, required: When the usage counter resets (first of next month, midnight UTC).
  - `rate_limit` object, required
    - `per_second` integer, required: Sustained requests per second for this tier.
  - `datasets` object, required
    - `used` integer, required: Custom datasets currently in use.
    - `limit` integer, required: Maximum dataset slots for this tier.
    - `max_features` integer, required: Maximum features per dataset for this tier.

## Other responses

- `401`: Missing or invalid API key.
- `500`: Internal server error.

---

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