---
title: "Retrieve an unit-of-measure set"
method: GET
path: "/quickbooks-desktop/unit-of-measure-sets/{id}"
---

# Retrieve an unit-of-measure set

`GET /quickbooks-desktop/unit-of-measure-sets/{id}`

Retrieves an unit-of-measure set by ID.

**IMPORTANT:** If you need to fetch multiple specific unit-of-measure sets by ID, use the list endpoint instead with the `ids` parameter. It accepts an array of IDs so you can batch the request into a single call, which is significantly faster.

## Path parameters

- `id` string, required — The QuickBooks-assigned unique identifier of the unit-of-measure set to retrieve.

## Headers

- `Conductor-End-User-Id` string, required — The ID of the End-User to receive this request.

## Response `200`

Returns the specified unit-of-measure set.

- QbdUnitOfMeasureSet
  - `id` string, required — The unique identifier assigned by QuickBooks to this unit-of-measure set. This ID is unique across all unit-of-measure sets but not across different QuickBooks object types.
  - `objectType` 'qbd_unit_of_measure_set', required — The type of object. This value is always `"qbd_unit_of_measure_set"`.
  - `createdAt` string, required — The date and time when this unit-of-measure set was created, in ISO 8601 format (YYYY-MM-DDThh:mm:ss±hh:mm), which QuickBooks Desktop interprets in the local timezone of the end-user's computer.
  - `updatedAt` string, required — The date and time when this unit-of-measure set was last updated, in ISO 8601 format (YYYY-MM-DDThh:mm:ss±hh:mm), which QuickBooks Desktop interprets in the local timezone of the end-user's computer.
  - `revisionNumber` string, required — The current QuickBooks-assigned revision number of this unit-of-measure set object, which changes each time the object is modified. When updating this object, you must provide the most recent `revisionNumber` to ensure you're working with the latest data; otherwise, the update will return an error.
  - `name` string, required — The case-insensitive unique name of this unit-of-measure set, unique across all unit-of-measure sets. To ensure this set appears in the QuickBooks UI for companies configured with a single unit per item, prefix the name with "By the" (e.g., "By the Barrel"). **NOTE**: Unit-of-measure sets do not have a `fullName` field because they are not hierarchical objects, which is why `name` is unique for them but not for objects that have parents.
  - `isActive` boolean, required — Indicates whether this unit-of-measure set is active. Inactive objects are typically hidden from views and reports in QuickBooks. Defaults to `true`.
  - `unitOfMeasureType` 'area' | 'count' | 'length' | 'other' | 'time' | 'volume' | 'weight', required — The unit-of-measure set's type. Use "other" for a custom type defined in QuickBooks.
  - `baseUnit` QbdBaseUnit, required
    - `name` string, required — The case-insensitive unique name of this base unit, unique across all base units. **NOTE**: Base units do not have a `fullName` field because they are not hierarchical objects, which is why `name` is unique for them but not for objects that have parents.
    - `abbreviation` string, required — The base unit's short identifier shown in the QuickBooks U/M field on transaction line items.
  - `relatedUnits` QbdRelatedUnit[], required — The unit-of-measure set's related units, each specifying how many base units they represent (conversion ratio).
    - `name` string, required — The case-insensitive unique name of this related unit, unique across all related units. **NOTE**: Related units do not have a `fullName` field because they are not hierarchical objects, which is why `name` is unique for them but not for objects that have parents.
    - `abbreviation` string, required — The related unit's short identifier shown in the QuickBooks U/M field on transaction line items.
    - `conversionRatio` string, required — The number of base units in this related unit, represented as a decimal string. For example, if the base unit is "box" and this related unit is "case" with `conversionRatio` = "10", that means there are 10 boxes in one case.
  - `defaultUnits` QbdDefaultUnit[], required — The unit-of-measure set's default units to appear in the U/M field on transaction line items. You can specify separate defaults for purchases, sales, and shipping.
    - `unitUsedFor` 'purchase' | 'sales' | 'shipping', required — Where this default unit is used as the default: purchase line items, sales line items, or shipping lines.
    - `unit` string, required — The unit name for this default unit, as displayed in the U/M field. If the company file is enabled for multiple units per item, this appears as an available unit for the item. Must correspond to the base unit or a related unit defined in this set.

---

[API](https://skmtc.net/conductor-is/apis/conductor-api.md) · [All operations](https://skmtc.net/conductor-is/apis/conductor-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/conductor-is/conductor-api/revisions/0b07b3ebe160/schema)