---
title: "Remover item"
url: "https://devcenter.stone.com.br/apis/v5-docs-legacy/versions/b9aaff36-6dcc-4353-8398-836d6c13dfa5/operations/remover-item"
---
> Full API specification: https://devcenter.stone.com.br/apis/v5-docs-legacy/versions/b9aaff36-6dcc-4353-8398-836d6c13dfa5.md
# Remover item
`DELETE` `/subscriptions/{subscription_id}/items/{item_id}`
Operation ID: `remover-item`
Com o verbo _HTTP DELETE_, através dos identificadores do item (`subscription_item_id`) e da assinatura (`subscription_id`) associada é possível remover um item da assinatura.
## Path parameters
- `subscription_id` (string, required) - Código da assinatura.
Formato: `sub_XXXXXXXXXXXXXXXX`.
- `item_id` (string, required) - Código do item da assinatura.
Formato: `si_XXXXXXXXXXXXXXXX`.
## Responses
- `200` - 200
- `400` - 400
## OpenAPI definition
```yaml
openapi: 3.1.0
info:
title: Pagar.me v5 API (Legado)
version: 5.0.0
servers:
- url: https://api.stone.com.br/core/v5
paths:
/subscriptions/{subscription_id}/items/{item_id}:
delete:
summary: Remover item
description: Com o verbo _HTTP DELETE_, através dos identificadores do item
(`subscription_item_id`) e da assinatura (`subscription_id`) associada é
possível remover um item da assinatura.
operationId: remover-item
parameters:
- name: subscription_id
in: path
description: "Código da assinatura.
Formato: `sub_XXXXXXXXXXXXXXXX`."
schema:
type: string
required: true
- name: item_id
in: path
description: "Código do item da assinatura.
Formato: `si_XXXXXXXXXXXXXXXX`."
schema:
type: string
required: true
responses:
"200":
description: "200"
content:
application/json:
examples:
Result:
value: |-
{
"id": "si_mARl1OvTYcA3pG49",
"description": "Telefone",
"cycles": 3,
"quantity": 1,
"name":"Nome - teste",
"status": "deleted",
"created_at": "2017-04-04T18:56:44Z",
"updated_at": "2017-04-04T18:57:48Z",
"deleted_at": "2017-04-04T19:00:44Z",
"pricing_scheme": {
"price": 99,
"scheme_type": "unit"
},
"subscription": {
"id": "sub_o0Jw4WYCMuPNqzGr",
"code": "09NFPLBZY0",
"start_at": "2017-04-04T00:00:00Z",
"interval": "month",
"interval_count": 1,
"billing_type": "postpaid",
"next_billing_at": "2017-05-04T00:00:00Z",
"payment_method": "credit_card",
"currency": "BRL",
"statement_descriptor": "Spotify",
"installments": 1,
"status": "active",
"created_at": "2017-04-04T18:21:17Z",
"updated_at": "2017-04-04T18:21:17Z"
}
}
schema:
type: object
properties:
id:
type: string
example: si_mARl1OvTYcA3pG49
description:
type: string
example: Telefone
cycles:
type: integer
example: 3
default: 0
quantity:
type: integer
example: 1
default: 0
name:
type: string
example: Nome - teste
status:
type: string
example: deleted
created_at:
type: string
example: 2017-04-04T18:56:44Z
updated_at:
type: string
example: 2017-04-04T18:57:48Z
deleted_at:
type: string
example: 2017-04-04T19:00:44Z
pricing_scheme:
type: object
properties:
price:
type: integer
example: 99
default: 0
scheme_type:
type: string
example: unit
subscription:
type: object
properties:
id:
type: string
example: sub_o0Jw4WYCMuPNqzGr
code:
type: string
example: 09NFPLBZY0
start_at:
type: string
example: 2017-04-04T00:00:00Z
interval:
type: string
example: month
interval_count:
type: integer
example: 1
default: 0
billing_type:
type: string
example: postpaid
next_billing_at:
type: string
example: 2017-05-04T00:00:00Z
payment_method:
type: string
example: credit_card
currency:
type: string
example: BRL
statement_descriptor:
type: string
example: Spotify
installments:
type: integer
example: 1
default: 0
status:
type: string
example: active
created_at:
type: string
example: 2017-04-04T18:21:17Z
updated_at:
type: string
example: 2017-04-04T18:21:17Z
"400":
description: "400"
content:
application/json:
examples:
Result:
value: "{}"
schema:
type: object
properties: {}
deprecated: false
security:
- sec0: []
components:
securitySchemes:
sec0:
type: http
scheme: basic
```