---
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 — An enumeration.
  - `monthly_usage_minutes` integer, required
  - `monthly_usage_limit_minutes` integer

## Changes

- **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/97850bfccb2c/schema)