---
search:
  tags:
    - Price Lists
    - DELETE
seo:
  description: >-
    Deletes the list; its entries purge in the background rather than… Reference
    for the DELETE /api/v1/price-lists/{id} endpoint in the Bloomcount Public
    API API.
sidebar:
  label: Delete a price list
  badge: DELETE
title: Delete a price list
type: openapi-operation
---
Deletes the list; its entries purge in the background rather than inline, so a list holding thousands of
prices deletes without hitting a write limit.

An event that loses its price list falls back to default rates silently, so this refuses with
`409 price_list_in_use:<count>` while any event points at the list as its flower, materials or hire list.
`?force=true` deletes it anyway.

<Operation source="reference" id="delete-api-v1-price-lists-id" />