---
title: "Get Usage"
method: GET
path: "/v1/usage"
tags: ["usage"]
---

# Get Usage

`GET /v1/usage`

## Response `200`

Successful Response

- Usage
  - `user_id` string, required
  - `plan_type` 'plan_free' | 'plan_developer' | 'plan_enterprise' | 'plan_unlimited', required
  - `monthly_usage_minutes` integer, required
  - `monthly_usage_limit_minutes` integer, nullable

## Changes

- **2024-08-14** `63991d99e2e1` — 1 breaking
  - response property `monthly_usage_limit_minutes` list-of-types was widened by adding types `null` to media type `application/json` of response `200`
- **2023-09-26** `eb14a21c478e` — 1 breaking, 1 warning
  - the response property `monthly_usage_limit_minutes` became optional for the status `200`
  - added the new `plan_unlimited` enum value to the `plan_type` response property for the response status `200`

[Change history](https://skmtc.dev/vocodedev/apis/vocode-hosted-api/changes/v1/usage/get.md)

---

[API](https://skmtc.dev/vocodedev/apis/vocode-hosted-api.md) · [All operations](https://skmtc.dev/vocodedev/apis/vocode-hosted-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/vocodedev/vocode-hosted-api/revisions/ffca17c004e2/schema)