---
title: "Pause Subscription"
method: POST
path: "/admin/tenants/{tenant_id}/subscription/pause"
tags: ["Subscriptions"]
---

# Pause Subscription

`POST /admin/tenants/{tenant_id}/subscription/pause`

## Request

- Base URL: `https://developer.claimmind.life` (the document declares no server; this is the origin it was published from)
- URL: `https://developer.claimmind.life/admin/tenants/{tenant_id}/subscription/pause`
- Auth: OAuth 2
  - Password
  - Token URL: `token`

Pause a tenant's subscription.

Terminates the subscription in Lago and stores the pause state locally.
Billing stops and the Claims API is blocked for this tenant.

Use the resume endpoint to reactivate the subscription. The remaining
subscription time will be extended by the pause duration.

Idempotent: pausing an already-paused subscription returns 200.

**Access:** mtk_admin and super_admin (scoped to hospital group)

**Request body:**
```json
{
    "reason": "Payment dispute"
}
```

## Path parameters

- `tenant_id` string, required

## Request body

- SubscriptionPauseRequest: Request to pause a subscription.
  - `reason` string, nullable

## Response `200`

Successful Response

- SubscriptionPauseResponse: Response after pausing subscription.
  - `tenant_id` string, required
  - `paused_at` string, date-time, required
  - `previous_plan_code` string, required
  - `message` string

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/claimmind/apis/claimmind-open-api-service.md) - [All operations](https://skmtc.dev/claimmind/apis/claimmind-open-api-service/llms.txt) - [OpenAPI document](https://skmtc.dev/claimmind/apis/claimmind-open-api-service/revisions/ee8bfbeadb8a?raw)