---
title: "Billing status for the active workspace"
method: GET
path: "/api/v1/billing/status"
tags: ["billing"]
---

# Billing status for the active workspace

`GET /api/v1/billing/status`

## Request

- Base URL: `https://slatehut.com`
- URL: `https://slatehut.com/api/v1/billing/status`
- Auth: HTTP bearer

## Response `200`

Effective plan and Stripe subscription fields

- BillingStatusResponse
  - `workspaceId` string, required
  - `billingPlan` 'free' | 'launch' | 'pro' | 'agency', required
  - `stripeSubscriptionStatus` string, nullable, required
  - `stripeBillingCycle` string, nullable, required: `monthly`, `yearly`, or null when not on a paid cycle
  - `stripeCurrentPeriodEnd` integer, nullable, required
  - `canSubscribeViaCheckout` boolean, required
  - `canOpenBillingPortal` boolean, required
  - `stripePublishableKey` string, nullable, required

## Other responses

- `401`: Missing or invalid credentials
- `403`: Not allowed for this resource
- `500`: Validation or conflict error

---

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