---
title: Read
slug: netsuite/M95h-read
description: This document provides guidelines and illustrations on how to read Custom Object records using various filters such as "created" and "name". Learn how to construct additional filters and pass them as a single string. Discover an example of using these par
docTags: 
createdAt: 2022-03-29T09:11:55.000Z
---

To read Custom Object records, 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.                                                                                            |
| name            | String        | To filter the records based on the specific name.                                                                                                                                              |
| 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 |

### Example

:::CodeblockTabs
Request

```apex
Map<String, Object> filters = new Map<String, Object>();
filters.put('additionalFilter', EncodingUtil.urlEncode('created>1619875961+and+created<1625146361', '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('customObjectID', '17');
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', 'readCustomObjectRecord');
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=readCustomObjectRecord,
  responseJSON={
    "customObjectRecords": [
      {
        "salesforceID": null,
        "recType": {
          "name": "Prestructured",
          "internalId": "17"
        },
        "owner": {
          "name": "Praveena U",
          "internalId": "4"
        },
        "name": "Check New Prestructured",
        "lastModified": 1621323793,
        "isInactive": false,
        "internalId": "815",
        "customFieldList": {
          "customField": [
            {
              "valueLookup": null,
              "value_array": null,
              "value": "true",
              "scriptId": "custrecord3",
              "label": null,
              "isParent": null,
              "isMandatory": null,
              "isFormula": null,
              "internalId": "212",
              "fieldType": null,
              "displayType": null,
              "description": null,
              "defaultValue": null,
              "defaultChecked": null,
              "accessLevel": null
            },
            {
              "valueLookup": null,
              "value_array": null,
              "value": "navaneeth@dhruvsoft.com",
              "scriptId": "custrecord19",
              "label": null,
              "isParent": null,
              "isMandatory": null,
              "isFormula": null,
              "internalId": "239",
              "fieldType": null,
              "displayType": null,
              "description": null,
              "defaultValue": null,
              "defaultChecked": null,
              "accessLevel": null
            }
          ]
        },
        "created": 1621323793
      }
    ],
    "customParamters": {
      "where": {
        "value": null,
        "keyValueMap": {
          "additionalFilter": "created%3E1619875961%2Band%2Bcreated%3C1625146361"
        }
      }
    },
    "currentPageRecords": 1,
    "totalRecords": 1,
    "totalPages": 1,
    "searchId": "WEBSERVICES_5333445_SB1_0413202320631375201300124324_2de9e11",
    "pageIndex": 1,
    "errors": [
      
    ],
    "status": "200"
  },
  timestamp=1681395350694,
  validRequest=true,
  version=1.0
}
```
:::