> For the complete documentation index, see [llms.txt](https://kb.logicerp.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://kb.logicerp.com/logic-erp-learning-hub-tutorials-and-best-practices/api-documentation/masters/pull/get-item-master.md).

# Get Item Master

Returns Logic ERP's **item master**: one record per **item code** (each size or pack of an item), with its names, shade, company, item groups, rates, conversion factors, HSN code, stock levels, dimensions, barcodes, images and custom fields. Use it to load the full item list into your system once, and then to pick up items **created or changed** in a period, or to fetch particular items by code.

### **Endpoint**

| Name          | Detail                                  |
| ------------- | --------------------------------------- |
| Address       | `https://your-server/api/GetItemMaster` |
| Method        | `POST`                                  |
| Authorization | Basic Auth                              |

The response and the common request fields are explained in [How Every API Call Works](https://kb.logicerp.com/logic-erp-learning-hub-tutorials-and-best-practices/api-documentation/how-every-api-call-works.md). This endpoint **differs** from that page in several ways – read the rules below: the period is the item's created / modified date, `Doc_Codes` can be item codes or barcodes, there are no date checks, and an empty request returns **every item**.

### **Request fields**

| Field              | Type                | Required | Default | Meaning                                                                                                                                                                                                                                                                                                                                                |
| ------------------ | ------------------- | -------- | ------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| `GlobalModifyCode` | number              | No       | `0`     | Change-log bookmark. `0` = do not use the change log. A number above `0` = the items added or changed after that bookmark, up to **100 change-log lines** per call; store `LastGlobalModifyCode` and send it next time. `-1` = the same, with Logic ERP keeping the bookmark for you. An item changed several times in one batch is returned once.     |
| `DateFrom`         | date (`yyyy-MM-dd`) | No       | empty   | Start of a period. Items **created or modified** on or between `DateFrom` and `DateTo` are returned. Used only when **both** dates are valid dates.                                                                                                                                                                                                    |
| `DateTo`           | date (`yyyy-MM-dd`) | No       | empty   | End of the period (inclusive).                                                                                                                                                                                                                                                                                                                         |
| `Doc_Codes`        | text                | No       | `""`    | Particular items, separated by commas with no spaces, for example `"435,436"`. What the values mean depends on the **Get Items By** setting of your API site: Logic ERP's internal item code (`ItemDetailCode`, the default), the item's user code (`UserCode`), or its additional item code / barcode (`AddlItemCode`). Send `""` rather than `null`. |
| `responseType`     | text                | No       | `""`    | `"N"` returns items **grouped** (item name without shade → shades → sizes) instead of one flat record per item code. Only works when your API site's response layout is left at **Default**; if your site has a layout chosen, that layout is always used and this field is ignored.                                                                   |
| `DisplayError`     | text                | No       | `"0"`   | `"1"` adds technical detail to `Message`, for your support team.                                                                                                                                                                                                                                                                                       |

`Branch_Codes_From` and `Doc_Num_Like` are **not used** by this endpoint – the item master is the same for every branch.

### **Rules Logic ERP applies**

* **Which filter wins.** Logic ERP reads the request in this order and uses the first that applies:
  1. `GlobalModifyCode` above `0`, or `-1` with `Doc_Codes` empty → the change log (any `Doc_Codes` you sent is replaced).
  2. Both `DateFrom` and `DateTo` are valid dates, and no bookmark was used in step 1 → the period, by the item's **created or modified date**. `Doc_Codes` is ignored. If you send a bookmark **and** dates, the bookmark wins and the dates are ignored.
  3. `Doc_Codes` is filled → those items only.
  4. Nothing of the above → **every item** in the item master, in one response.
* **No date checks.** Unlike most Pull endpoints, a missing, empty or invalid date gives **no error message**: the period is simply not applied. `DateFrom` with `"DateTo": null` therefore returns the **whole item master**. Always send both dates, as `yyyy-MM-dd`.
* **No batch limit** for a period, a `Doc_Codes` list or the full list – everything that matches comes back in one response.
* **Large requests.** One day of changes can be several thousand items (tens of MB), and the full item master is far bigger. Ask for **short periods** (one day, or less if you change many items at once) or for particular items with `Doc_Codes`, and set a generous timeout on your side.
* **No fixed order.** Records are not sorted; do not rely on their order.
* A period request, a `Doc_Codes` request and the full list all return `LastGlobalModifyCode` as `0`.
* **Only approved items** are returned. Items still awaiting approval are left out.
* **Inactive items are included.** Check the six `InActive_For_…` flags to see what an item is blocked for.
* **One record per item code.** An item made in several sizes or packs gives one record per size / pack; the item and shade details repeat on each.
* **Filters set on your API site** are always applied on top of your request: your support team can limit the item master to chosen **item groups**, **companies** and **item types**.
* **Fields can be switched off.** Your API site can be set up to return only some fields; fields not on its list are left out of every record.
* **Barcodes:** `AddlItemCode` holds the main additional code; `ListEANCode` lists every barcode stored for the item code, usually including `AddlItemCode` itself.
* **Empty values:** an item group level that is not used comes back as `""`. An item with no company comes back with `Comp_Name` and `Comp_Short_Name` as `"(NIL)"`. Some text fields (`Remarks_1`, `Remarks_2`, `Extra_1`…`3`) can come back as a single space `" "` when blank – trim them.
* **Dates** in the response are text in the server's short date format, day first and without time – for example `31/01/2026` or `31/01/26`. Parse both forms.

### **Example request**

All items created or modified on 29 September 2026 (keep periods short – see the rules above):

```json
{
  "GlobalModifyCode": 0,
  "DateFrom": "2026-09-29",
  "DateTo": "2026-09-29",
  "Doc_Codes": ""
}
```

Two items by their internal item code:

```json
{
  "GlobalModifyCode": 0,
  "Doc_Codes": "435,436"
}
```

### **Test it**

Send a request to the Logic ERP **sandbox** (a test company) from this page: open the block below, enter the sandbox user name and password (ask your Logic ERP support team), change the request if you like, and press **Test it**. The example asks for one item by its internal number, which answers in seconds; a period of several days gives a much larger answer. Do not send `"GlobalModifyCode": -1` here – it changes what the sandbox has marked as already sent.

## Get Item Master

> Returns Logic ERP's item master: one record per item code (each size or pack of an item), with its names, shade, company, item groups, rates, conversion factors, HSN code, stock levels, dimensions, barcodes, images and custom fields. Use it to load the full item list into your system once, and then to pick up items created or changed in a period, or to fetch particular items by code.

```json
{"openapi":"3.0.3","info":{"title":"Logic ERP API","version":"1.0"},"tags":[{"name":"Masters - Pull"}],"servers":[{"url":"https://demo.logicerp.com/api","description":"Logic ERP sandbox (test company)"}],"security":[{"basicAuth":[]}],"components":{"securitySchemes":{"basicAuth":{"type":"http","scheme":"basic","description":"The user name and password of your API site."}}},"paths":{"/GetItemMaster":{"post":{"tags":["Masters - Pull"],"operationId":"GetItemMaster","summary":"Get Item Master","description":"Returns Logic ERP's item master: one record per item code (each size or pack of an item), with its names, shade, company, item groups, rates, conversion factors, HSN code, stock levels, dimensions, barcodes, images and custom fields. Use it to load the full item list into your system once, and then to pick up items created or changed in a period, or to fetch particular items by code.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"GlobalModifyCode":{"type":"integer","description":"Change-log bookmark. `0` = do not use the change log. A number above `0` = the items added or changed after that bookmark, up to 100 change-log lines per call; store `LastGlobalModifyCode` and send it next time. `-1` = the same, with Logic ERP keeping the bookmark for you. An item changed several times in one batch is returned once."},"DateFrom":{"type":"string","nullable":true,"description":"Start of a period. Items created or modified on or between `DateFrom` and `DateTo` are returned. Used only when both dates are valid dates."},"DateTo":{"type":"string","nullable":true,"description":"End of the period (inclusive)."},"Doc_Codes":{"type":"string","description":"Particular items, separated by commas with no spaces, for example `\"435,436\"`. What the values mean depends on the Get Items By setting of your API site: Logic ERP's internal item code (`ItemDetailCode`, the default), the item's user code (`UserCode`), or its additional item code / barcode (`AddlItemCode`). Send `\"\"` rather than `null`."},"responseType":{"type":"string","description":"`\"N\"` returns items grouped (item name without shade → shades → sizes) instead of one flat record per item code. Only works when your API site's response layout is left at Default; if your site has a layout chosen, that layout is always used and this field is ignored."},"DisplayError":{"type":"string","description":"`\"1\"` adds technical detail to `Message`, for your support team."}}}}}},"responses":{"200":{"description":"Always HTTP 200. Check Status, Message and GetData.","content":{"application/json":{"schema":{"type":"object","properties":{"GetData":{"type":"array","items":{"type":"object","properties":{"ItemNameWOShade":{"type":"string","description":"Item name without the shade."},"ItemNameWithShade":{"type":"string","description":"Item name including the shade, as shown in Logic ERP."},"Addl_Item_Name":{"type":"string","description":"Additional item name."},"Item_Description":{"type":"string","description":"Main item description."},"Comp_Name":{"type":"string","description":"Company (brand) name. `\"(NIL)\"` when the item has no company."},"Comp_Short_Name":{"type":"string","description":"Company short name. `\"(NIL)\"` when the item has no company."},"Raw_Or_Finish":{"type":"string","description":"Whether the item is a raw material or a finished item, as recorded on the item – for example `FI` / `FIN` for finished, `RA` / `RAW` for raw."},"Shade_Name":{"type":"string","description":"Shade (colour) name. Empty when the item has no shade."},"Shade_Short_Name":{"type":"string","description":"Shade short name."},"ItemDetailCode":{"type":"integer","description":"Logic ERP's internal code of this item code (size / pack). Unique per record."},"UserCode":{"type":"string","description":"The item code users see and type in Logic ERP."},"AddlItemCode":{"type":"string","description":"Additional item code, usually the EAN barcode."},"PackCode":{"type":"integer","description":"Logic ERP's internal code of the pack / size."},"PackName":{"type":"string","description":"Pack or size name, for example `6 (39)`."},"PackGroupName_1":{"type":"string","nullable":true,"description":"Pack group the size belongs to. `null` when none."},"PackGroupName_2":{"type":"string","nullable":true,"description":"Parent group of that pack group. `null` or `\"\"` when none."},"Packing":{"type":"string","description":"Packing unit, for example `PAIR`, `PCS`."},"CF_1":{"type":"number","description":"Conversion factors 1–3: how many base units make one of the alternate unit named in the matching `CF_Desc_…`. `1` when not used (the matching `CF_Desc_…` is then empty)."},"CF_2":{"type":"number","description":"Conversion factors 1–3: how many base units make one of the alternate unit named in the matching `CF_Desc_…`. `1` when not used (the matching `CF_Desc_…` is then empty)."},"CF_3":{"type":"number","description":"Conversion factors 1–3: how many base units make one of the alternate unit named in the matching `CF_Desc_…`. `1` when not used (the matching `CF_Desc_…` is then empty)."},"CF_Desc_1":{"type":"string","description":"Name of the alternate unit for each conversion factor, for example `BOX`."},"CF_Desc_2":{"type":"string","description":"Name of the alternate unit for each conversion factor, for example `BOX`."},"CF_Desc_3":{"type":"string","description":"Name of the alternate unit for each conversion factor, for example `BOX`."},"BasicRate":{"type":"number","description":"Basic rate of the item."},"PurRate":{"type":"number","description":"Purchase rate."},"SaleRate":{"type":"number","description":"Sale rate."},"MRP":{"type":"number","description":"Maximum retail price (₹)."},"Sp_Rate1":{"type":"number","description":"Special rates 1–5, as named in your Logic ERP setup."},"Sp_Rate2":{"type":"number","description":"Special rates 1–5, as named in your Logic ERP setup."},"Sp_Rate3":{"type":"number","description":"Special rates 1–5, as named in your Logic ERP setup."},"Sp_Rate4":{"type":"number","description":"Special rates 1–5, as named in your Logic ERP setup."},"Sp_Rate5":{"type":"number","description":"Special rates 1–5, as named in your Logic ERP setup."},"Group_Name1":{"type":"string","description":"Item group at each of the 30 group levels, as configured in your Logic ERP – what each level means depends on your company's setup. `\"\"` when the level is not used."},"Group_Name2":{"type":"string","description":"Item group at each of the 30 group levels, as configured in your Logic ERP – what each level means depends on your company's setup. `\"\"` when the level is not used."},"Group_Name3":{"type":"string","description":"Item group at each of the 30 group levels, as configured in your Logic ERP – what each level means depends on your company's setup. `\"\"` when the level is not used."},"Group_Name4":{"type":"string","description":"Item group at each of the 30 group levels, as configured in your Logic ERP – what each level means depends on your company's setup. `\"\"` when the level is not used."},"Group_Name5":{"type":"string","description":"Item group at each of the 30 group levels, as configured in your Logic ERP – what each level means depends on your company's setup. `\"\"` when the level is not used."},"Group_Name6":{"type":"string","description":"Item group at each of the 30 group levels, as configured in your Logic ERP – what each level means depends on your company's setup. `\"\"` when the level is not used."},"Group_Name7":{"type":"string","description":"Item group at each of the 30 group levels, as configured in your Logic ERP – what each level means depends on your company's setup. `\"\"` when the level is not used."},"Group_Name8":{"type":"string","description":"Item group at each of the 30 group levels, as configured in your Logic ERP – what each level means depends on your company's setup. `\"\"` when the level is not used."},"Group_Name9":{"type":"string","description":"Item group at each of the 30 group levels, as configured in your Logic ERP – what each level means depends on your company's setup. `\"\"` when the level is not used."},"Group_Name10":{"type":"string","description":"Item group at each of the 30 group levels, as configured in your Logic ERP – what each level means depends on your company's setup. `\"\"` when the level is not used."},"Group_Name11":{"type":"string","description":"Item group at each of the 30 group levels, as configured in your Logic ERP – what each level means depends on your company's setup. `\"\"` when the level is not used."},"Group_Name12":{"type":"string","description":"Item group at each of the 30 group levels, as configured in your Logic ERP – what each level means depends on your company's setup. `\"\"` when the level is not used."},"Group_Name13":{"type":"string","description":"Item group at each of the 30 group levels, as configured in your Logic ERP – what each level means depends on your company's setup. `\"\"` when the level is not used."},"Group_Name14":{"type":"string","description":"Item group at each of the 30 group levels, as configured in your Logic ERP – what each level means depends on your company's setup. `\"\"` when the level is not used."},"Group_Name15":{"type":"string","description":"Item group at each of the 30 group levels, as configured in your Logic ERP – what each level means depends on your company's setup. `\"\"` when the level is not used."},"Group_Name16":{"type":"string","description":"Item group at each of the 30 group levels, as configured in your Logic ERP – what each level means depends on your company's setup. `\"\"` when the level is not used."},"Group_Name17":{"type":"string","description":"Item group at each of the 30 group levels, as configured in your Logic ERP – what each level means depends on your company's setup. `\"\"` when the level is not used."},"Group_Name18":{"type":"string","description":"Item group at each of the 30 group levels, as configured in your Logic ERP – what each level means depends on your company's setup. `\"\"` when the level is not used."},"Group_Name19":{"type":"string","description":"Item group at each of the 30 group levels, as configured in your Logic ERP – what each level means depends on your company's setup. `\"\"` when the level is not used."},"Group_Name20":{"type":"string","description":"Item group at each of the 30 group levels, as configured in your Logic ERP – what each level means depends on your company's setup. `\"\"` when the level is not used."},"Group_Name21":{"type":"string","description":"Item group at each of the 30 group levels, as configured in your Logic ERP – what each level means depends on your company's setup. `\"\"` when the level is not used."},"Group_Name22":{"type":"string","description":"Item group at each of the 30 group levels, as configured in your Logic ERP – what each level means depends on your company's setup. `\"\"` when the level is not used."},"Group_Name23":{"type":"string","description":"Item group at each of the 30 group levels, as configured in your Logic ERP – what each level means depends on your company's setup. `\"\"` when the level is not used."},"Group_Name24":{"type":"string","description":"Item group at each of the 30 group levels, as configured in your Logic ERP – what each level means depends on your company's setup. `\"\"` when the level is not used."},"Group_Name25":{"type":"string","description":"Item group at each of the 30 group levels, as configured in your Logic ERP – what each level means depends on your company's setup. `\"\"` when the level is not used."},"Group_Name26":{"type":"string","description":"Item group at each of the 30 group levels, as configured in your Logic ERP – what each level means depends on your company's setup. `\"\"` when the level is not used."},"Group_Name27":{"type":"string","description":"Item group at each of the 30 group levels, as configured in your Logic ERP – what each level means depends on your company's setup. `\"\"` when the level is not used."},"Group_Name28":{"type":"string","description":"Item group at each of the 30 group levels, as configured in your Logic ERP – what each level means depends on your company's setup. `\"\"` when the level is not used."},"Group_Name29":{"type":"string","description":"Item group at each of the 30 group levels, as configured in your Logic ERP – what each level means depends on your company's setup. `\"\"` when the level is not used."},"Group_Name30":{"type":"string","description":"Item group at each of the 30 group levels, as configured in your Logic ERP – what each level means depends on your company's setup. `\"\"` when the level is not used."},"Group_Short_Name1":{"type":"string","description":"Short name of the item group at each level."},"Group_Short_Name2":{"type":"string","description":"Short name of the item group at each level."},"Group_Short_Name3":{"type":"string","description":"Short name of the item group at each level."},"Group_Short_Name4":{"type":"string","description":"Short name of the item group at each level."},"Group_Short_Name5":{"type":"string","description":"Short name of the item group at each level."},"Group_Short_Name6":{"type":"string","description":"Short name of the item group at each level."},"Group_Short_Name7":{"type":"string","description":"Short name of the item group at each level."},"Group_Short_Name8":{"type":"string","description":"Short name of the item group at each level."},"Group_Short_Name9":{"type":"string","description":"Short name of the item group at each level."},"Group_Short_Name10":{"type":"string","description":"Short name of the item group at each level."},"Group_Short_Name11":{"type":"string","description":"Short name of the item group at each level."},"Group_Short_Name12":{"type":"string","description":"Short name of the item group at each level."},"Group_Short_Name13":{"type":"string","description":"Short name of the item group at each level."},"Group_Short_Name14":{"type":"string","description":"Short name of the item group at each level."},"Group_Short_Name15":{"type":"string","description":"Short name of the item group at each level."},"Group_Short_Name16":{"type":"string","description":"Short name of the item group at each level."},"Group_Short_Name17":{"type":"string","description":"Short name of the item group at each level."},"Group_Short_Name18":{"type":"string","description":"Short name of the item group at each level."},"Group_Short_Name19":{"type":"string","description":"Short name of the item group at each level."},"Group_Short_Name20":{"type":"string","description":"Short name of the item group at each level."},"Group_Short_Name21":{"type":"string","description":"Short name of the item group at each level."},"Group_Short_Name22":{"type":"string","description":"Short name of the item group at each level."},"Group_Short_Name23":{"type":"string","description":"Short name of the item group at each level."},"Group_Short_Name24":{"type":"string","description":"Short name of the item group at each level."},"Group_Short_Name25":{"type":"string","description":"Short name of the item group at each level."},"Group_Short_Name26":{"type":"string","description":"Short name of the item group at each level."},"Group_Short_Name27":{"type":"string","description":"Short name of the item group at each level."},"Group_Short_Name28":{"type":"string","description":"Short name of the item group at each level."},"Group_Short_Name29":{"type":"string","description":"Short name of the item group at each level."},"Group_Short_Name30":{"type":"string","description":"Short name of the item group at each level."},"HSN_Code":{"type":"string","description":"HSN code of the item. `\"\"` when not set."},"Days_To_Expire":{"type":"integer","description":"Shelf life in days. `0` when not used."},"Mfg_Name":{"type":"string","description":"Manufacturer name."},"Flag":{"type":"string","description":"Last change recorded for the item: `N` = new, `M` = modified, `D` = deleted. Empty when no change is recorded."},"CreateDate":{"type":"string","description":"Date the item code was created, day first, for example `31/01/2026` or `31/01/26`. `\"\"` when not recorded."},"ModifyDate":{"type":"string","description":"Date the item code was last modified, same form. `\"\"` when not recorded."},"Item_Description_2":{"type":"string","description":"Second item description. `null` when the item has no descriptions recorded."},"Item_Description_3":{"type":"string","description":"Third item description. `null` when the item has no descriptions recorded."},"Remarks_1":{"type":"string","description":"Remarks entered on the item. Can be `\" \"` when blank."},"Remarks_2":{"type":"string","description":"Remarks entered on the item. Can be `\" \"` when blank."},"InActive_For_SL":{"type":"boolean","description":"`true` when the item is blocked for sale bills."},"InActive_For_PU":{"type":"boolean","description":"`true` when blocked for purchases."},"InActive_For_SR":{"type":"boolean","description":"`true` when blocked for sale returns."},"InActive_For_PR":{"type":"boolean","description":"`true` when blocked for purchase returns."},"InActive_For_PO":{"type":"boolean","description":"`true` when blocked for purchase orders."},"InActive_For_SO":{"type":"boolean","description":"`true` when blocked for sale orders."},"Min_Level":{"type":"number","description":"Minimum stock level."},"RO_Level":{"type":"number","description":"Re-order level."},"Max_Level":{"type":"number","description":"Maximum stock level."},"Weight":{"type":"number","description":"Weight of one pack."},"Weight_In":{"type":"string","description":"Unit of `Weight`, as entered on the item. `\"(NIL)\"` when not set."},"Length":{"type":"number","description":"Pack dimensions."},"Length_In":{"type":"string","description":"Unit of each dimension: `MM`, `CM`, `METER` or `FT` (`Breadth_In` can also be `INCH`). `null` when not set."},"Breadth":{"type":"number","description":"Pack dimensions."},"Breadth_In":{"type":"string","description":"Unit of each dimension: `MM`, `CM`, `METER` or `FT` (`Breadth_In` can also be `INCH`). `null` when not set."},"Height":{"type":"number","description":"Pack dimensions."},"Height_In":{"type":"string","description":"Unit of each dimension: `MM`, `CM`, `METER` or `FT` (`Breadth_In` can also be `INCH`). `null` when not set."},"Thickness":{"type":"number","description":"Pack dimensions."},"Thickness_In":{"type":"string","nullable":true,"description":"Unit of each dimension: `MM`, `CM`, `METER` or `FT` (`Breadth_In` can also be `INCH`). `null` when not set."},"Extra_1":{"type":"string","description":"Extra item parameters 1–3, as named in your Logic ERP setup. Can be `\" \"` when blank."},"Extra_2":{"type":"string","description":"Extra item parameters 1–3, as named in your Logic ERP setup. Can be `\" \"` when blank."},"Extra_3":{"type":"string","description":"Extra item parameters 1–3, as named in your Logic ERP setup. Can be `\" \"` when blank."},"ItemNameCode":{"type":"integer","description":"Internal number – ignore."},"ItemHDCode":{"type":"integer","description":"Internal number – ignore."},"ColorCode":{"type":"integer","description":"Internal number – ignore."},"ListImages":{"type":"array","items":{"type":"object"},"description":"Web links of the item's images, in display order. Only images that have a web link stored are listed. Images belong to the item-with-shade, so every size of it shows the same list. These can differ from the addresses given by Get Item Images."},"ListEANCode":{"type":"array","items":{"type":"string"},"description":"Every barcode stored for this item code, usually including `AddlItemCode` itself."},"ListCustomFields":{"type":"array","items":{"type":"object","properties":{"FieldName":{"type":"string","description":"Name of the custom field. Every visible custom field is listed, even when the item has no value."},"FieldValue_1":{"type":"string","nullable":true,"description":"Value entered for this item. `null` when none."},"FieldValue_2":{"type":"string","nullable":true,"description":"Second value of the field, where the field has one. `null` when the field has no value for this item; `\"\"` when only the first value is filled."},"FieldCode":{"type":"integer","description":"Internal number – ignore."}}},"description":"Custom fields defined for the item master – see below."}}},"nullable":true,"description":"The records found; null when the call failed or nothing was found - read Message."},"Status":{"type":"boolean","description":"See the Status rules on this page and on How Every API Call Works."},"Message":{"type":"string","description":"Why the call failed, or a note. The reason may be followed by technical detail - read the first line."},"LastGlobalModifyCode":{"type":"integer","description":"The change-log bookmark (see How Every API Call Works)."},"resultSize":{"type":"string","description":"Size of the answer, for example \"2 KB\"."}}}}}},"401":{"description":"No login was sent."}}}}}}
```

### **Response fields**

#### Flat layout (default) – one `GetData` record per item code

| Field                                                  | Type         | Meaning                                                                                                                                                                                                                                            |
| ------------------------------------------------------ | ------------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `ItemNameWOShade`                                      | text         | Item name without the shade.                                                                                                                                                                                                                       |
| `ItemNameWithShade`                                    | text         | Item name including the shade, as shown in Logic ERP.                                                                                                                                                                                              |
| `Addl_Item_Name`                                       | text         | Additional item name.                                                                                                                                                                                                                              |
| `Item_Description`                                     | text         | Main item description.                                                                                                                                                                                                                             |
| `Item_Description_2`                                   | text         | Second item description. `null` when the item has no descriptions recorded.                                                                                                                                                                        |
| `Item_Description_3`                                   | text         | Third item description. `null` when the item has no descriptions recorded.                                                                                                                                                                         |
| `Comp_Name`                                            | text         | Company (brand) name. `"(NIL)"` when the item has no company.                                                                                                                                                                                      |
| `Comp_Short_Name`                                      | text         | Company short name. `"(NIL)"` when the item has no company.                                                                                                                                                                                        |
| `Raw_Or_Finish`                                        | text         | Whether the item is a raw material or a finished item, as recorded on the item – for example `FI` / `FIN` for finished, `RA` / `RAW` for raw.                                                                                                      |
| `Shade_Name`                                           | text         | Shade (colour) name. Empty when the item has no shade.                                                                                                                                                                                             |
| `Shade_Short_Name`                                     | text         | Shade short name.                                                                                                                                                                                                                                  |
| `ItemDetailCode`                                       | number       | Logic ERP's internal code of this item code (size / pack). Unique per record.                                                                                                                                                                      |
| `UserCode`                                             | text         | The item code users see and type in Logic ERP.                                                                                                                                                                                                     |
| `AddlItemCode`                                         | text         | Additional item code, usually the EAN barcode.                                                                                                                                                                                                     |
| `PackCode`                                             | number       | Logic ERP's internal code of the pack / size.                                                                                                                                                                                                      |
| `PackName`                                             | text         | Pack or size name, for example `6 (39)`.                                                                                                                                                                                                           |
| `PackGroupName_1`                                      | text         | Pack group the size belongs to. `null` when none.                                                                                                                                                                                                  |
| `PackGroupName_2`                                      | text         | Parent group of that pack group. `null` or `""` when none.                                                                                                                                                                                         |
| `Packing`                                              | text         | Packing unit, for example `PAIR`, `PCS`.                                                                                                                                                                                                           |
| `CF_1`, `CF_2`, `CF_3`                                 | number       | Conversion factors 1–3: how many base units make one of the alternate unit named in the matching `CF_Desc_…`. `1` when not used (the matching `CF_Desc_…` is then empty).                                                                          |
| `CF_Desc_1`, `CF_Desc_2`, `CF_Desc_3`                  | text         | Name of the alternate unit for each conversion factor, for example `BOX`.                                                                                                                                                                          |
| `BasicRate`                                            | number       | Basic rate of the item.                                                                                                                                                                                                                            |
| `PurRate`                                              | number       | Purchase rate.                                                                                                                                                                                                                                     |
| `SaleRate`                                             | number       | Sale rate.                                                                                                                                                                                                                                         |
| `MRP`                                                  | number       | Maximum retail price (₹).                                                                                                                                                                                                                          |
| `Sp_Rate1` … `Sp_Rate5`                                | number       | Special rates 1–5, as named in your Logic ERP setup.                                                                                                                                                                                               |
| `Group_Name1` … `Group_Name30`                         | text         | Item group at each of the 30 group levels, as configured in your Logic ERP – what each level means depends on your company's setup. `""` when the level is not used.                                                                               |
| `Group_Short_Name1` … `Group_Short_Name30`             | text         | Short name of the item group at each level.                                                                                                                                                                                                        |
| `HSN_Code`                                             | text         | HSN code of the item. `""` when not set.                                                                                                                                                                                                           |
| `Days_To_Expire`                                       | number       | Shelf life in days. `0` when not used.                                                                                                                                                                                                             |
| `Mfg_Name`                                             | text         | Manufacturer name.                                                                                                                                                                                                                                 |
| `Flag`                                                 | text         | Last change recorded for the item: `N` = new, `M` = modified, `D` = deleted. Empty when no change is recorded.                                                                                                                                     |
| `CreateDate`                                           | text         | Date the item code was created, day first, for example `31/01/2026` or `31/01/26`. `""` when not recorded.                                                                                                                                         |
| `ModifyDate`                                           | text         | Date the item code was last modified, same form. `""` when not recorded.                                                                                                                                                                           |
| `Remarks_1`, `Remarks_2`                               | text         | Remarks entered on the item. Can be `" "` when blank.                                                                                                                                                                                              |
| `InActive_For_SL`                                      | true / false | `true` when the item is blocked for sale bills.                                                                                                                                                                                                    |
| `InActive_For_PU`                                      | true / false | `true` when blocked for purchases.                                                                                                                                                                                                                 |
| `InActive_For_SR`                                      | true / false | `true` when blocked for sale returns.                                                                                                                                                                                                              |
| `InActive_For_PR`                                      | true / false | `true` when blocked for purchase returns.                                                                                                                                                                                                          |
| `InActive_For_PO`                                      | true / false | `true` when blocked for purchase orders.                                                                                                                                                                                                           |
| `InActive_For_SO`                                      | true / false | `true` when blocked for sale orders.                                                                                                                                                                                                               |
| `Min_Level`                                            | number       | Minimum stock level.                                                                                                                                                                                                                               |
| `RO_Level`                                             | number       | Re-order level.                                                                                                                                                                                                                                    |
| `Max_Level`                                            | number       | Maximum stock level.                                                                                                                                                                                                                               |
| `Weight`                                               | number       | Weight of one pack.                                                                                                                                                                                                                                |
| `Weight_In`                                            | text         | Unit of `Weight`, as entered on the item. `"(NIL)"` when not set.                                                                                                                                                                                  |
| `Length`, `Breadth`, `Height`, `Thickness`             | number       | Pack dimensions.                                                                                                                                                                                                                                   |
| `Length_In`, `Breadth_In`, `Height_In`, `Thickness_In` | text         | Unit of each dimension: `MM`, `CM`, `METER` or `FT` (`Breadth_In` can also be `INCH`). `null` when not set.                                                                                                                                        |
| `Extra_1`, `Extra_2`, `Extra_3`                        | text         | Extra item parameters 1–3, as named in your Logic ERP setup. Can be `" "` when blank.                                                                                                                                                              |
| `ItemNameCode`                                         | number       | Internal number – ignore.                                                                                                                                                                                                                          |
| `ItemHDCode`                                           | number       | Internal number – ignore.                                                                                                                                                                                                                          |
| `ColorCode`                                            | number       | Internal number – ignore.                                                                                                                                                                                                                          |
| `ListImages`                                           | list of text | Web links of the item's images, in display order. Only images that have a web link stored are listed. Images belong to the item-with-shade, so every size of it shows the same list. These can differ from the addresses given by Get Item Images. |
| `ListEANCode`                                          | list of text | Every barcode stored for this item code, usually including `AddlItemCode` itself.                                                                                                                                                                  |
| `ListCustomFields`                                     | list         | Custom fields defined for the item master – see below.                                                                                                                                                                                             |

> **Known issue – units in inches.** Only `Breadth_In` shows `INCH`. For an item measured in inches, `Length_In`, `Height_In` and `Thickness_In` come back as `null`. If `Breadth_In` is `INCH`, assume the other dimensions are in inches too.

#### `ListCustomFields`

| Field          | Type   | Meaning                                                                                                                                         |
| -------------- | ------ | ----------------------------------------------------------------------------------------------------------------------------------------------- |
| `FieldName`    | text   | Name of the custom field. Every visible custom field is listed, even when the item has no value.                                                |
| `FieldValue_1` | text   | Value entered for this item. `null` when none.                                                                                                  |
| `FieldValue_2` | text   | Second value of the field, where the field has one. `null` when the field has no value for this item; `""` when only the first value is filled. |
| `FieldCode`    | number | Internal number – ignore.                                                                                                                       |

#### Grouped layout (`responseType` `"N"`, or chosen on your API site)

Each `GetData` record is one **item**, with its shades and sizes nested inside. With `responseType` `"N"` the top level is the item name without shade (all shades inside). A layout chosen on your API site can instead make the top level the item name with shade (one shade inside).

| Field        | Type   | Meaning                                                 |
| ------------ | ------ | ------------------------------------------------------- |
| `ItemCode`   | number | Logic ERP's internal code of the item at the top level. |
| `ItemName`   | text   | Item name at the top level.                             |
| `ListShades` | list   | The item's shades – see below.                          |

**`ListShades`**: `ItemNameWithShadeCode` (number, Logic ERP's internal code of the item-with-shade), `ItemNameWithShade`, `Addl_Item_Name`, `Item_Description`, `Item_Description_2`, `Item_Description_3`, `Comp_Name`, `Comp_Short_Name`, `Raw_Or_Finish`, `Shade_Name`, `Shade_Short_Name`, `Group_Name1`…`30`, `Group_Short_Name1`…`30`, `HSN_Code`, the six `InActive_For_…` flags, `ListImages`, and `ListSize` – same meanings as in the flat layout.

**`ListSize`**: `ItemDetailCode`, `UserCode`, `AddlItemCode`, `PackCode`, `PackName`, `PackGroupName_1`, `PackGroupName_2`, `Packing`, `CF_1`…`3`, `CF_Desc_1`…`3`, `BasicRate`, `PurRate`, `SaleRate`, `MRP`, `Sp_Rate1`…`5`, `Days_To_Expire`, `Mfg_Name`, `CreateDate`, `ModifyDate`, `Remarks_1`, `Remarks_2`, `Min_Level`, `RO_Level`, `Max_Level`, `Weight`, `Weight_In`, the four dimensions and their units, `Extra_1`…`3`, `ListEANCode` – same meanings as in the flat layout.

> **In the grouped layout these fields are present but not filled:** the six `InActive_For_…` flags are always `false`; `Days_To_Expire` and `Weight` are always `0`; `Mfg_Name`, `Packing`, `Weight_In` and `PackGroupName_2` are always `null`. `Flag` and `ListCustomFields` are not returned. Use the flat layout if you need them.

### **Example response**

Flat layout, one record. `Group_Name5`…`30` and `Group_Short_Name5`…`30` are left out of this example to keep it short; the real response always has all 30.

```json
{
  "GetData": [
    {
      "ItemNameWOShade": "KR2041",
      "ItemNameWithShade": "KR2041 BLK",
      "Addl_Item_Name": "KURTA COTTON",
      "Item_Description": "kalpana-women-cotton-kurta",
      "Comp_Name": "KALPANA FASHIONS",
      "Comp_Short_Name": "KF",
      "Raw_Or_Finish": "FI",
      "Shade_Name": "BLACK",
      "Shade_Short_Name": "BLK",
      "ItemDetailCode": 18452,
      "UserCode": "10452",
      "AddlItemCode": "8901234567892",
      "PackCode": 14,
      "PackName": "M",
      "PackGroupName_1": "APPAREL SIZES",
      "PackGroupName_2": null,
      "Packing": "PCS",
      "CF_1": 1.0,
      "CF_2": 1.0,
      "CF_3": 1.0,
      "CF_Desc_1": "",
      "CF_Desc_2": "",
      "CF_Desc_3": "",
      "BasicRate": 410.0,
      "PurRate": 410.0,
      "SaleRate": 799.0,
      "MRP": 999.0,
      "Sp_Rate1": 0.0,
      "Sp_Rate2": 0.0,
      "Sp_Rate3": 0.0,
      "Sp_Rate4": 0.0,
      "Sp_Rate5": 0.0,
      "Group_Name1": "KURTA",
      "Group_Name2": "ETHNIC",
      "Group_Name3": "LADIES",
      "Group_Name4": "APPAREL",
      "Group_Short_Name1": "KUR",
      "Group_Short_Name2": "ETH",
      "Group_Short_Name3": "LD",
      "Group_Short_Name4": "APP",
      "HSN_Code": "62044290",
      "Days_To_Expire": 0,
      "Mfg_Name": "",
      "Flag": "M",
      "CreateDate": "02/09/2026",
      "ModifyDate": "29/09/2026",
      "Item_Description_2": "",
      "Item_Description_3": "",
      "Remarks_1": "",
      "Remarks_2": "",
      "InActive_For_SL": false,
      "InActive_For_PU": false,
      "InActive_For_SR": false,
      "InActive_For_PR": false,
      "InActive_For_PO": false,
      "InActive_For_SO": false,
      "Min_Level": 2.0,
      "RO_Level": 5.0,
      "Max_Level": 20.0,
      "Weight": 0.25,
      "Weight_In": "KG",
      "Length": 0.0,
      "Length_In": null,
      "Breadth": 0.0,
      "Breadth_In": null,
      "Height": 0.0,
      "Height_In": null,
      "Thickness": 0.0,
      "Thickness_In": null,
      "Extra_1": "",
      "Extra_2": "",
      "Extra_3": "",
      "ItemNameCode": 2207,
      "ItemHDCode": 6118,
      "ColorCode": 12,
      "ListImages": [
        "https://images.example.in/kr2041-blk-1.jpg"
      ],
      "ListEANCode": [
        "8901234567908"
      ],
      "ListCustomFields": [
        { "FieldName": "FABRIC", "FieldValue_1": "COTTON", "FieldValue_2": "", "FieldCode": 3 }
      ]
    }
  ],
  "Status": true,
  "Message": "",
  "LastGlobalModifyCode": 0,
  "resultSize": "4 KB"
}
```

### **Messages you may see**

| Message                                                                                                            | Meaning                                                                                                  | What to do                                                                              |
| ------------------------------------------------------------------------------------------------------------------ | -------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------- |
| `Item Not Found...` (with `Status: true`)                                                                          | No item matched the request. `GetData` is `null`.                                                        | Nothing new – call again later. If you expected items, check the dates and `Doc_Codes`. |
| `Request cannot be processed. API Template is marked as In-Active in the configuration.` (with `Status: false`)    | The item master endpoint is switched off for your API site.                                              | Ask your Logic ERP support team.                                                        |
| A message containing `API settings for this route are not configured for the API template.` (with `Status: false`) | The item master settings of your API site have not been saved.                                           | Ask your Logic ERP support team to save the Item Master settings for your API site.     |
| `Invalid code in list: '…'. Only numeric codes are allowed.` (with `Status: false`), where `…` is a value you sent | A value in `Doc_Codes` is not a number while your API site gets items by Logic ERP's internal item code. | Send numbers only, or ask support which code your site expects.                         |
| No answer before your timeout                                                                                      | The request matched too many items (a long period, or no filter at all).                                 | Ask for a shorter period or for particular items with `Doc_Codes`.                      |

Error messages with `Status: false` give the reason as plain text; with `"DisplayError": "1"` they carry the full technical detail and the query used – read the first line and look for the reason quoted above.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://kb.logicerp.com/logic-erp-learning-hub-tutorials-and-best-practices/api-documentation/masters/pull/get-item-master.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
