---
title: "Subscribe to a plan (a Checkout), or change or cancel the subscription (the portal)"
method: POST
path: "/v1/billing/checkout"
tags: ["billing"]
---

# Subscribe to a plan (a Checkout), or change or cancel the subscription (the portal)

`POST /v1/billing/checkout`

## Request

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

## Request body

- object
  - `plan` 'hobby' | 'pro' | 'team', required

## Response `200`

ok

- union
  - object
    - `sessionId` string, required
  - object
    - `url` string, uri, 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)