> ## Documentation Index > Fetch the complete documentation index at: https://docs.restaurant365.com/llms.txt > Use this file to discover all available pages before exploring further. # Unit of Measure by ID > Retrieves a specified unit of measure **Security** The requesting user must have the following permission to retrieve a unit of measure: - Food → Units of Measure → View Units of Measure ## OpenAPI ````json GET /public/v1/inventory/units-of-measure/{id} { "openapi": "3.0.1", "info": { "title": "R365 Public API", "contact": { "name": "R365 Services Team", "email": "r365@restaurant365.com" }, "version": "1.0" }, "security": [ { "Bearer": [] } ], "paths": { "/public/v1/inventory/units-of-measure/{id}": { "get": { "tags": [ "inventory" ], "summary": "Unit of Measure by ID", "description": "Retrieves a specified unit of measure\n\n**Security**\n\nThe requesting user must have the following permission to retrieve a unit of measure:\n\n- Food → Units of Measure → View Units of Measure", "parameters": [ { "$ref": "#/components/parameters/TenantId" }, { "name": "id", "in": "path", "description": "The identifier of the unit of measure", "required": true, "schema": { "type": "string", "format": "uuid" } } ], "responses": { "200": { "description": "The unit of measure entity", "content": { "text/plain": { "schema": { "$ref": "#/components/schemas/UnitOfMeasure" } }, "application/json": { "schema": { "$ref": "#/components/schemas/UnitOfMeasure" } }, "text/json": { "schema": { "$ref": "#/components/schemas/UnitOfMeasure" } } } }, "400": { "description": "Bad Request — a parameter value is malformed, of the wrong type, or outside its allowed range." }, "401": { "description": "Unauthorized — the bearer token is missing, invalid or expired, or is not valid for the specified tenant." }, "403": { "description": "Forbidden — the caller lacks the permission required for this operation." }, "404": { "description": "Not Found — the requested resource does not exist, or the supplied continuation token is unknown or has expired." }, "409": { "description": "Conflict — the request conflicts with the current state of the resource and cannot be applied." }, "422": { "description": "Unprocessable Entity — a required parameter is missing, or a supplied parameter value is invalid." }, "429": { "description": "Too Many Requests — the caller has exceeded the rate limit; retry after a short delay." }, "500": { "description": "Internal Server Error — an unexpected error occurred while processing the request." } } } } }, "components": { "parameters": { "TenantId": { "name": "x-r365-context-tenant-id", "in": "header", "required": true, "description": "Identifies the R365 tenant the request applies to. Required on every request.", "schema": { "type": "string" } } }, "schemas": { "UnitOfMeasure": { "type": "object", "properties": { "id": { "type": "string", "description": "The id of the unit of measure.", "format": "uuid" }, "name": { "type": "string", "description": "The name of the unit of measure.", "nullable": true }, "isBase": { "type": "boolean", "description": "Indicates whether this unit of measure is a base unit of measure." }, "isPrimitive": { "type": "boolean", "description": "Indicates whether this unit of measure is a primitive unit of measure, meaning it is\r\ndefined by the system and cannot be modified or deleted." }, "isPurchase": { "type": "boolean", "description": "Indicates whether this unit of measure can be used for purchase items." }, "isRecipe": { "type": "boolean", "description": "Indicates whether this unit of measure can be used for recipe items." }, "isActive": { "type": "boolean", "description": "Indicates whether this unit of measure is active." }, "baseQuantity": { "type": "number", "description": "The quantity multiplier for this unit of measure in relation to the base unit of measure.", "format": "double" }, "equivalentQuantity": { "type": "number", "description": "The quantity multiplier for this unit of measure in relation to the equivalent unit of measure.", "format": "double" }, "measureType": { "$ref": "#/components/schemas/MeasureType" }, "equivalentUnitOfMeasure": { "$ref": "#/components/schemas/UnitOfMeasureReference" }, "baseUnitOfMeasure": { "$ref": "#/components/schemas/UnitOfMeasureReference" }, "brand": { "$ref": "#/components/schemas/BrandReference" }, "createdBy": { "$ref": "#/components/schemas/GlAccountUserReference", "description": "User who created the unit of measure." }, "createdOn": { "type": "string", "description": "The date and time this unit of measure was created.", "format": "date-time" }, "modifiedBy": { "$ref": "#/components/schemas/GlAccountUserReference", "description": "User who last modified the unit of measure." }, "modifiedOn": { "type": "string", "description": "The date and time this unit of measure was last modified.", "format": "date-time" } }, "additionalProperties": false, "description": "A unit of measure, which is a way to quantify the amount of an item." }, "MeasureType": { "enum": [ 1, 2, 3 ], "type": "integer", "description": "The available basic measurement definitions", "format": "int32", "x-enum-varnames": [ "Weight", "Volume", "Each" ] }, "UnitOfMeasureReference": { "type": "object", "properties": { "id": { "type": "string", "format": "uuid", "description": "Unique identifier of the unit of measure." }, "name": { "type": "string", "nullable": true, "description": "Display name of the unit of measure." } }, "additionalProperties": false, "description": "A reference to a unit of measure." }, "BrandReference": { "type": "object", "properties": { "id": { "type": "integer", "format": "int64", "description": "Unique identifier of the brand." }, "name": { "type": "string", "nullable": true, "description": "Display name of the brand." } }, "additionalProperties": false, "description": "A reference to a Brand." }, "GlAccountUserReference": { "type": "object", "properties": { "id": { "type": "string", "description": "The unique identifier of the user.", "format": "uuid" }, "name": { "type": "string", "description": "The name of the user.", "nullable": true } }, "additionalProperties": false, "description": "A reference to a user." } }, "securitySchemes": { "Bearer": { "type": "http", "scheme": "Bearer" } } } } ````