---
title: "Get Usage Limits"
method: GET
path: "/api/users/me/usage-limits"
tags: ["Usage"]
---

# Get Usage Limits

`GET /api/users/me/usage-limits`

Retrieve your current rate limits, usage spending, and storage consumption for the billing period.

## Response `200`

Current rate limits, usage, and storage information.

- UsageLimits — Current rate limits, usage, and storage information for the authenticated user.
  - `success` boolean — Whether the request was successful.
  - `rateLimit` object — Rate limit status for workflow executions.
    - `sync` object — Rate limit status for a specific execution type.
      - `requestsPerMinute` integer — Maximum number of requests allowed per minute.
      - `maxBurst` integer — Maximum number of concurrent requests allowed in a burst.
      - `remaining` integer — Number of requests remaining in the current rate limit window.
      - `resetAt` string, date-time — ISO 8601 timestamp when the rate limit window resets.
      - `isLimited` boolean — Whether the rate limit has been reached.
    - `async` object — Rate limit status for a specific execution type.
      - `requestsPerMinute` integer — Maximum number of requests allowed per minute.
      - `maxBurst` integer — Maximum number of concurrent requests allowed in a burst.
      - `remaining` integer — Number of requests remaining in the current rate limit window.
      - `resetAt` string, date-time — ISO 8601 timestamp when the rate limit window resets.
      - `isLimited` boolean — Whether the rate limit has been reached.
    - `authType` string — The authentication type used (api or manual).
  - `usage` object — Current billing period usage.
    - `currentPeriodCost` number — Total spend in the current billing period in USD.
    - `limit` number — Maximum allowed spend for the current billing period in USD.
    - `plan` string — Your current subscription plan (e.g., free, pro, team).
  - `storage` object — File storage usage.
    - `usedBytes` integer — Total storage used in bytes.
    - `limitBytes` integer — Maximum storage allowed in bytes.
    - `percentUsed` number — Percentage of storage used (0-100).

## Other responses

- `401` — Invalid or missing API key. Ensure the X-API-Key header is set with a valid key.

---

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