---
title: "Get subscription, usage, and credit summary"
method: GET
path: "/v1/billing/subscription"
tags: ["Billing"]
---

# Get subscription, usage, and credit summary

`GET /v1/billing/subscription`

## Request

- Base URL: `https://api.1claw.co`
- URL: `https://api.1claw.co/v1/billing/subscription`
- Auth: HTTP bearer

## Response `200`

Full billing summary

- SubscriptionResponse
  - `tier` string
  - `interval` string
  - `period_end` string, date-time
  - `status` string
  - `credit_balance_cents` integer: Derived (rounded down); the ledger unit is micro-USD
  - `credit_balance_micro_usd` integer: The ledger value. One inspected Shroud request costs 5,000 micro-USD ($0.005).
  - `credit_balance_usd` string
  - `overage_method` string
  - `usage` object
    - `requests` UsageMeter
      - `used` integer
      - `limit` integer
    - `secrets` UsageMeter
      - `used` integer
      - `limit` integer
    - `agents` UsageMeter
      - `used` integer
      - `limit` integer
    - `vaults` UsageMeter
      - `used` integer
      - `limit` integer
    - `team_members` UsageMeter
      - `used` integer
      - `limit` integer
    - `intent_transactions` UsageMeter
      - `used` integer
      - `limit` integer
    - `wallets` UsageMeter
      - `used` integer
      - `limit` integer
    - `shares` UsageMeter
      - `used` integer
      - `limit` integer

---

[API](https://skmtc.dev/1claw/apis/1claw-api.md) · [All operations](https://skmtc.dev/1claw/apis/1claw-api/llms.txt) · [OpenAPI document](https://skmtc.dev/1claw/apis/1claw-api/revisions/ae109b496830?raw)