# Get plan, limits, and usage — Shorty API

> Returns the authenticated account’s plan (Free / Premium / Pro), tier limits (upload sizes, real-time minutes, conversion caps), and current cloud-conversion usage against the daily quota.

```http
GET /v1/usage
```

Returns the authenticated account’s plan (Free / Premium / Pro), tier limits (upload sizes, real-time minutes, conversion caps), and current cloud-conversion usage against the daily quota.

## Authentication

Requires a Bearer credential — a `shk_live_` API key or an OAuth 2.1 access token with the scope for this resource. See [Authentication](/docs/api).

## Example request

curl:

```bash
curl -X GET https://aishorty.com/v1/usage \
  -H "Authorization: Bearer shk_live_your_key"
```

TypeScript (@aishorty/sdk):

```typescript
import { Shorty } from '@aishorty/sdk'

const shorty = new Shorty({ apiKey: process.env.SHORTY_API_KEY })

const usage = await shorty.usage.get()
console.log(usage.plan, usage.limits)
```

## Response · 200

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `plan` | `UsagePlan` | Yes | — |
| `subscription` | `UsageSubscription` | Yes | — |
| `limits` | `UsageLimits` | Yes | — |
| `usage` | `UsageCounters` | Yes | — |

## Errors

On failure this endpoint returns an RFC 9457 problem body. Possible statuses:

- `401`
- `403`
- `429`
- `500`

Switch on the problem `code`, not the status. See the [error reference](/docs/api/errors) for every code and how to fix it.