---
title: "Get usage and entitlements"
method: GET
path: "/api/v1/usage"
---

# Get usage and entitlements

`GET /api/v1/usage`

## Request

- Base URL: `https://filetypeconverters.com`
- URL: `https://filetypeconverters.com/api/v1/usage`
- Auth: one of:
  - HTTP bearer
  - API key in header `X-API-Key`

## Response `200`

Usage and entitlement data

- Usage
  - `planId` string
  - `monthlyConversions` integer
  - `dailyConversions` integer, nullable
  - `maxFileMb` integer
  - `maxFileBytes` integer
  - `batchMax` integer: -1 means unlimited.
  - `apiAccess` boolean
  - `mcpAccess` boolean
  - `visionCreditsMonthly` integer
  - `remainingConversions` integer: -1 means unlimited.
  - `visionCreditBalance` integer
  - `entitlements` object
  - `month` object
    - `conversions` integer, required
    - `apiRequests` integer, required
    - `start` string, date-time, required

## Other responses

- `401`: Error response
- `403`: Error response
- `429`: Rate limited
- `500`: Error response

---

[API](https://skmtc.dev/filetypeconverters/apis/filetype-converters-api.md) · [All operations](https://skmtc.dev/filetypeconverters/apis/filetype-converters-api/llms.txt) · [OpenAPI document](https://skmtc.dev/filetypeconverters/apis/filetype-converters-api/revisions/b99ff5cdb9aa?raw)