v1

latestOpenAPI 3.1.02026-07-228956435.8 KB
Subscription items

Delete a subscription item

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.

delete/subscriptions/{subscription_id}/items/{id}

Path parameters

subscription_idstring required

The id of the subscription the item belongs to.

idstring required

The id of the subscription item to delete.

Response

The deleted subscription item.

idstring required

Unique identifier of the subscription item.

object'subscription_item' required

Type of the object. Always subscription_item.

quantityinteger required

Number of units of the price the item bills for.

Example response

{
  "id": "si_2c4mDfkPLLrLTCJ3wPCEHGYpkVf",
  "price": {
    "currency": "CLP",
    "product": {
      "id": "prod_2c4mDgwQqkNwMHnXSc4DBjkbcWz",
      "created_at": "2026-06-01T15:00:00Z",
      "description": "Access to every premium feature.",
      "image_url": "https://example.com/image.png",
      "metadata": {
        "category": "saas"
      },
      "mode": "live",
      "name": "Premium plan"
    },
    "recurring": {
      "interval": "month",
      "interval_count": 1
    },
    "unit_amount": 10000
  },
  "quantity": 1
}