---
title: "Get my plan and usage"
method: GET
path: "/account"
tags: ["Account"]
---

# Get my plan and usage

`GET /account`

## Request

- Base URL: `https://putit.online/api/v1`
- URL: `https://putit.online/api/v1/account`
- Auth: one of:
  - HTTP bearer
  - OAuth 2 (authorization code, authorization URL `https://putit.online/oauth/authorize`, token URL `https://putit.online/oauth/token`, scopes: `links:read`, `links:write`, `account:read`)

Plan, permanent slots used and limits for the connected account.

## Response `200`

OK

- object
  - `email` string, required
  - `plan` string, required
  - `plan_name` string, required
  - `subscribed` boolean, required
  - `permanent_links` object, required
    - `used` number, required
    - `limit` number, required
  - `total_links` number, required
  - `max_upload_bytes` number, required
  - `free_link_days` number, required
  - `features` object, required
    - `custom_slugs` boolean, required
    - `password_protection` boolean, required
    - `permanent_links` boolean, required
    - `view_counts` boolean, required
    - `replace_files` boolean, required
  - `upgrade_url` string, required
  - `dashboard_url` string, required

## Other responses

- `400`: Invalid request
- `401`: Authorization required or token invalid
- `402`: Subscription required (see upgrade_url)
- `403`: Blocked: VPN/proxy, banned uploader or missing scope
- `422`: Rejected by the safety check
- `429`: Rate limited (see Retry-After)

---

[API](https://skmtc.dev/putit/apis/put-it-online-api.md) · [All operations](https://skmtc.dev/putit/apis/put-it-online-api/llms.txt) · [OpenAPI document](https://skmtc.dev/putit/apis/put-it-online-api/revisions/a0c9fe8d4301?raw)