# Get usage for the calling key (/docs/api-reference/api/v1/usage/get)

`GET https://mmb-blurware-alpha.vercel.app/api/v1/usage`

Get usage for the calling key

Operation ID: `getUsage`

OpenAPI document: https://mmb-blurware-alpha.vercel.app/openapi.json

## Authentication

Required bearer token: `Authorization: Bearer $MMB_API_KEY`.

## Request

This operation has no request parameters or body.

## Responses

### `200` — Usage summary for the key's tenant.

**application/json**

```json
{
  "type": "object",
  "properties": {
    "tenantId": {
      "type": "string"
    },
    "status": {
      "type": "string",
      "enum": [
        "anonymous",
        "claimed",
        "upgraded"
      ]
    },
    "keyPrefix": {
      "type": "string",
      "description": "First characters of the API key, for display."
    },
    "requestsUsed": {
      "type": "number"
    },
    "requestLimit": {
      "type": "number",
      "description": "Lifetime request cap for anonymous keys; tier cap otherwise."
    },
    "dailyRequestsUsed": {
      "type": "number"
    },
    "dailyRequestLimit": {
      "type": "number"
    },
    "expiresAt": {
      "type": "number",
      "description": "Anonymous key expiry, Unix epoch milliseconds."
    },
    "email": {
      "type": "string",
      "description": "Present once the key is claimed."
    }
  },
  "required": [
    "tenantId",
    "status",
    "keyPrefix",
    "requestsUsed",
    "requestLimit",
    "dailyRequestsUsed"
  ]
}
```

### `401` — Missing bearer header or unknown key.

**application/json**

```json
{
  "anyOf": [
    {
      "type": "object",
      "properties": {
        "error": {
          "type": "string",
          "enum": [
            "unauthorized"
          ],
          "description": "Stable machine-readable error code."
        },
        "message": {
          "type": "string",
          "description": "Human-readable summary."
        },
        "hint": {
          "type": "string",
          "description": "Endpoint path that resolves this error, when one exists."
        }
      },
      "required": [
        "error",
        "message"
      ]
    },
    {
      "type": "object",
      "properties": {
        "error": {
          "type": "string",
          "enum": [
            "invalid_api_key"
          ],
          "description": "Stable machine-readable error code."
        },
        "message": {
          "type": "string",
          "description": "Human-readable summary."
        },
        "hint": {
          "type": "string",
          "description": "Endpoint path that resolves this error, when one exists."
        }
      },
      "required": [
        "error",
        "message"
      ]
    }
  ]
}
```

### `403` — The anonymous key expired or exhausted its quota.

**application/json**

```json
{
  "anyOf": [
    {
      "type": "object",
      "properties": {
        "error": {
          "type": "string",
          "enum": [
            "key_expired"
          ],
          "description": "Stable machine-readable error code."
        },
        "message": {
          "type": "string",
          "description": "Human-readable summary."
        },
        "hint": {
          "type": "string",
          "description": "Endpoint path that resolves this error, when one exists."
        }
      },
      "required": [
        "error",
        "message"
      ]
    },
    {
      "type": "object",
      "properties": {
        "error": {
          "type": "string",
          "enum": [
            "quota_exhausted"
          ],
          "description": "Stable machine-readable error code."
        },
        "message": {
          "type": "string",
          "description": "Human-readable summary."
        },
        "hint": {
          "type": "string",
          "description": "Endpoint path that resolves this error, when one exists."
        }
      },
      "required": [
        "error",
        "message"
      ]
    }
  ]
}
```

### `429` — Too many requests. Mirrors the Retry-After header.

**application/json**

```json
{
  "type": "object",
  "properties": {
    "error": {
      "type": "string",
      "enum": [
        "rate_limited"
      ],
      "description": "Stable machine-readable error code."
    },
    "message": {
      "type": "string",
      "description": "Human-readable summary."
    },
    "hint": {
      "type": "string",
      "description": "Endpoint path that resolves this error, when one exists."
    }
  },
  "required": [
    "error",
    "message"
  ]
}
```

### `503` — The gateway is unreachable.

**application/json**

```json
{
  "type": "object",
  "properties": {
    "error": {
      "type": "string",
      "enum": [
        "service_unavailable"
      ],
      "description": "Stable machine-readable error code."
    },
    "message": {
      "type": "string",
      "description": "Human-readable summary."
    },
    "hint": {
      "type": "string",
      "description": "Endpoint path that resolves this error, when one exists."
    }
  },
  "required": [
    "error",
    "message"
  ]
}
```