Search By List
Given multiple combinations of partNum
and mfrCd
, returns all possible part matches.
Request Parameters
Parameter | Description | Required | Notes |
---|---|---|---|
req | Collection of parts to search for (max = 1000) | yes | |
fmt | JSON (default) or XML | no | |
login | Customer login name | yes | |
apikey | The API Key provided during the registration process | yes | |
useExact | exact match of the part number(s) requested | yes |
|
partNum | part to search on | yes |
|
remoteIp | ip address of the client | yes | |
mfr | filter part results by manufacturer | no | refer to lookup/manufacturer for mfrCd |
callbackfn | allows jsonp functionality | no | use in conjunction with fmt=json |
rows | number of rows to return | no |
|
utm_currency | Converts USD to selected currency. Example values (EUR, CAN) | no |
Payload Construction
The payload is constructed in the standard json format and passed to the parameter req
. Part requests are added to a parts
array and can optionally include a mfr
.
Here is a sample payload that searches for bav99 by NXP, MT47H128M8HQ-3:E by any manufacturer, and TMP275AIDGKT by any manufacturer:
{"request":{"login":"<login>","apikey":"<apikey>","remoteIp":"<ip_address>","useExact":true,"parts":[{"partNum":"bav99","mfr":"NXP"},{"partNum":"MT47H128M8HQ-3:E"},{"partNum":"TMP275AIDGKT"}]}}
Example Request
API Address: http://api.arrow.com GET /itemservice/v4/en/search/list?req={"request":{"login":"<login>","apikey":"<apikey>","remoteIp":"<ip_address>","useExact":true,"parts":[{"partNum":"bav99","mfr":"NXP"},{"partNum":"MT47H128M8HQ-3:E"},{"partNum":"TMP275AIDGKT"}]}}
Example Response
{ "itemserviceresult": { "serviceMetaData": [ { "version": "4.0.0" } ], "transactionArea": [ { "response": { "returnCode": "0", "returnMsg": "", "success": true }, "responseSequence": { "transactionTime": "6.437 ms", "queryTime": "0 ms", "dbTime": "0 ms", "totalItems": 1, "resources": [ ], "qq": 150 } } ], "data": [ { "resources": [ { "type": "search", "uri": "https://www.arrow.com/en/products/search?q=aeplcjcd24" } ], "PartList": [ { "itemId": 29230153, "partNum": "AEP-LCJC-D24", "manufacturer": { "mfrCd": "AERCNSYS", "mfrName": "Aero Conesys" }, "desc": "AEP-LCJC-D24", "packageType": "", "resources": [ { "type": "cloud_part_detail", "uri": "https://www.arrow.com/en/products/aep-lcjc-d24/aero-electric-connector" }, { "type": "api_part_detail", "uri": "http://api.arrow.com/itemservice/v2/en/detail?mfrCd=AERCNSYS&partNum=AEPLCJCD24" }, { "type": "part_detail", "uri": "http://api.arrow.com/itemservice/v2/en/detail?pkey=q0PMZFm3dTO00InClohvmZMZH5AhgzPvPogcj1zB4cI" } ], "EnvData": { "compliance": [ { "displayLabel": "eurohs", "displayValue": "" }, { "displayLabel": "cnrohs", "displayValue": "" } ] }, "InvOrg": { "webSites": [ { "code": "Arrow", "name": "Arrow", "sources": [ { "currency": "USD", "sourceCd": "AEP", "displayName": "AE Petche Co.", "sourceParts": [ { "packSize": 1, "minimumOrderQuantity": 1, "sourcePartId": "000000000000004", "Prices": { "resaleList": [ { "displayPrice": "70.8533", "price": 70.8533, "minQty": 1, "maxQty": 24 }, { "displayPrice": "47.2356", "price": 47.2356, "minQty": 25, "maxQty": 99 }, { "displayPrice": "44.2833", "price": 44.2833, "minQty": 100, "maxQty": 999999999 } ] }, "Availability": [ { "fohQty": 148, "availabilityCd": "INSTK", "availabilityMessage": "In Stock", "pipeline": [ ] } ], "customerSpecificPricing": [ ], "customerSpecificInventory": [ ], "dateCode": "", "resources": [ { "type": "detail", "uri": "https://www.arrow.com/en/products/aep-lcjc-d24/aero-electric-connector" }, { "type": "add_to_cart", "uri": "https://www.arrow.com/en/products/aep-lcjc-d24/aero-electric-connector" } ], "inStock": true, "mfrLeadTime": 0, "tariffFlag": false, "shipsFrom": "United States of America", "shipsIn": "Ships in 10 days ", "arrowLeadTime": "", "isNcnr": false, "isNpi": false, "productCode": "AEPLCJCD24", "containerType": "" } ] } ] }, { "code": "Verical.com", "name": "Verical.com", "sources": [ { "currency": "USD", "sourceCd": "VERICAL", "displayName": "Verical", "sourceParts": [ { "packSize": 1, "minimumOrderQuantity": 1, "sourcePartId": "26296337", "Prices": { "resaleList": [ { "displayPrice": "56.7556", "price": 56.7556, "minQty": 1, "maxQty": 99999999 } ] }, "Availability": [ { "fohQty": 218, "availabilityCd": "INSTK", "availabilityMessage": "In Stock", "pipeline": [ ] } ], "customerSpecificPricing": [ ], "customerSpecificInventory": [ ], "dateCode": "", "resources": [ { "type": "detail", "uri": "https://www.verical.com/pd/aero-conesys-misc-pemco-AEP-LCJC-D24-4085707" }, { "type": "add_to_cart", "uri": "https://www.verical.com/pd/aero-conesys-misc-pemco-AEP-LCJC-D24-4085707" } ], "inStock": true, "mfrLeadTime": 0, "tariffFlag": false, "shipsFrom": "United States of America", "shipsIn": "Ships in 10 days ", "arrowLeadTime": "", "isNcnr": false, "isNpi": false, "productCode": "", "containerType": "" } ] } ] }, { "code": "AE Petche Co.", "name": "AE Petche Co.", "sources": [ { "currency": "USD", "sourceCd": "AEP", "displayName": "AE Petche Co.", "sourceParts": [ { "packSize": 1, "minimumOrderQuantity": 1, "sourcePartId": "000000000000004", "Prices": { "resaleList": [ { "displayPrice": "70.8533", "price": 70.8533, "minQty": 1, "maxQty": 24 }, { "displayPrice": "47.2356", "price": 47.2356, "minQty": 25, "maxQty": 99 }, { "displayPrice": "44.2833", "price": 44.2833, "minQty": 100, "maxQty": 999999999 } ] }, "Availability": [ { "fohQty": 148, "availabilityCd": "INSTK", "availabilityMessage": "In Stock", "pipeline": [ ] } ], "customerSpecificPricing": [ ], "customerSpecificInventory": [ ], "dateCode": "", "resources": [ { "type": "detail", "uri": "https://www.arrow.com/en/products/aep-lcjc-d24/aero-electric-connector" }, { "type": "add_to_cart", "uri": "https://www.arrow.com/en/products/aep-lcjc-d24/aero-electric-connector" } ], "inStock": true, "mfrLeadTime": 0, "tariffFlag": false, "shipsFrom": "United States of America", "shipsIn": "Ships in 10 days ", "arrowLeadTime": "", "isNcnr": false, "isNpi": false, "productCode": "AEPLCJCD24", "containerType": "" } ] } ] } ] }, "hasDatasheet": false, "categoryName": "", "status": "" } ] } ] } }