---
title: Read 
slug: netsuite/HoOA-read
description: Learn how to effectively filter and read items using the Breadwinner Global API. This document outlines the supported filters, including "created" and "lastModifiedDate", and provides detailed instructions on how to utilize them. Discover a helpful code s
docTags: 
createdAt: 2021-11-01T07:07:06.000Z
---

To read Items, please use the below parameters.

### Supported “where” Filters

| **Field Name**   | **Data Type** | **Description**                                                                                                                                                                                |
| ---------------- | ------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| created          | Long          | This will filter on an exact match (equal). Use the “additionalFilter” option for a range of dates.                                                                                            |
| lastModifiedDate | Long          | This will filter on an exact match (equal). Use the “additionalFilter” option for a range of dates.                                                                                            |
| subsidiary       | String        | Internal ID of Subsidiary (Primary). Do Not Use this in additonalFilter. Multiple IDs can be passed in a comma-separated string Ex: 1,2                                                        |
| additonalFilter  | String        | construct the additional filter with a combination of the above fields using ‘+and+’ separator and pass it as a single string. Make sure to wrap the whole string using EncodingUtil.urlEncode |
| active           | String        | To filter the Item records using Active value. Ex: Active=true                                                                                                                                 |

### Example

:::CodeblockTabs
Request

```apex
Map<String, Object> filters = new Map<String, Object>();
filters.put('subsidiary', '1,2');
filters.put('additionalFilter', EncodingUtil.urlEncode('lastModifiedDate>1628091060+and+lastModifiedDate<1656682361', 'UTF-8')); 
// Encode additionalFilter after constructing it with +and+ for multi-filters

// field filters and additionalFilter for where param
Map<String, Object> filterMap = new Map<String, Object>();
filterMap.put('where', new Map<String, Object>{'keyValueMap'=>filters}); 

Map<String, Object> requestJSONMap = new Map<String, Object>();
requestJSONMap.put('customParameters', filterMap);

String reqJSON = JSON.serialize(requestJSONMap);

Map<String, Object> reqObj = new Map<String, Object>();
reqObj.put('version', '1.0');
reqObj.put('action', 'readItem');
reqObj.put('requestJSON', reqJSON);

//  Place a request to Breadwinner Global API
Map<String, Object> resp = breadwinner_ns.BreadwinnerNetSuiteAPI.call(reqObj);
System.debug(resp);
```

Response

```json
{
  action=readItem,
  responseJSON={
    "items": [
      {
        "useMarginalRates": null,
        "unitsType": null,
        "taxSchedule": null,
        "subsidiaryList": {
          "recordRef": [
            {
              "type": null,
              "name": null,
              "internalId": "1",
              "externalId": null
            }
          ]
        },
        "shippingCost": null,
        "salesforceId": null,
        "salesDescription": null,
        "rate": "5.00%",
        "quantityPricingSchedule": null,
        "purchaseDescription": null,
        "pricingMatrix": null,
        "pricingGroup": null,
        "preferredLocation": null,
        "parent": null,
        "overallQuantityPricingType": null,
        "minimumQuantity": null,
        "memberList": null,
        "maximumQuantity": null,
        "matrixType": null,
        "locationsList": null,
        "location": null,
        "lastModifiedDate": 1632479177,
        "itemType": "DiscountItem",
        "itemId": "Corn",
        "isInactive": true,
        "internalId": "10027",
        "incomeAccount": null,
        "includeChildren": false,
        "handlingCost": null,
        "externalId": null,
        "expenseAccount": null,
        "displayName": "Corn",
        "description": null,
        "department": null,
        "customForm": null,
        "customFieldList": null,
        "currencyValue": null,
        "createdDate": 1632406295,
        "cost": null,
        "cogsAccount": null,
        "classification": null,
        "assetAccount": null,
        "account": {
          "type": null,
          "name": "Shipping and Handling",
          "internalId": "108",
          "externalId": null
        }
      }
    ],
    "customParamters": {
      "where": {
        "value": null,
        "keyValueMap": {
          "subsidiary": "1,2",
          "additionalFilter": "lastModifiedDate%3E1628091060%2Band%2BlastModifiedDate%3C1632663161"
        }
      }
    },
    "currentPageRecords": 1,
    "totalRecords": 1,
    "totalPages": 1,
    "searchId": "WEBSERVICES_5333445_SB1_0413202320651007601650254969_2505ec2",
    "pageIndex": 1,
    "errors": [
      
    ],
    "status": "200"
  },
  timestamp=1681397315055,
  validRequest=true,
  version=1.0
}
```
:::