# Remover item

**Área:** Plano e itens

Remove um item da assinatura.

`DELETE /v1/subscriptions/:subscriptionId/items/:itemId`

**Base URL Produção:** `https://api.validapay.com.br`  
**Base URL Sandbox:** `https://sandbox.validapay.com.br`

**Scopes necessários:** `subscriptions/write`

**O que acontece com a cobrança:** por padrão o item sai **a partir da próxima cobrança**, e a cobrança atual não muda. Com `effectiveAt: "IMMEDIATE"`, o item sai já do ciclo atual.

> O plano principal não pode ser removido; para encerrar a assinatura use **Cancelar assinatura**.

### Path parameters

| Campo | Obrigatório | Descrição |
|---|---|---|
| `subscriptionId` | **sim** | ID da assinatura (ex: sub_xxx) - required |
| `itemId` | **sim** | ID do item da assinatura, em items[].itemId de Ver uma assinatura (ex: item_xxx) - required |

### Request body

```json
{
    "effectiveAt": "NEXT_CYCLE" 
}
```

### Campos do body

**Opcionais**

| Campo | Descrição |
|---|---|
| `effectiveAt` | NEXT_CYCLE: sai a partir da próxima cobrança. IMMEDIATE: sai já do ciclo atual (padrão NEXT_CYCLE) (valores: NEXT_CYCLE, IMMEDIATE) |

### Resposta 200: 200

```json
{
    "success": true, 
    "type": "ITEM_REMOVED", 
    "subscriptionId": "sub_xxx", 
    "itemId": "item_addon", 
    "removedAmount": 30.0, 
    "recurringTotal": 99.9, 
    "effectiveAt": "NEXT_CYCLE", 
    "effectiveDate": "2026-10-10T00:00:00.000Z" 
}
```

#### Campos da resposta

| Campo | Descrição |
|---|---|
| `success` | true quando o item foi removido |
| `type` | ITEM_REMOVED: removido agora. ALREADY_REMOVED: o item já tinha sido removido (valores: ITEM_REMOVED, ALREADY_REMOVED) |
| `subscriptionId` | ID da assinatura |
| `itemId` | Item removido |
| `removedAmount` | Quanto o item representava por ciclo, em reais |
| `recurringTotal` | Novo total recorrente da assinatura, em reais |
| `effectiveAt` | Quando a remoção vale (valores: NEXT_CYCLE, IMMEDIATE) |
| `effectiveDate` | Data a partir da qual o item deixa de ser cobrado |

### Resposta 404: 404

```json
{
    "error": {
        "message": "Item não encontrado",
        "code": "ITEM_NOT_FOUND",
        "details": null,
        "timestamp": "2026-09-24T12:00:00.000Z"
    }
}
```


---

Página: https://docs.validapay.com.br/referencia/delete-remover-item  
Contrato OpenAPI: https://docs.validapay.com.br/openapi.json