# Bloomcount API

> REST API for products, price lists, tax groups, events, and outbound webhooks.

## Docs

- [Bloomcount Public API](https://docs.bloomcount.com/)
- [Quickstart](https://docs.bloomcount.com/quickstart): Create a key, make your first call, and read the response.
- [Authentication](https://docs.bloomcount.com/authentication): How to authenticate, what a key may do, and the limits a key is held to.
- [Conventions](https://docs.bloomcount.com/conventions): Bulk requests, resource-prefixed IDs, and per-supplier minimum order quantities.
- [Errors](https://docs.bloomcount.com/errors): Every status and code the API returns, what each means, and what to do about it.
- [Webhooks](https://docs.bloomcount.com/webhooks): Subscribe to event changes, verify a delivery, and understand the retries.

## Guides

- [Sync a catalogue](https://docs.bloomcount.com/guides/catalogue-sync): Push suppliers, colours and products from another system, and keep them in step.
- [Build an event](https://docs.bloomcount.com/guides/building-an-event): Create an event, group it, add lines, and read the result back.
- [Take a hire booking](https://docs.bloomcount.com/guides/hire-bookings): Book studio-owned stock for a date window, and understand how availability is judged.

## Categories

- [Create a category](https://docs.bloomcount.com/categories/post-api-v1-categories)
- [Delete a category](https://docs.bloomcount.com/categories/delete-api-v1-categories-id)
- [List categories](https://docs.bloomcount.com/categories/get-api-v1-categories)
- [Update a category](https://docs.bloomcount.com/categories/patch-api-v1-categories-id)

## Colours

- [Create a colour](https://docs.bloomcount.com/colours/post-api-v1-colors)
- [Delete a colour](https://docs.bloomcount.com/colours/delete-api-v1-colors-id)
- [List colours](https://docs.bloomcount.com/colours/get-api-v1-colors)
- [Update a colour](https://docs.bloomcount.com/colours/patch-api-v1-colors-id)

## Events

- [Add, change and remove an event's lines](https://docs.bloomcount.com/events/post-api-v1-events-id-items)
- [Bulk create or update events](https://docs.bloomcount.com/events/post-api-v1-events)
- [Create, update and remove an event's groups](https://docs.bloomcount.com/events/post-api-v1-events-id-groups)
- [Delete an event](https://docs.bloomcount.com/events/delete-api-v1-events-id)
- [Get one event](https://docs.bloomcount.com/events/get-api-v1-events-id)
- [List events](https://docs.bloomcount.com/events/get-api-v1-events)

## Price Lists

- [Create or update a price list with optional entries](https://docs.bloomcount.com/price-lists/post-api-v1-price-lists)
- [Delete a price list](https://docs.bloomcount.com/price-lists/delete-api-v1-price-lists-id)
- [Get a single price list with its entries](https://docs.bloomcount.com/price-lists/get-api-v1-price-lists-id)
- [List price lists](https://docs.bloomcount.com/price-lists/get-api-v1-price-lists)

## Products

- [Bulk create or update products + variants](https://docs.bloomcount.com/products/post-api-v1-products)
- [Delete a product](https://docs.bloomcount.com/products/delete-api-v1-products-id)
- [Delete a variant](https://docs.bloomcount.com/products/delete-api-v1-products-id-variants-variantid)
- [Get a single product with its variants](https://docs.bloomcount.com/products/get-api-v1-products-id)
- [List products with their variants](https://docs.bloomcount.com/products/get-api-v1-products)

## Staff

- [Create a staff member](https://docs.bloomcount.com/staff/post-api-v1-staff)
- [Delete a staff member](https://docs.bloomcount.com/staff/delete-api-v1-staff-id)
- [Get a staff member](https://docs.bloomcount.com/staff/get-api-v1-staff-id)
- [List staff](https://docs.bloomcount.com/staff/get-api-v1-staff)
- [Update a staff member](https://docs.bloomcount.com/staff/patch-api-v1-staff-id)

## Suppliers

- [Archive a supplier](https://docs.bloomcount.com/suppliers/post-api-v1-suppliers-id-archive)
- [Create a supplier](https://docs.bloomcount.com/suppliers/post-api-v1-suppliers)
- [Get a single supplier](https://docs.bloomcount.com/suppliers/get-api-v1-suppliers-id)
- [List suppliers](https://docs.bloomcount.com/suppliers/get-api-v1-suppliers)
- [Restore an archived supplier](https://docs.bloomcount.com/suppliers/post-api-v1-suppliers-id-unarchive)
- [Update a supplier](https://docs.bloomcount.com/suppliers/patch-api-v1-suppliers-id)

## Tax Groups

- [Create or update a tax group](https://docs.bloomcount.com/tax-groups/post-api-v1-tax-groups)
- [Delete a tax group](https://docs.bloomcount.com/tax-groups/delete-api-v1-tax-groups-id)
- [List tax groups](https://docs.bloomcount.com/tax-groups/get-api-v1-tax-groups)

## Venues

- [Create a venue](https://docs.bloomcount.com/venues/post-api-v1-venues)
- [Delete a venue](https://docs.bloomcount.com/venues/delete-api-v1-venues-id)
- [Get a venue](https://docs.bloomcount.com/venues/get-api-v1-venues-id)
- [List venues](https://docs.bloomcount.com/venues/get-api-v1-venues)
- [Update a venue](https://docs.bloomcount.com/venues/patch-api-v1-venues-id)

## Webhook subscriptions

- [Delete a webhook subscription](https://docs.bloomcount.com/webhook-subscriptions/delete-api-v1-webhooks-id)
- [List webhook subscriptions](https://docs.bloomcount.com/webhook-subscriptions/get-api-v1-webhooks)
- [Subscribe a URL to event deliveries](https://docs.bloomcount.com/webhook-subscriptions/post-api-v1-webhooks)

## Agent resources

- [llms-full.txt](https://docs.bloomcount.com/llms-full.txt): The full Markdown of every page in one file.
- [Page Markdown](https://docs.bloomcount.com/index.md): Append `.md` to any page URL to fetch that page as raw Markdown.
- [JSON API](https://docs.bloomcount.com/api/docs/pages.json): Page index of the JSON docs API; each entry links the page's JSON and Markdown forms. Described by the OpenAPI document at https://docs.bloomcount.com/openapi.json.
- [MCP server](https://docs.bloomcount.com/mcp): Streamable HTTP Model Context Protocol server with search_docs, get_page, list_pages, and get_navigation tools, plus every page as a resource. Discovery document: https://docs.bloomcount.com/.well-known/mcp.json
- [API catalog](https://docs.bloomcount.com/.well-known/api-catalog): RFC 9727 linkset of the APIs documented here.
- [agent-readability.json](https://docs.bloomcount.com/agent-readability.json): Manifest of every agent-facing artifact on this site.
- [Sitemap](https://docs.bloomcount.com/sitemap.xml): Every indexable page URL with its last-modified date.