---
title: "Get unit types"
method: GET
path: "/public/v1/unit-types"
tags: ["UnitType"]
---

# Get unit types

`GET /public/v1/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](#model-costtype) 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

- `ids` string[]
- `inserted_datetime` string
- `updated_datetime` string
- `page` string

## Response `200`

A list of unit types

## Other responses

- `400` — Invalid parameters
- `401` — Missing or invalid API token
- `403` — The API token lacks the required permission

---

[API](https://skmtc.dev/distru/apis/distru-api.md) · [All operations](https://skmtc.dev/distru/apis/distru-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/distru/distru-api/revisions/eb775b7b6ee0/schema)