--- title: "Get items by tax rate" method: GET path: "/v3/merchants/{mId}/tax_rates/{taxId}/items" tags: ["INVENTORY"] --- # Get items by tax rate `GET /v3/merchants/{mId}/tax_rates/{taxId}/items` ## Request - Base URL: `https://apisandbox.dev.clover.com` - URL: `https://apisandbox.dev.clover.com/v3/merchants/{mId}/tax_rates/{taxId}/items` - Auth: HTTP bearer ## Path parameters - `mId` string, required - `taxId` string, required ## Query parameters - `filter` string - `expand` string ## Headers - `User-Agent` string, required ## Response `200` - object - `id` string: Unique identifier - `hidden` boolean: True if this item is hidden from Clover Register App - `available` boolean: True if this item is available for sale across all channels - `autoManage` boolean: False manually manage item availability, True item availability depends on stock count - `itemGroup` object: Reference to an item group - `id` string: Unique identifier. - `options` object[]: List of options pertaining to this item's attribute variation - `id` string: Unique identifier - `name` string, required: Name of the option - `attribute` object - `id` string: Unique identifier. - `items` object[]: Items associated with this option - `id` string: Unique identifier. - `name` string, required: Name of the item - `alternateName` string: Alternate name of the item - `code` string: Product code, e.g. UPC or EAN - `sku` string: SKU of the item - `price` integer, required: Price of the item, typically in cents; use priceType and merchant currency to determine actual item price. For non-VAT merchants, this field is exclusive of tax. For VAT merchants, this field is inclusive of tax. - `priceType` 'FIXED' | 'VARIABLE' | 'PER_UNIT' - `defaultTaxRates` boolean: Flag to indicate whether or not to use default tax rates - `unitName` string: Unit name, e.g. oz, lb - `cost` integer: Cost of the item to merchant, as opposed to customer price - `isRevenue` boolean: True if this item should be counted as revenue. For example, gift cards and donations would not be counted as revenue. - `stockCount` integer: Deprecated, use itemStock instead. - `taxRates` object[] - `id` string - `name` string, required - `taxType` 'VAT_TAXABLE' | 'VAT_NON_TAXABLE' | 'VAT_EXEMPT' | 'INTERNAL_TAX' | 'PARTNER_TAX': Tax type used in Argentina. - `rate` integer: For percentage based discounts like sales tax - `isDefault` boolean - `items` object[]: Items associated with this tax rate - `id` string: Unique identifier. - `taxAmount` integer: For a flat tax like recycling redemption fee, expressed as number of cents - `deletedTime` integer: Timestamp when tax rate was last deleted - `modifiedTime` integer: Timestamp when tax rate was last modified - `modifierGroups` object[] - `id` string: Unique identifier - `name` string: Name of the modifier group - `alternateName` string - `minRequired` integer: The minimum amount of modifiers from this group that must be applied to associated lineItems when using Register - `maxAllowed` integer: The maximum amount of modifiers from this group that can be applied to associated lineItems when using Register - `showByDefault` boolean: Whether employees will be automatically prompted to add modifiers from this category when using Register - `modifiers` object[] - `id` string: Unique identifier - `name` string: Name of the modifier - `alternateName` string: Alternate name of the modifier - `available` boolean: True if this modifier is available across all channels - `price` integer: Additional cost when used - `modifierGroup` object - `id` string: Unique identifier. - `modifierIds` string: An ordered, comma-separated list of modifier ids in this group. (READ ONLY) - `items` object[] - `id` string: Unique identifier. - `sortOrder` integer: The ordinal value used to determine where in an ordered list this modifier group should appear relative to others. - `categories` object[]: Categories associated with this item - `id` string: Unique identifier - `name` string, required: The name of the category which will appear in Clover Register App. - `sortOrder` integer: Integer used to determine how this category is sorted against other categories. - `items` object[]: Ordered list of items associated with this category. - `id` string: Unique identifier. - `colorCode` string: Hex code representation of the color assigned to this category and its items, in the form of #fff, #ffffff, or #ffffffff - `deleted` boolean: Whether the category has been deleted. - `modifiedTime` integer: The time this category was last modified - `canonical` object: Reference to canonical category - `id` string: Unique identifier. - `tags` object[]: Tags associated with this item - `id` string: Unique identifier - `name` string, required: Tag name - `showInReporting` boolean: True if tag is a summary label in the reporting app - `items` object[]: Items associated with this tag - `id` string: Unique identifier. - `printers` object[]: Printers associated with this tag - `id` string: Unique identifier. - `canonical` object: Reference to canonical items - `id` string: Unique identifier. - `itemStock` object: Item stock attribute that can be expanded to show stock quantity - `item` object: Reference to an item - `id` string: Unique identifier. - `stockCount` integer: Deprecated, use quantity instead. - `quantity` number: Current count of this item in stock. - `modifiedTime` integer - `modifiedTime` integer - `deletedTime` integer: Timestamp when item was last deleted - `priceWithoutVat` integer: The price without value-added tax (VAT). For non-VAT merchants, this field is ignored. For VAT merchants, this field is the base price of an item. - `colorCode` string: Hex code representation of the color assigned to item in the form of #fff, #ffffff, or #ffffffff --- [API](https://skmtc.dev/clover/apis/platform-api.md) - [All operations](https://skmtc.dev/clover/apis/platform-api/llms.txt) - [OpenAPI document](https://skmtc.dev/clover/apis/platform-api/revisions/95fd9ec401ef?raw)