---
title: "Validate whether an item's inventory (base) unit can be changed to a target unit. Reports the source units (sales/purch/barcode) that lack a usable conversion to the target so the caller can create them before committing. Read-only; changes nothing."
method: GET
path: "/v1/Items/{itemId}/unit-of-measure/conversion-check"
tags: ["Items"]
---

# Validate whether an item's inventory (base) unit can be changed to a target unit. Reports the source units (sales/purch/barcode) that lack a usable conversion to the target so the caller can create them before committing. Read-only; changes nothing.

`GET /v1/Items/{itemId}/unit-of-measure/conversion-check`

## Request

- Base URL: `https://api.invendor.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.invendor.com/v1/Items/{itemId}/unit-of-measure/conversion-check`
- Auth: OAuth 2
  - Authorization code: `https://identity.scanbro.com/connect/authorize`
  - Token URL: `https://identity.scanbro.com/connect/token` scopes: `io.common`
- TypeScript: <https://skmtc.dev/invendor/apis/io-commonapi/docs/v1/Items/:itemId/unit-of-measure/conversion-check/get.ts> (a function with typed inputs; its response is checked against the schema)

## Path parameters

- `itemId` integer, required

## Query parameters

- `targetUnit` string, required
- `Account` unknown

## Response `200`

Success

- UnitOfMeasureChangeValidationResponse
  - `canChange` boolean
  - `missingConversions` UnitConversionGap[], nullable
    - `fromUnitId` string, nullable
    - `toUnitId` string, nullable
    - `reason` 0 | 1

## Other responses

- `400`: Bad Request
- `401`: Unauthorized
- `403`: Forbidden

## Changes

- **2026-08-27** `61263b2302a0`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/invendor/apis/io-commonapi/changes/v1/Items/:itemId/unit-of-measure/conversion-check/get.md)

---

[API](https://skmtc.dev/invendor/apis/io-commonapi.md) - [All operations](https://skmtc.dev/invendor/apis/io-commonapi/llms.txt) - [OpenAPI document](https://skmtc.dev/invendor/apis/io-commonapi/revisions/6a4a4fd7114d?raw)