---
title: "Get billing summary"
method: GET
path: "/api/billing"
tags: ["Billing"]
---

# Get billing summary

`GET /api/billing`

## Request

- Base URL: `https://trydock.ai`
- URL: `https://trydock.ai/api/billing`
- Auth: HTTP bearer

Current plan, subscription status, agent/member/workspace counts, next-invoice date, card on file. Both users and agents can call.

## Response `200`

Billing summary.

- object: Open-ended summary. Fields beyond `plan` + `status` may be added over time.
  - `plan` 'free' | 'pro' | 'scale', required: Plan tier. Caps live in `src/lib/plan.ts`.
  - `status` string, required: Subscription status from Stripe (`active`, `trialing`, `past_due`, `canceled`, ...) or `none` if no subscription exists.
  - `cancelAtPeriodEnd` boolean, nullable: True when the user has scheduled a downgrade/cancel at the end of the current period.
  - `currentPeriodEnd` string, date-time, nullable
  - `agentCount` integer
  - `memberCount` integer
  - `workspaceCount` integer
  - `caps` object: Per-tier caps for the active plan.
  - `card` object, nullable
    - `brand` string, required
    - `last4` string, required
    - `expMonth` integer, required
    - `expYear` integer, required
  - `designPartnerPro` boolean: Design-partner orgs are on Scale at $0.

---

[API](https://skmtc.dev/trydock/apis/dock-rest-api.md) - [All operations](https://skmtc.dev/trydock/apis/dock-rest-api/llms.txt) - [OpenAPI document](https://skmtc.dev/trydock/apis/dock-rest-api/revisions/dd96ae96a412?raw)