---
title: "Get Brand Plans"
method: GET
path: "/api/billing/brand-plans"
tags: ["Billing"]
---

# Get Brand Plans

`GET /api/billing/brand-plans`

## Request

- Base URL: `https://api.soeru.biz` (the document declares no server; this is the origin it was published from)
- URL: `https://api.soeru.biz/api/billing/brand-plans`
- Auth: none declared. Required headers: `authorization`

Return per-brand plan summaries for sidebar / header badge display.

Phase NOTIF-4 (2026-05-11, sho UX 提案): multi-brand owner が
どの brand が何プランか一目で分かるようにするため. UI コンポーネント
PlanBadge から呼ばれる軽量エンドポイント.

Returns: {brand_id: {plan, status, cancel_at_period_end}}
    - brand_id: subscription の brand_id (None の場合は除外)
    - plan: 'free' | 'standard' | 'dev'
    - cancel_at_period_end: 解約予約中なら true

## Headers

- `authorization` string, required: Bearer <token>

## Response `200`

Successful Response

- unknown

## Other responses

- `422`: Validation Error

---

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