---
title: "Your quota position"
method: GET
path: "/v1/me/usage"
tags: ["account"]
---

# Your quota position

`GET /v1/me/usage`

## Request

- Base URL: `https://api.tapetide.com`
- URL: `https://api.tapetide.com/v1/me/usage`
- Auth: HTTP bearer

The caller's plan and current day/month usage against the counters every request is metered on. Free: this route never charges.

## Response `200`

OK

- object
  - `data` object
    - `plan` string
    - `day` QuotaWindow
      - `period` string: IST day (YYYY-MM-DD) or month (YYYY-MM).
      - `used` integer
      - `limit` integer, nullable: null means unlimited.
      - `remaining` integer, nullable
      - `resets_at` string, date-time
    - `month` QuotaWindow
      - `period` string: IST day (YYYY-MM-DD) or month (YYYY-MM).
      - `used` integer
      - `limit` integer, nullable: null means unlimited.
      - `remaining` integer, nullable
      - `resets_at` string, date-time
    - `note` string
  - `meta` object

## Other responses

- `401`: Missing or invalid bearer token.
- `503`: Authentication or quota service temporarily unavailable (`service_unavailable`). Not charged; retry after `Retry-After` seconds.

---

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