---
title: "The team's plan, subscription and payment options"
method: GET
path: "/v1/billing"
tags: ["billing"]
---

# The team's plan, subscription and payment options

`GET /v1/billing`

## Request

- Base URL: `https://api.briq.cloud`
- URL: `https://api.briq.cloud/v1/billing`
- Auth: none declared

## Response `200`

ok

- object
  - `enabled` boolean, required
  - `plan` 'hobby' | 'pro' | 'team', required
  - `status` string, nullable, required
  - `renewsAt` string, date-time, nullable, required
  - `change` object, nullable, required
    - `plan` 'hobby' | 'pro' | 'team', required
    - `at` string, date-time, required
  - `customer` boolean, required
  - `canManage` boolean, required
  - `payg` object, nullable, required
    - `card` string, required
    - `owedCents` number, required
    - `pendingCents` number, required
    - `suspended` boolean, required
  - `included` object, nullable, required
    - `cents` number, required
    - `usedCents` number, required
    - `spentCents` number, required
    - `periodEnd` string, date-time, required

## Other responses

- `400`: validation
- `401`: unauthorized
- `403`: forbidden
- `404`: not found
- `409`: invalid state
- `502`: payment provider error

---

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