---
title: "Open the billing portal"
method: POST
path: "/v1/billing/portal"
tags: ["billing"]
---

# Open the billing portal

`POST /v1/billing/portal`

## Request

- Base URL: `https://api.pomerado.ai`
- URL: `https://api.pomerado.ai/v1/billing/portal`
- Auth: HTTP bearer

Returns a Stripe billing portal link where the person manages their Premium subscription, payment method and invoices. An account that never started a checkout has no portal and gets not_found.

## Response `200`

The page to open

- BillingLink
  - `url` string, required: The page to open in a browser

## Other responses

- `400`: invalid_request
- `401`: unauthorized, reauthentication_required
- `403`: billing_unavailable, forbidden
- `404`: not_found
- `500`: internal_error
- `501`: not_configured
- `503`: temporarily_unavailable

---

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