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/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": ""
          }
        ]
      }
    ]
  }
}