---
title: "Your quota position"
description: "Your quota position. The caller's plan and current day/month usage against the counters every request is metered on. Free: this route never charges."
canonical: "https://developers.tapetide.com/api/operations/getmyusage/"
---

# Your quota position

GET

/v1/me/usage

```js
const url = 'https://api.tapetide.com/v1/me/usage';
const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

try {
  const response = await fetch(url, options);
  const data = await response.json();
  console.log(data);
} catch (error) {
  console.error(error);
}
```

```sh
curl --request GET \
  --url https://api.tapetide.com/v1/me/usage \
  --header 'Authorization: Bearer <token>'
```

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

## Authorizations

-   **[bearer](/api/#bearer)**

## Responses

### 200

OK

Media typeapplication/json

object

**data**

object

**plan**

string

**day**

object

**period**

IST day (YYYY-MM-DD) or month (YYYY-MM).

string

**used**

integer

**limit**

Null means unlimited.

integer | null

**remaining**

integer | null

**resets\_at**

string format: date-time

**month**

object

**period**

IST day (YYYY-MM-DD) or month (YYYY-MM).

string

**used**

integer

**limit**

Null means unlimited.

integer | null

**remaining**

integer | null

**resets\_at**

string format: date-time

**note**

string

**meta**

object

#### Example generated

```json
{
  "data": {
    "plan": "example",
    "day": {
      "period": "example",
      "used": 1,
      "limit": 1,
      "remaining": 1,
      "resets_at": "2026-04-15T12:00:00Z"
    },
    "month": {
      "period": "example",
      "used": 1,
      "limit": 1,
      "remaining": 1,
      "resets_at": "2026-04-15T12:00:00Z"
    },
    "note": "example"
  },
  "meta": {}
}
```

### 401

Missing or invalid bearer token.

Media typeapplication/json

object

**error**

required

object

**code**

required

string

Allowed values: authentication\_required invalid\_token invalid\_request route\_not\_found not\_found method\_not\_allowed rate\_limited quota\_exhausted upstream\_unavailable service\_unavailable tool\_error internal\_error

**message**

required

string

**details**

object

**_key_**

additional properties

any

#### Example

```json
{
  "error": {
    "code": "authentication_required"
  }
}
```