---
title: "Delete a subscription item"
method: DELETE
path: "/subscriptions/{subscription_id}/items/{id}"
tags: ["Subscription items"]
---

# Delete a subscription item

`DELETE /subscriptions/{subscription_id}/items/{id}`

Removes an item from a subscription and returns the deleted item. Fintoc stops billing the item from the subscription's next invoice, with no proration for the current billing period. A subscription must keep at least one item, so its last item cannot be deleted.

## Path parameters

- `subscription_id` string, required
- `id` string, required

## Response `200`

The deleted subscription item.

- SubscriptionItem
  - `id` string, required — Unique identifier of the subscription item.
  - `object` 'subscription_item', required — Type of the object. Always `subscription_item`.
  - `price` object, required — Price the item bills for on every billing cycle.
    - `currency` 'CLF' | 'CLP' | 'MXN', required — Three-letter ISO 4217 currency code, returned in uppercase. One of `CLP`, `MXN` or `CLF`.
    - `product` object, required — Product the price belongs to.
      - `id` string, required — Unique identifier of the product.
      - `object` 'product', required — Type of the object. Always `product`.
      - `created_at` string, date-time, required — ISO 8601 timestamp of when the product was created.
      - `description` string, nullable, required — Free-text description of the product.
      - `image_url` string, nullable, required — HTTPS URL of an image of the product.
      - `metadata` object, required — Set of key-value pairs attached to the product.
      - `mode` 'live' | 'test', required — Mode of the object. One of `live` or `test`. `test` products use fake data for integration testing.
      - `name` string, required — Name of the product.
    - `recurring` object, required — Billing cadence of the price.
      - `interval` 'month' | 'year', required — Frequency at which the price bills. One of `month` or `year`.
      - `interval_count` integer, required — Number of intervals between each billing cycle. For example, `interval: "month"` with `interval_count: 3` bills every 3 months.
    - `unit_amount` integer, required — Amount the price bills per unit, in the smallest unit of the currency. CLP has no decimals, so `10000` is $10,000 CLP; MXN uses centavos, so `10000` is $100.00 MXN.
  - `quantity` integer, required — Number of units of the price the item bills for.

## Other responses

- `401` — Invalid or missing API key.
- `404` — The subscription or the item does not exist, or belongs to another organization or mode.
- `409` — The item is the last one of the subscription, which must keep at least one item.

---

[API](https://skmtc.net/fintoc/apis/fintoc-api.md) · [All operations](https://skmtc.net/fintoc/apis/fintoc-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/fintoc/fintoc-api/versions/9dafa63688a3/schema)