---
title: "Get simulator daily usage and quota"
method: GET
path: "/usage/simulator"
tags: ["Account"]
---

# Get simulator daily usage and quota

`GET /usage/simulator`

## Request

- Base URL: `https://api-v2.qbraid.com/api/v1`
- URL: `https://api-v2.qbraid.com/api/v1/usage/simulator`
- Auth: API key in header `X-API-KEY`

Return the daily per-simulator job quota and current usage for the tier of the caller. Usage resets at 00:00 UTC. The organization is taken from the API key, which is bound to a single organization.

## Response `200`

Success.

- SimulatorUsageResponse
  - `success` boolean, required
  - `data` SimulatorUsageItem[], required
    - `deviceQrn` string, required
    - `deviceName` string, required
    - `usage` integer, required
    - `quota` integer, nullable, required: Daily cap; null = unlimited.
    - `remaining` integer, nullable, required
    - `unlimited` boolean, required
    - `percentageUsed` integer, required: 0-100; 0 when unlimited.
    - `resetsAt` string, date-time, required: Next 00:00 UTC reset.
    - `creditFallover` boolean, required: True for a simulator whose daily quota is a free allowance that can fall over to credits (the GPU simulators). Once the allowance is used, further jobs run charged from credits at the device's per-minute price when `autoSwitchToCredits` is true, and are refused when it is false.
    - `autoSwitchToCredits` boolean, required: The caller's usage-based billing setting for simulators; the same on every entry. Only affects entries with `creditFallover`.

## Other responses

- `401`: Authentication / org context required.
- `404`: Organization user not found.

## Changes

- **2026-11-03** `20848d926124`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/qbraid/apis/qbraid-runtime-api/changes/usage/simulator/get.md)

---

[API](https://skmtc.dev/qbraid/apis/qbraid-runtime-api.md) - [All operations](https://skmtc.dev/qbraid/apis/qbraid-runtime-api/llms.txt) - [OpenAPI document](https://skmtc.dev/qbraid/apis/qbraid-runtime-api/revisions/20848d926124?raw)