> ## Documentation Index
> Fetch the complete documentation index at: https://handbook.nyotaimara.com/llms.txt
> Use this file to discover all available pages before exploring further.

# POST /v1/billing/cancel — Cancel Your Subscription

> Cancel the active mail subscription for an organization. Mailboxes stay active until the current billing period ends — there is no immediate loss of access.

Cancel the active mail subscription for the organization. The subscription is marked as cancelled immediately, but mailboxes remain active and fully functional until the end of the current billing period. No refunds are issued for unused time.

<Info>
  Cancellation is end-of-period — your team keeps full access to mailboxes until the billing period expires.
</Info>

## Endpoint

```
POST /v1/billing/cancel
```

## Headers

<ParamField header="Authorization" type="string" required>
  Bearer token. Format: `Bearer <token>`
</ParamField>

<ParamField header="X-Organization-Id" type="string" required>
  The ID of the organization whose subscription will be cancelled.
</ParamField>

## Request body

No request body required.

## Response

<ResponseField name="success" type="boolean">
  `true` on a successful cancellation request.
</ResponseField>

<ResponseField name="message" type="string">
  Confirmation message including the date access will end. For example: `"Subscription cancelled. You will retain access until 7/31/2025."`
</ResponseField>

## Example

```bash theme={null}
curl --request POST \
  --url https://api.nyotaimara.com/v1/billing/cancel \
  --header 'Authorization: Bearer <token>' \
  --header 'X-Organization-Id: <org-id>'
```

```json theme={null}
{
  "success": true,
  "message": "Subscription cancelled. You will retain access until 7/31/2025."
}
```