# DeletePlansPlan

From **Stripe API**.

`DELETE /v1/plans/{plan}`

<p>Deleting plans means new subscribers can’t be added. Existing subscribers aren’t affected.</p>

## Parameters

### `plan`

- Location: path
- Required: true
- Type: `string`
- maxLength: `5000`

## Request body

- Required: false
### `application/x-www-form-urlencoded`

- Type: `object`

```json
{"additionalProperties":false,"type":"object"}
```

## Security

### `basicAuth`

- Type: `http`
- Request header: `Authorization`
- Scheme: `basic`
Send credentials in the `Authorization` request header using the `Basic` scheme.

Basic HTTP authentication. Allowed headers-- Authorization: Basic <api_key> | Authorization: Basic <base64 hash of `api_key:`>

### `bearerAuth`

- Type: `http`
- Request header: `Authorization`
- Scheme: `bearer`
- Bearer format: `auth-scheme`
Send the token in the `Authorization` request header using the `Bearer` scheme.

Bearer HTTP authentication. Allowed headers-- Authorization: Bearer <api_key>

## Responses

### `200`

Successful response.

### `application/json`

- Type: `object`

```json
{"properties":{"deleted":{"description":"Always true for a deleted object","enum":[true],"type":"boolean"},"id":{"description":"Unique identifier for the object.","maxLength":5000,"type":"string"},"object":{"description":"String representing the object's type. Objects of the same type share the same value.","enum":["plan"],"type":"string"}},"required":["deleted","id","object"],"title":"DeletedPlan","type":"object","x-expandableFields":[],"x-resourceId":"deleted_plan"}
```

### `default`

Error response.

### `application/json`

- Type: `object`

An error response from the Stripe API

```json
{"description":"An error response from the Stripe API","properties":{"error":{"$ref":"#/components/schemas/api_errors"}},"required":["error"],"type":"object"}
```

## Request examples

### cURL

```shell
curl --request DELETE \
  --url https://api.stripe.com/v1/plans/{plan} \
  --header 'content-type: application/x-www-form-urlencoded' \
  --data '{}'
```