---
title: "List Product Units"
method: GET
path: "/locations/{location_id}/units"
tags: ["Products"]
---

# List Product Units

`GET /locations/{location_id}/units`

## Request

- Base URL: `https://api.alteg.io/api/v2`
- URL: `https://api.alteg.io/api/v2/locations/{location_id}/units`
- Auth: HTTP bearer

Retrieve the measurement Units available to Products in a Location as
JSON:API resource objects. The collection contains shared system Units and
any Units configured specifically for the Location.

Use Unit IDs as `sale_unit_id` and `consumable_unit_id` in Product data.

## Path parameters

- `location_id` integer, required

## Headers

- `Accept` string, required
- `Authorization` string, required

## Response `200`

Product Units retrieved successfully

- object
  - `data` UnitResource[], required
    - `type` 'unit', required: Literal JSON:API resource type
    - `id` string, required: Product Unit ID
    - `attributes` object, required
      - `company_id` integer, required: Location ID for a custom Unit; `0` for a shared system Unit
      - `title` string, required: Full Unit name
      - `short_title` string, required: Abbreviated Unit name

## Other responses

- `401`: Unauthorized
- `403`: Forbidden - No permission to read Product Units for this Location
- `404`: Location not found

---

[API](https://skmtc.dev/alteg/apis/business-management.md) - [All operations](https://skmtc.dev/alteg/apis/business-management/llms.txt) - [OpenAPI document](https://skmtc.dev/alteg/apis/business-management/revisions/a2d63320b944?raw)
