---
title: "Delete a split"
method: DELETE
path: "/v1/splits/{id}"
tags: ["Splits"]
---

# Delete a split

`DELETE /v1/splits/{id}`

Delete a split by ID. The split stops applying to future payments immediately. Splits belonging to another store cannot be deleted.

## Path parameters

- `id` string, required

## Response `200`

Successfully deleted the split

- SplitEntity
  - `id` string, required — Unique identifier for the object.
  - `mode` 'test' | 'prod' | 'sandbox', required — String representing the environment.
  - `object` string, required — String representing the object's type. Objects of the same type share the same value.
  - `store_id` string, required — The id of the store that owns this split.
  - `description` string, nullable — A human-readable description of the split.
  - `type` 'store' | 'product', required — What the split applies to: `store` (every payment to the store) or `product` (payments for a specific product).
  - `type_reference` string, required — The id of the entity the split applies to: the store id when `type` is `store`, or the product id when `type` is `product`.
  - `enabled` boolean, required — Whether the split is active. A split created with email invitees starts disabled and activates once the first invitee accepts.
  - `recipients` SplitRecipientEntity[], required — The recipients of the split and their shares.
    - `type` 'fixed' | 'percentage', required — How the share is calculated. Currently always `percentage` — the recipient receives `amount` percent of the split net.
    - `recipient_type` 'store' | 'user' | 'email', required — The kind of recipient. `store` and `user` are resolved (active) recipients; `email` is an invitee who has not yet accepted (the split share is held until they do).
    - `recipient_reference` string, required — Reference to the recipient: a store id (`recipient_type: store`), a user id (`recipient_type: user`), or a masked email address (`recipient_type: email`). Raw invitee email addresses are never returned.
    - `amount` number, required — The recipient share, as a percentage of the split net (e.g. 25 = 25%).
    - `enabled` boolean, required — Whether this recipient is currently receiving its share. Email invitees start disabled until they accept.
    - `invite_status` 'pending' | 'declined', nullable — Invite lifecycle for email-type recipients that have not been accepted yet: `pending` (awaiting acceptance) or `declined`. Absent for resolved store/user recipients.
  - `created_at` number, required — Creation date of the split as a timestamp.

## Other responses

- `400` — Bad Request - Invalid input parameters
- `401` — Unauthorized - Invalid or missing API key
- `404` — Not Found - Resource does not exist

## Changes

- **2026-08-28** `098b518de5cd` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/creem/apis/creem-api/changes/v1/splits/:id/delete.md)

---

[API](https://skmtc.dev/creem/apis/creem-api.md) · [All operations](https://skmtc.dev/creem/apis/creem-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/creem/creem-api/revisions/098b518de5cd/schema)