APIUnit type

Get a unit type

GET
/public/v1/unit-types/{id}

Get a single unit type by ID. Returns 404 if no unit type with that ID exists in your company. Inactive unit types are still returned. This endpoint is read-only.

Remember the two shapes a unit type can take: a locked, built-in standard unit carries a category and qty_per_si_unit; a custom unit you defined returns null for both.

Authorization

Bearer
headerAuthorizationBearer <token>

API token generated in Distru (Settings → Distru API). Send it on every request as Authorization: Bearer YOUR_API_TOKEN.

Path Parameters

id*string

ID of the unit type to fetch, as returned in the id field of the list endpoint.

Response Body

A single unit type

*/*
  1. response

A single unit type envelope

data?

A unit type

Example Request
curl -X GET 'https://app.distru.com/public/v1/unit-types/00000000-0000-0000-0000-000000000f79'
Example Response
{  "data": {    "active": true,    "category": "WEIGHT",    "id": "00000000-0000-0000-0000-000000000f79",    "inserted_datetime": "2026-08-24T16:01:04.103191Z",    "locked": true,    "name": "Big Bag",    "qty_per_si_unit": "453.592",    "updated_datetime": "2026-08-24T16:01:04.103191Z"  }}