---
title: "The authed tenant's current plan, usage, and entitlements"
method: GET
path: "/api/billing/subscription"
tags: ["Billing"]
---

# The authed tenant's current plan, usage, and entitlements

`GET /api/billing/subscription`

## Request

- Base URL: `https://api.wordis-bond.com`
- URL: `https://api.wordis-bond.com/api/billing/subscription`
- Auth: HTTP bearer

## Response `200`

Subscription snapshot

- object
  - `data` object, required
    - `plan` 'starter' | 'pro' | 'enterprise'
    - `hasBillingAccount` boolean
    - `usage` object
      - `callMinutes` number
      - `ttsChars` number
    - `entitlements` PlanView: One plan row from the entitlements source of truth. Prices are always read from here.
      - `plan` 'starter' | 'pro' | 'enterprise', required
      - `priceUsdPerMonth` number, required
      - `purchasable` boolean
      - `lookupKey` string, nullable
      - `callMinutesPerMonth` integer, required
      - `allowedTransports` string[], required
      - `overageUsdPerMinute` object
        - `pstn` number, nullable
        - `direct` number, nullable
      - `ttsCharsPerMonth` integer
      - `concurrentCalls` integer
      - `scheduledRuns` object
        - `cadence` 'weekly' | 'daily' | 'hourly'
        - `maxSuites` integer, nullable
      - `apiKeys` integer, nullable
      - `requiresCard` boolean
  - `error` union, required
    - object
    - string

## Other responses

- `401`: Missing, invalid, or revoked credentials.

---

[API](https://skmtc.dev/wordis-bond/apis/word-is-bond-voice-agent-testing-api.md) · [All operations](https://skmtc.dev/wordis-bond/apis/word-is-bond-voice-agent-testing-api/llms.txt) · [OpenAPI document](https://skmtc.dev/wordis-bond/apis/word-is-bond-voice-agent-testing-api/revisions/66c2d5480d84?raw)