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
  • default is true
  • only supports true
partNum part to search on yes
  • wildcard * not allowed
  • should be url-encoded to escape url unsafe characters
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
  • default is 10
  • max is 25
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
        }
      ]
    }
  ]
}}