> ## Documentation Index > Fetch the complete documentation index at: https://docs.fintoc.com/llms.txt > Use this file to discover all available pages before exploring further. # 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. **`v2`** ยท Base URL `https://api.fintoc.com/v2` ## OpenAPI ````yaml reference/fintoc-api-v2.json DELETE /subscriptions/{subscription_id}/items/{id} openapi: 3.1.0 info: title: fintoc-api-v2 version: v2026-02-01 servers: - url: https://api.fintoc.com/v2 security: [] paths: /subscriptions/{subscription_id}/items/{id}: delete: tags: - Subscription items summary: Delete a subscription item description: >- 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. operationId: subscription-items-delete parameters: - name: subscription_id in: path description: The `id` of the subscription the item belongs to. required: true schema: type: string - name: id in: path description: The `id` of the subscription item to delete. required: true schema: type: string responses: '200': description: The deleted subscription item. content: application/json: examples: subscription_item_deleted: value: id: si_2c4mDfkPLLrLTCJ3wPCEHGYpkVf object: subscription_item price: currency: CLP product: id: prod_2c4mDgwQqkNwMHnXSc4DBjkbcWz object: product created_at: '2026-06-01T15:00:00Z' description: Access to every premium feature. image_url: https://example.com/image.png metadata: {} mode: live name: Premium plan recurring: interval: month interval_count: 1 unit_amount: 1000 quantity: 1 schema: $ref: '#/components/schemas/subscription_item' '401': description: Invalid or missing API key. content: application/json: examples: invalid_api_key: value: error: type: authentication_error code: invalid_api_key message: 'Invalid API Key: invalid-*oken' schema: $ref: '#/components/schemas/error_object' '404': description: >- The subscription or the item does not exist, or belongs to another organization or mode. content: application/json: examples: subscription_item_not_found: value: error: type: invalid_request_error code: missing_resource param: id message: >- No such invoicing/subscription_item: si_2c4mDfkPLLrLTCJ3wPCEHGYpkVf doc_url: https://docs.fintoc.com/reference/errors schema: $ref: '#/components/schemas/error_object' '409': description: >- The item is the last one of the subscription, which must keep at least one item. content: application/json: examples: invalid_empty_subscription: value: error: type: invalid_request_error code: invalid_empty_subscription message: A subscription must have at least one subscription item schema: $ref: '#/components/schemas/error_object' security: - api_key: [] components: schemas: subscription_item: type: object properties: id: type: string description: Unique identifier of the subscription item. example: si_2c4mDfkPLLrLTCJ3wPCEHGYpkVf object: const: subscription_item description: Type of the object. Always `subscription_item`. price: type: object description: Price the item bills for on every billing cycle. properties: currency: type: string enum: - CLF - CLP - MXN description: >- Three-letter ISO 4217 currency code, returned in uppercase. One of `CLP`, `MXN` or `CLF`. example: CLP product: type: object description: Product the price belongs to. properties: id: type: string description: Unique identifier of the product. example: prod_2c4mDgwQqkNwMHnXSc4DBjkbcWz object: const: product description: Type of the object. Always `product`. created_at: type: string format: date-time description: ISO 8601 timestamp of when the product was created. example: '2026-06-01T15:00:00Z' description: type: - string - 'null' description: Free-text description of the product. example: Access to every premium feature. image_url: type: - string - 'null' description: HTTPS URL of an image of the product. example: https://example.com/image.png metadata: type: object description: Set of key-value pairs attached to the product. example: category: saas mode: type: string enum: - live - test description: >- Mode of the object. One of `live` or `test`. `test` products use fake data for integration testing. example: live name: type: string description: Name of the product. example: Premium plan required: - id - object - created_at - description - image_url - metadata - mode - name recurring: type: object description: Billing cadence of the price. properties: interval: type: string enum: - month - year description: >- Frequency at which the price bills. One of `month` or `year`. example: month interval_count: type: integer description: >- Number of intervals between each billing cycle. For example, `interval: "month"` with `interval_count: 3` bills every 3 months. example: 1 required: - interval - interval_count unit_amount: type: integer description: >- 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. example: 10000 required: - currency - product - recurring - unit_amount quantity: type: integer description: Number of units of the price the item bills for. example: 1 required: - id - object - price - quantity error_object: type: object properties: error: type: object description: Details of the error that caused the request to fail. properties: code: type: string description: >- Machine-readable code identifying the specific error, for example `invalid_api_key`. Not returned by every error. example: invalid_api_key doc_url: type: string description: >- URL of a documentation page with more details about the error. Not returned by every error. example: https://docs.fintoc.com/reference/errors message: type: string description: Human-readable message describing the error. example: 'Invalid API Key: invalid-*oken' param: type: - string - 'null' description: >- Name of the request parameter that caused the error. `null` when the error cannot be tied to a single parameter, and not returned by every error. example: amount type: type: string description: >- Category of the error, for example `invalid_request_error`, `authentication_error`, or `api_error`. example: invalid_request_error required: - type - message securitySchemes: api_key: type: apiKey name: Authorization in: header ````