---
title: "Billing status"
method: GET
path: "/billing/status"
tags: ["billing"]
---

# Billing status

`GET /billing/status`

## Request

- Base URL: `https://www.dench.com/api/v1`
- URL: `https://www.dench.com/api/v1/billing/status`
- Auth: one of:
  - HTTP bearer
  - HTTP bearer

Get billing and AI credit status.

## Response `200`

Successful response

- object
  - `workspace` object, required
    - `id` string, required
    - `name` string, required
    - `slug` string, required
  - `availableCreditsCents` number, required
  - `creditConsumedCents` number, required
  - `billedCents` number, required
  - `onDemandSpendCents` number, required
  - `monthlySpendLimitCents` number, required
  - `spendLimitRemainingCents` number, required
  - `subscriptionStatus` string, nullable, required
  - `stripeCustomerId` string, nullable, required
  - `grants` object[], required
    - `id` string, required
    - `source` 'starter' | 'trial' | 'monthly' | 'topup' | 'manual' | 'referral', required
    - `category` 'promotional' | 'paid', required
    - `status` 'pending' | 'granted' | 'depleted' | 'expired' | 'voided', required
    - `amountCents` number, required
    - `usedCents` number, required
    - `remainingCents` number, required
    - `effectiveAt` number, required
    - `expiresAt` number, nullable, required
  - `nextCommands` string[], required

## Other responses

- `400`: Invalid request
- `401`: Missing or invalid authentication
- `404`: Operation or resource not found
- `500`: Server error

---

[API](https://skmtc.dev/dench/apis/dench-api.md) - [All operations](https://skmtc.dev/dench/apis/dench-api/llms.txt) - [OpenAPI document](https://skmtc.dev/dench/apis/dench-api/revisions/4a145b38f19c?raw)