Get unit types
List unit types for the authenticated company. A unit type is a company-scoped unit of measure (e.g. Gram, Pound, Milliliter, or a custom unit you define) used to express quantities throughout Distru — on products, inventory levels, cost type rates, and order and purchase line items. This endpoint is read-only; unit types are managed in the Distru web app.
There are two kinds of unit type in the response: • Distru's built-in standard units (Gram, Pound, Liter, etc.) are locked (cannot be renamed or deleted) and always carry a category (COUNT, VOLUME, or WEIGHT) and a qty_per_si_unit conversion factor. • Custom units you create are unlocked and have both category and qty_per_si_unit set to null — they are treated as opaque labels with no physical conversion.
Results are scoped to your company and ordered oldest-first by creation time. Both active and inactive unit types are returned. The response is paginated — follow the next_page URL to page through the full set.
Query parameters
Restrict the result to specific unit types by ID (the same ID returned as each unit 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 unit 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 unit 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 unit types
Changes
No recorded changes to this endpoint across all 1 revision of this API.