---
title: "Update Subscription Status"
method: POST
path: "/api/v1/super-admin/subscriptions/{bank_id}/status"
tags: ["Super Admin"]
---

# Update Subscription Status

`POST /api/v1/super-admin/subscriptions/{bank_id}/status`

## Request

- Base URL: `https://app.perlucem.ai` (the document declares no server; this is the origin it was published from)
- URL: `https://app.perlucem.ai/api/v1/super-admin/subscriptions/{bank_id}/status`
- Auth: HTTP bearer

US-005-03 & US-005-06: Update Subscription Status
Update subscription status (e.g., for payment failures).

## Path parameters

- `bank_id` string, required

## Query parameters

- `new_status` string, required: New status: active, past_due, suspended, canceled
- `reason` string, nullable

## Response `200`

Successful Response

- unknown

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/perlucem/apis/perlucem-ai-backend.md) · [All operations](https://skmtc.dev/perlucem/apis/perlucem-ai-backend/llms.txt) · [OpenAPI document](https://skmtc.dev/perlucem/apis/perlucem-ai-backend/revisions/96c4a286c624?raw)