--- title: Read slug: netsuite/i77G-read description: Learn how to read return authorizations using various filters like dateCreated, internalId, lastModifiedDate, subsidiary, additionalFilter, tranDate, and customer. This document includes an example of implementing these parameters in Apex code, creating a docTags: createdAt: 2021-11-01T07:10:27.000Z --- To read Return Authorizations, please use the below parameters. ### Supported “*where*” Filters | **Field Name** | **Data Type** | **Description** | | ---------------- | ------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | dateCreated | Long | This will filter on an exact match (equal). Use the “additionalFilter” option for a range of dates. | | internalId | String | Internal ID of the RMA. Multiple values can be passed in a comma-separated string. | | 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 | | tranDate | Long | Transaction date of the record. Use the “additionalFilter” option for a range of dates. | | customer | String | To filter the records based on the Customer. Multiple IDs can be passed in a comma-separated string Ex: 6,7 | ### Example :::CodeblockTabs Request ```apex Map filters = new Map(); filters.put('subsidiary', '1,2'); filters.put('additionalFilter', EncodingUtil.urlEncode('lastModifiedDate>1628091060+and+lastModifiedDate<1629127860', 'UTF-8')); // Encode additionalFilter after constructing it with +and+ for multi-filters // field filters and additionalFilter for where param Map filterMap = new Map(); filterMap.put('where', new Map{'keyValueMap'=>filters}); Map requestJSONMap = new Map(); requestJSONMap.put('customParameters', filterMap); String reqJSON = JSON.serialize(requestJSONMap); Map reqObj = new Map(); reqObj.put('version', '1.0'); reqObj.put('action', 'readReturnAuthorization'); reqObj.put('requestJSON', reqJSON); // Place a request to Breadwinner Global API Map resp = breadwinner_ns.BreadwinnerNetSuiteAPI.call(reqObj); System.debug(resp); ``` Response ```json { action=readReturnAuthorization, timestamp=1657007708584, validRequest=true, version=1.0, responseJSON={ "currentPageRecords": null, "totalRecords": 2, "totalPages": 1, "searchId": "WEBSERVICES_5333445_SB1_070520228496699151186859035_be248925", "pageIndex": 1, "errors": [ ], "customParamters": { "where": { "value": null, "keyValueMap": { "internalId": "94809,95012" } } }, "status": "200""returnAuthorizations": [ { "tranId": "147", "tranDate": 1623567600, "totalCostEstimate": null, "total": 1.18, "taxTotal": 0.18, "subTotal": 1.0, "subsidiary": { "type": null, "name": "Atlanta", "internalId": "20", "externalId": null }, "status": "Pending Receipt", "source": "Web Services", "salesRep": null, "salesforceID": null, "salesEffectiveDate": 1623567600, "otherRefNum": null, "orderStatus": null, "nullFieldList": null, "memo": "3", "location": null, "lastModifiedDate": 1643036958, "itemList": { "replaceAll": null, "item": [ { "unitsDisplay": null, "taxRate1": "18.0", "taxCode": { "type": null, "name": "VAT_IN:GST 18", "internalId": "36", "externalId": null }, "tax1Amt": 0.18, "shipMethod": null, "shipGroup": null, "serialNumbers": null, "revRecStartDate": null, "revRecSchedule": null, "revRecEndDate": null, "rate": "1.00", "quantityRemaining": null, "quantityReceived": 0.0, "quantityBilled": 0.0, "quantity": 1.0, "price": null, "poNum": null, "orderLine": null, "onHand": null, "location": null, "line": 1, "jobName": null, "itemReceive": null, "itemName": null, "itemIsFulfilled": null, "item": { "type": null, "name": "Touch Pad Pro", "internalId": "570", "externalId": null }, "grossAmt": 1.18, "expectedReceiptDate": null, "description": "linedesc", "department": null, "customFieldList": { "customField": [ { "valueLookup": null, "value": "false", "scriptId": "custcol_checkbox", "internalId": "443", "fieldType": null } ] }, "createPo": null, "costEstimateType": null, "costEstimate": null, "classification": null, "amount": 1.0 } ] }, "internalId": "94809", "externalId": null, "entity": { "type": null, "name": "CUST1010AT Test Account62117", "internalId": "73691", "externalId": null }, "discountTotal": null, "discountRate": null, "discountItem": null, "department": { "type": null, "name": "test", "internalId": "3", "externalId": null }, "customForm": null, "customFieldList": { "customField": [ { "valueLookup": null, "value": " - ", "scriptId": "custbody_breadwinner_pc_internal_id", "internalId": "588", "fieldType": null }, { "valueLookup": null, "value": "false", "scriptId": "custbody_checkbox", "internalId": "272", "fieldType": null }, { "valueLookup": null, "value": "false", "scriptId": "custbody_edoc_gen_trans_pdf", "internalId": "925", "fieldType": null }, { "valueLookup": null, "value": "false", "scriptId": "custbody_ei_ds_txn_identifier", "internalId": "932", "fieldType": null } ] }, "currencyRecord": { "type": null, "name": "SGD", "internalId": "6", "externalId": null }, "currencyName": "SGD", "createdFrom": null, "createdDate": 1643036958, "classification": { "type": null, "name": "Testing", "internalId": "3", "externalId": null } }, { "tranId": "148", "tranDate": 1623567600, "totalCostEstimate": null, "total": 1.18, "taxTotal": 0.18, "subTotal": 1.0, "subsidiary": { "type": null, "name": "Atlanta", "internalId": "20", "externalId": null }, "status": "Pending Receipt", "source": "Web Services", "salesRep": null, "salesforceID": null, "salesEffectiveDate": 1623567600, "otherRefNum": null, "orderStatus": null, "nullFieldList": null, "memo": "3", "location": null, "lastModifiedDate": 1643369750, "itemList": { "replaceAll": null, "item": [ { "unitsDisplay": null, "taxRate1": "18.0", "taxCode": { "type": null, "name": "VAT_IN:GST 18", "internalId": "36", "externalId": null }, "tax1Amt": 0.18, "shipMethod": null, "shipGroup": null, "serialNumbers": null, "revRecStartDate": null, "revRecSchedule": null, "revRecEndDate": null, "rate": "1.00", "quantityRemaining": null, "quantityReceived": 0.0, "quantityBilled": 0.0, "quantity": 1.0, "price": null, "poNum": null, "orderLine": null, "onHand": null, "location": null, "line": 1, "jobName": null, "itemReceive": null, "itemName": null, "itemIsFulfilled": null, "item": { "type": null, "name": "Touch Pad Pro", "internalId": "570", "externalId": null }, "grossAmt": 1.18, "expectedReceiptDate": null, "description": "linedesc", "department": null, "customFieldList": { "customField": [ { "valueLookup": null, "value": "false", "scriptId": "custcol_checkbox", "internalId": "443", "fieldType": null } ] }, "createPo": null, "costEstimateType": null, "costEstimate": null, "classification": null, "amount": 1.0 } ] }, "internalId": "95012", "externalId": null, "entity": { "type": null, "name": "CUST1034AT Test Account65117", "internalId": "74092", "externalId": null }, "discountTotal": null, "discountRate": null, "discountItem": null, "department": { "type": null, "name": "test", "internalId": "3", "externalId": null }, "customForm": null, "customFieldList": { "customField": [ { "valueLookup": null, "value": " - ", "scriptId": "custbody_breadwinner_pc_internal_id", "internalId": "588", "fieldType": null }, { "valueLookup": null, "value": "false", "scriptId": "custbody_checkbox", "internalId": "272", "fieldType": null }, { "valueLookup": null, "value": "false", "scriptId": "custbody_edoc_gen_trans_pdf", "internalId": "925", "fieldType": null }, { "valueLookup": null, "value": "false", "scriptId": "custbody_ei_ds_txn_identifier", "internalId": "932", "fieldType": null } ] }, "currencyRecord": { "type": null, "name": "SGD", "internalId": "6", "externalId": null }, "currencyName": "SGD", "createdFrom": null, "createdDate": 1643369750, "classification": { "type": null, "name": "Testing", "internalId": "3", "externalId": null } } ], }, } ``` :::