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/v3/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": "3.0.2" } ], "transactionArea": [ { "response": { "returnCode": "0", "returnMsg": "", "success": true }, "responseSequence": { "transactionTime": "440.253 ms", "queryTime": "437.698 ms", "dbTime": "0 ms", "totalItems": 3, "resources": [], "qq": 150 } } ], "data": [ { "partsRequested": 3, "partsFound": 2, "partsNotFound": 0, "partsError": 1, "resultList": [ { "resources": [], "requestedPartNum": "bav99|NXP", "numberFound": 0 }, { "resources": [], "PartList": [ { "itemId": 15632913, "partNum": "MT47H128M8HQ-3:E", "manufacturer": { "mfrCd": "MICRON", "mfrName": "Micron Technology" }, "desc": "DRAM Chip DDR2 SDRAM 1G-Bit 128Mx8 1.8V 60-Pin FBGA Tray", "resources": [ { "type": "cloud_part_detail", "uri": "http://www.arrow.com/en/products/mt47h128m8hq-3e/micron-technology" }, { "type": "api_part_detail", "uri": "http://api.arrow.com/itemservice/v2/en/detail?mfrCd=MICRON&partNum=MT47H128M8HQ3E" }, { "type": "part_detail", "uri": "http://api.arrow.com/itemservice/v2/en/detail?pkey=vr8TlDjzQjqeZZ8bxe2gpIKfGhTXdkzaQg0HbDtbaAU" } ], "EnvData": { "compliance": [ { "displayLabel": "eurohs", "displayValue": "Compliant" }, { "displayLabel": "cnrohs", "displayValue": "Compliant" } ] }, "InvOrg": { "sources": [ { "currency": "USD", "sourceCd": "NAC", "displayName": "Americas", "sourceParts": [ { "packSize": 1, "minimumOrderQuantity": 1, "sourcePartNumber": "MT47H128M8HQ3E", "sourcePartId": "42944942", "Availability": [ { "fohQty": 0, "legacyBondedQty": 0, "availabilityCd": "NOSTK", "availabilityMessage": "No Stock", "pipeline": [] } ], "customerSpecificPricing": [], "customerSpecificInventory": [], "resources": [ { "type": "detail" }, { "type": "add_to_cart" } ], "inStock": false, "mfrLeadTime": 0, "isNcnr": false, "isNpi": false, "requestQuantity": 0, "productCode": "", "iccLevels": [], "cloudMfrCode": "" } ] } ] }, "hasDatasheet": true } ], "requestedPartNum": "MT47H128M8HQ-3:E", "numberFound": 1 }, { "resources": [], "PartList": [ { "itemId": 1578718, "partNum": "TMP275AIDGKT", "manufacturer": { "mfrCd": "TI", "mfrName": "Texas Instruments" }, "desc": "Temp Sensor Digital Serial (2-Wire) 8-Pin VSSOP T/R", "resources": [ { "type": "cloud_part_detail", "uri": "http://www.arrow.com/en/products/tmp275aidgkt/texas-instruments" }, { "type": "api_part_detail", "uri": "http://api.arrow.com/itemservice/v2/en/detail?mfrCd=TI&partNum=TMP275AIDGKT" }, { "type": "part_detail", "uri": "http://api.arrow.com/itemservice/v2/en/detail?pkey=zVZIQ_NNJl1G1sRiIMYyYQWUQ-LLVfUjqessXesXQhY" } ], "EnvData": { "compliance": [ { "displayLabel": "eurohs", "displayValue": "Compliant" }, { "displayLabel": "cnrohs", "displayValue": "Compliant" } ] }, "InvOrg": { "sources": [ { "currency": "USD", "sourceCd": "NAC", "displayName": "Americas", "sourceParts": [ { "packSize": 250, "minimumOrderQuantity": 0, "sourcePartNumber": "TMP275AIDGKT", "sourcePartId": "42723515S7896541N7713", "Prices": { "resaleList": [ { "displayPrice": "1.8260", "price": 1.8260, "minQty": 250, "maxQty": 9999999 } ] }, "Availability": [ { "fohQty": 250, "legacyBondedQty": 0, "availabilityCd": "INSTK", "availabilityMessage": "In Stock", "pipeline": [ { "delivery": "20170717", "quantity": 2000 }, { "delivery": "20170501", "quantity": 1750 }, { "delivery": "20170417", "quantity": 1000 } ] } ], "customerSpecificPricing": [], "customerSpecificInventory": [], "dateCode": "1614", "resources": [ { "type": "detail", "uri": "https://www.arrow.com/en/products/tmp275aidgkt/texas-instruments/" }, { "type": "add_to_cart", "uri": "https://www.arrow.com/en/products/tmp275aidgkt/texas-instruments/" } ], "inStock": true, "mfrLeadTime": 13, "isNcnr": false, "isNpi": false, "requestQuantity": 0, "productCode": "", "iccLevels": [], "cloudMfrCode": "" }, { "packSize": 1, "minimumOrderQuantity": 0, "sourcePartNumber": "TMP275AIDGKT**MULT1", "sourcePartId": "42723515S8838596N9193", "Prices": { "resaleList": [ { "displayPrice": "2.5720", "price": 2.5720, "minQty": 1, "maxQty": 9 }, { "displayPrice": "2.2750", "price": 2.2750, "minQty": 10, "maxQty": 24 }, { "displayPrice": "2.0500", "price": 2.0500, "minQty": 25, "maxQty": 99 }, { "displayPrice": "1.9170", "price": 1.9170, "minQty": 100, "maxQty": 999999999 } ] }, "Availability": [ { "fohQty": 292, "legacyBondedQty": 0, "availabilityCd": "CSTRP", "availabilityMessage": "Cut Strips", "pipeline": [] } ], "customerSpecificPricing": [], "customerSpecificInventory": [], "dateCode": "1601+", "resources": [ { "type": "detail", "uri": "https://www.arrow.com/en/products/tmp275aidgkt/texas-instruments/" }, { "type": "add_to_cart", "uri": "https://www.arrow.com/en/products/tmp275aidgkt/texas-instruments/" } ], "inStock": true, "mfrLeadTime": 13, "isNcnr": false, "isNpi": false, "requestQuantity": 0, "productCode": "", "iccLevels": [], "cloudMfrCode": "" }, { "packSize": 250, "minimumOrderQuantity": 0, "sourcePartNumber": "TMP275AIDGKT", "sourcePartId": "42723515S7896541N9193", "Prices": { "resaleList": [ { "displayPrice": "1.4500", "price": 1.4500, "minQty": 250, "maxQty": 999999999 } ] }, "Availability": [ { "fohQty": 0, "legacyBondedQty": 0, "availabilityCd": "NSTKC", "availabilityMessage": "No Stock", "pipeline": [] } ], "customerSpecificPricing": [], "customerSpecificInventory": [], "dateCode": "", "resources": [ { "type": "detail", "uri": "https://www.arrow.com/en/products/tmp275aidgkt/texas-instruments/" }, { "type": "add_to_cart", "uri": "https://www.arrow.com/en/products/tmp275aidgkt/texas-instruments/" } ], "inStock": false, "mfrLeadTime": 13, "isNcnr": false, "isNpi": false, "requestQuantity": 0, "productCode": "", "iccLevels": [], "cloudMfrCode": "" } ] }, { "currency": "USD", "sourceCd": "C1S", "displayName": "Chip1Stop", "sourceParts": [ { "packSize": 1, "minimumOrderQuantity": 0, "sourcePartId": "TI01-0144827", "Prices": { "resaleList": [ { "displayPrice": "2.4300", "price": 2.4300, "minQty": 1, "maxQty": 9 }, { "displayPrice": "2.1800", "price": 2.1800, "minQty": 10, "maxQty": 49 }, { "displayPrice": "1.9300", "price": 1.9300, "minQty": 50, "maxQty": 99 }, { "displayPrice": "1.7900", "price": 1.7900, "minQty": 100, "maxQty": 499 }, { "displayPrice": "1.5300", "price": 1.5300, "minQty": 500, "maxQty": 999999999 } ] }, "Availability": [ { "fohQty": 881, "legacyBondedQty": 0, "availabilityCd": "INSTK", "availabilityMessage": "In Stock", "pipeline": [] } ], "customerSpecificPricing": [], "customerSpecificInventory": [], "resources": [ { "type": "detail", "uri": "http://www.chip1stop.com/dispDetail.do?partId=TI01-0144827" }, { "type": "add_to_cart", "uri": "http://www.chip1stop.com/dispDetail.do?partId=TI01-0144827" } ], "inStock": true, "mfrLeadTime": 0, "isNcnr": false, "isNpi": false, "requestQuantity": 0, "productCode": "", "iccLevels": [], "cloudMfrCode": "" } ] }, { "currency": "USD", "sourceCd": "VERICAL", "displayName": "Verical", "sourceParts": [ { "packSize": 250, "minimumOrderQuantity": 250, "sourcePartId": "22060153", "Prices": { "resaleList": [ { "displayPrice": "1.8260", "price": 1.8260, "minQty": 250, "maxQty": 99999999 } ] }, "Availability": [ { "fohQty": 250, "legacyBondedQty": 0, "availabilityCd": "INSTK", "availabilityMessage": "In Stock", "pipeline": [] } ], "customerSpecificPricing": [], "customerSpecificInventory": [], "dateCode": "1614", "resources": [ { "type": "detail", "uri": "https://www.verical.com/pd/texas-instruments-temperature-and-humidity-sensors-TMP275AIDGKT-292161" }, { "type": "add_to_cart", "uri": "https://www.verical.com/pd/texas-instruments-temperature-and-humidity-sensors-TMP275AIDGKT-292161" } ], "inStock": true, "mfrLeadTime": 0, "isNcnr": false, "isNpi": false, "requestQuantity": 0, "productCode": "", "iccLevels": [], "cloudMfrCode": "" }, { "packSize": 1, "minimumOrderQuantity": 5, "sourcePartId": "21113796", "Prices": { "resaleList": [ { "displayPrice": "2.5720", "price": 2.5720, "minQty": 5, "maxQty": 9 }, { "displayPrice": "2.2750", "price": 2.2750, "minQty": 10, "maxQty": 24 }, { "displayPrice": "2.0500", "price": 2.0500, "minQty": 25, "maxQty": 99 }, { "displayPrice": "1.9170", "price": 1.9170, "minQty": 100, "maxQty": 99999999 } ] }, "Availability": [ { "fohQty": 292, "legacyBondedQty": 0, "availabilityCd": "INSTK", "availabilityMessage": "In Stock", "pipeline": [] } ], "customerSpecificPricing": [], "customerSpecificInventory": [], "resources": [ { "type": "detail", "uri": "https://www.verical.com/pd/texas-instruments-temperature-and-humidity-sensors-TMP275AIDGKT-292161" }, { "type": "add_to_cart", "uri": "https://www.verical.com/pd/texas-instruments-temperature-and-humidity-sensors-TMP275AIDGKT-292161" } ], "inStock": true, "mfrLeadTime": 0, "isNcnr": false, "isNpi": false, "requestQuantity": 0, "productCode": "", "iccLevels": [], "cloudMfrCode": "" } ] } ] }, "hasDatasheet": true } ], "requestedPartNum": "TMP275AIDGKT", "numberFound": 1 } ] } ] }}