---
title: "Retrieves the current subscription usage for the logged-in user."
method: GET
path: "/v1/Subscription/usage"
tags: ["Subscription"]
---

# Retrieves the current subscription usage for the logged-in user.

`GET /v1/Subscription/usage`

This endpoint returns how many subscription resources have been consumed within the user's plan.

Usage is reported for items such as Queries, Models, Keywords, and Links.  

The `date` parameter is optional.
If `null`, defaults to the current UTC time and shows usage for the active subscription period.
If provided, allows fetching usage information for previous subscription periods.

## Query parameters

- `date` string, date-time

## Response `200`

Successful operation. Returns subscription usage data for the specified period.

## Other responses

- `500` — An unexpected error occurred while retrieving usage data.

---

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