Get cost types
List cost types for the authenticated company. A cost type is a reusable, company-scoped category of cost accounting figure (e.g. freight, labor) with a default per-unit amount and a unit of measure. Cost types are configuration, not transactions — they are the templates you draw from when applying a cost to a plant, a package or batch, an assembly or breakdown output, a purchase item, or a product. Each applied cost snapshots its own amount and quantity at apply time, so a cost type's values here only seed future applications and never restate historical costs.
Results are scoped to your company and ordered oldest-first by creation time. Both active and inactive cost types are returned; soft-deleted ones are excluded. The response is paginated — follow the next_page URL to page through the full set.
Required permission: costs_permissions_manage_cost_types.
Query parameters
Restrict the result to specific cost types by ID (the same ID returned as each cost type's id). Repeat the bracketed key once per ID. Unknown IDs simply match nothing; an empty list is treated as no filter. At most 200 IDs may be given.
Filter to cost types by their creation datetime, given as a comma-separated start,end pair of ISO8601 datetimes (inclusive). Either bound may be omitted for an open-ended range: 2022-07-10T00:00:00Z, matches on or after that instant, ,2022-07-10T00:00:00Z matches on or before it.
Filter to cost types by their last-updated datetime, given as a comma-separated start,end pair of ISO8601 datetimes (inclusive). Either bound may be omitted for an open-ended range.
Page selector. Page size is fixed by the server; paginate by following the next_page URL in each response rather than building page selectors yourself — it is null on the last page. next_page uses page[after]=<cursor>, an opaque token marking where the next page resumes; pass it back exactly as given, and only to the endpoint that issued it. This is seek-based, so every page stays fast no matter how deep you page.
Response
A list of cost types
Changes
No recorded changes to this endpoint across all 1 revision of this API.