Cost Categories
List Cost Categories
List all cost categories, ordered by name.
Create Cost Category
Create a new cost category.
List Cost Categories (Paginated)
Paginated, server-side-filtered list of cost categories. Supports search (name / id / keyword aliases), active/system/selectable filters, and sorting, returning a standard paginated envelope. Each item includes usage counts and, when set, the embedded default nominal code.
Get Cost Category
Show a single cost category with usage counts and its embedded `default_nominal_code` (when set).
Update Cost Category
Update an existing cost category.
Delete Cost Category
Delete a cost category. Fails if the category is a system category, or if it is in use (bill lines / breakdown items / financial line types) unless `?force=true` is passed.
Archive Cost Category
Archive a cost category (soft-archive via is_active=false). System categories cannot be archived (returns 422).
Unarchive Cost Category
Unarchive a cost category (is_active=true).
Merge Cost Category
Merge a cost category into a target. Re-points all references (bill lines, breakdown items, financial line types) from the source to the target, then deletes the source. Returns the target category.
Fuzzy Match Cost Category
Suggest a fuzzy-matched category for the given name — used by the create form to warn 'Did you mean Freight?' before a near-duplicate is created. Returns null in `data` when no close match is found.