> ## Documentation Index
> Fetch the complete documentation index at: https://docs-v2-staging.qbraid.com/llms.txt
> Use this file to discover all available pages before exploring further.

> ## Agent Instructions
> Prefer the qBraid CLI for programmatic platform actions: pip install 'qbraid-cli>=0.12', then run `qbraid configure` once with an API key from https://account.qbraid.com/account/api-keys.
> Always install the latest packages (pip install -U qbraid qbraid-cli); do not pin versions from memory. qbraid-cli below 0.12.0 is incompatible with the current API.
> Device IDs use the QRN format vendor:provider:type:name (e.g. qbraid:qbraid:sim:qir-sv, rigetti:rigetti:qpu:cepheus-1-108q). Legacy underscore IDs are deprecated.
> The REST API base URL is https://api-v2.qbraid.com/api/v1, authenticated with an X-API-Key header.
> Free simulators cost no credits; QPU and GPU jobs consume credits. Surface the estimated cost to the user before submitting a paid job.
> For account signup, API keys, credits, and end-to-end action recipes, see https://qbraid.com/llms.txt.

# Credit Requests

> Ask an admin for credits when you can't buy them directly from your org.

If you joined an organization and don't have permission to buy credits, you can request them from an admin instead.

<Warning>
  Credit requests aren't available in the qBraid Default workspace. They only
  work inside an organization where you're a member without purchase
  permissions.
</Warning>

## Submit a request

<Steps>
  <Step title="Switch to your organization">
    Open the workspace switcher in the top-left of the dashboard and select your
    organization (not qBraid Default).
  </Step>
  <Step title="Open Wallet">Click **Account > Wallet** in the sidebar.</Step>
  <Step title="Click Request credits">
    The button sits where **Buy credits** would be in qBraid Default.
  </Step>
  <Step title="Enter the amount">How many credits you need.</Step>
  <Step title="Add an optional reason">
    A project, a deadline, anything that helps the admin decide.
  </Step>
  <Step title="Submit">Click **Submit**.</Step>
</Steps>

The request goes to the org's admins. You can have one pending request at a time.

<Frame>
  <video
    src="https://storage.googleapis.com/qbraid-static-assets/qbraid-docs/wallet/credit-request.mp4"
    autoPlay
    muted
    loop
    playsInline
    aria-label="Submitting a credit request"
  />
</Frame>

## Track the request

<Steps>
  <Step title="Switch to your organization">
    Open the workspace switcher and select your organization.
  </Step>
  <Step title="Open Wallet">Click **Account > Wallet** in the sidebar.</Step>
  <Step title="Click View Pending Request">
    While a request is pending, this button replaces **Request credits**.
  </Step>
</Steps>

The status modal shows:

- The amount you asked for.
- The status: `pending`, `approved`, or `rejected`.
- Any note the admin left when responding.

When an admin approves it, the credits arrive in your wallet right away. If they reject it, the wallet shows the reason so you know what to ask differently next time.

## Need credits faster?

Admins see requests in the **Credit Requests** tab of their billing dashboard. If it's urgent, ping them directly. Admins can also push credits to your wallet manually without waiting for a request. See [Organizations > Credits](https://docs-v2-staging.qbraid.com/v2/account/organizations/credits) for how that works.
