Search By Token

Given a search_token, returns all possible part matches.

Request Parameters

Parameter Description Required
search_token Exact or prefix part token to search on yes
login Customer login name yes
apikey The API Key provided during the registration process yes
rows Number of parts with unique itemIDs to return - max is 25; default 10 no
start Number in the search list from which to start outputting parts no
fmt JSON (default) or XML no
mfrCd Manufacturer code used to filter results. Given here. no

Example Request

API Address: http://api.arrow.com
GET /itemservice/v3/en/search/token?login=<login>&apikey=<apikey>&search_token=bav99-7-f

Example Response

{"itemserviceresult": {
  "serviceMetaData": [
    {
      "version": "3.0.2"
    }
  ],
  "transactionArea": [
    {
      "response": {
        "returnCode": "0",
        "returnMsg": "",
        "success": true
      },
      "responseSequence": {
        "transactionTime": "45.147 ms",
        "queryTime": "44.823 ms",
        "dbTime": "14.796 ms",
        "totalItems": 189,
        "resources": [],
        "qq": 150
      }
    }
  ],
  "data": [
    {
      "resources": [
        {
          "type": "search",
          "uri": "http://parts.arrow.com/item/search/#st=bav99"
        }
      ],
      "PartList": [
        {
          "itemId": 2031150,
          "partNum": "BAV99",
          "manufacturer": {
            "mfrCd": "FAIRCHLD",
            "mfrName": "Fairchild Semiconductor"
          },
          "desc": "Diode Small Signal Switching 70V 0.2A 3-Pin SOT-23 T/R",
          "resources": [
            {
              "type": "cloud_part_detail",
              "uri": "http://www.arrow.com/en/products/bav99/fairchild-semiconductor"
            },
            {
              "type": "api_part_detail",
              "uri": "http://api.arrow.com/itemservice/v2/en/detail?mfrCd=FAIRCHLD&partNum=BAV99"
            },
            {
              "type": "part_detail",
              "uri": "http://api.arrow.com/itemservice/v2/en/detail?pkey=UMkTh2N6h4yRPW68mrm9myUi7hOcMlL7xEi4oUw8bG4"
            }
          ],
          "EnvData": {
            "compliance": [
              {
                "displayLabel": "eurohs",
                "displayValue": "Compliant"
              },
              {
                "displayLabel": "cnrohs",
                "displayValue": "Compliant"
              }
            ]
          },
          "InvOrg": {
            "sources": [
              {
                "currency": "USD",
                "sourceCd": "VERICAL",
                "displayName": "Verical",
                "sourceParts": [
                  {
                    "packSize": 3000,
                    "minimumOrderQuantity": 3000,
                    "sourcePartId": "21768484",
                    "Prices": {
                      "resaleList": [
                        {
                          "displayPrice": "0.0292",
                          "price": 0.0292,
                          "minQty": 3000,
                          "maxQty": 99999999
                        }
                      ]
                    },
                    "Availability": [
                      {
                        "fohQty": 117000,
                        "legacyBondedQty": 0,
                        "availabilityCd": "INSTK",
                        "availabilityMessage": "In Stock",
                        "pipeline": []
                      }
                    ],
                    "customerSpecificPricing": [],
                    "customerSpecificInventory": [],
                    "dateCode": "1640",
                    "resources": [
                      {
                        "type": "detail",
                        "uri": "https://www.verical.com/pd/fairchild-semiconductor-rectifier-BAV99-110217"
                      },
                      {
                        "type": "add_to_cart",
                        "uri": "https://www.verical.com/pd/fairchild-semiconductor-rectifier-BAV99-110217"
                      }
                    ],
                    "inStock": true,
                    "mfrLeadTime": 0,
                    "isNcnr": false,
                    "isNpi": false,
                    "requestQuantity": 0,
                    "productCode": "",
                    "iccLevels": [],
                    "cloudMfrCode": ""
                  },
                  {
                    "packSize": 3000,
                    "minimumOrderQuantity": 21000,
                    "sourcePartId": "15810562",
                    "Prices": {
                      "resaleList": [
                        {
                          "displayPrice": "0.0224",
                          "price": 0.0224,
                          "minQty": 1,
                          "maxQty": 999999999
                        }
                      ]
                    },
                    "Availability": [
                      {
                        "fohQty": 36000,
                        "legacyBondedQty": 0,
                        "availabilityCd": "INSTK",
                        "availabilityMessage": "In Stock",
                        "pipeline": []
                      }
                    ],
                    "customerSpecificPricing": [],
                    "customerSpecificInventory": [],
                    "resources": [
                      {
                        "type": "detail",
                        "uri": "https://www.verical.com/pd/fairchild-semiconductor-rectifier-BAV99-110217"
                      },
                      {
                        "type": "add_to_cart",
                        "uri": "https://www.verical.com/pd/fairchild-semiconductor-rectifier-BAV99-110217"
                      }
                    ],
                    "inStock": true,
                    "mfrLeadTime": 0,
                    "isNcnr": false,
                    "isNpi": false,
                    "requestQuantity": 0,
                    "productCode": "",
                    "iccLevels": [],
                    "cloudMfrCode": ""
                  },
                  {
                    "packSize": 3000,
                    "minimumOrderQuantity": 3000,
                    "sourcePartId": "7954912",
                    "Prices": {
                      "resaleList": [
                        {
                          "displayPrice": "0.0199",
                          "price": 0.0199,
                          "minQty": 1,
                          "maxQty": 999999999
                        }
                      ]
                    },
                    "Availability": [
                      {
                        "fohQty": 57000,
                        "legacyBondedQty": 0,
                        "availabilityCd": "INSTK",
                        "availabilityMessage": "In Stock",
                        "pipeline": []
                      }
                    ],
                    "customerSpecificPricing": [],
                    "customerSpecificInventory": [],
                    "resources": [
                      {
                        "type": "detail",
                        "uri": "https://www.verical.com/pd/fairchild-semiconductor-rectifier-BAV99-110217"
                      },
                      {
                        "type": "add_to_cart",
                        "uri": "https://www.verical.com/pd/fairchild-semiconductor-rectifier-BAV99-110217"
                      }
                    ],
                    "inStock": true,
                    "mfrLeadTime": 0,
                    "isNcnr": false,
                    "isNpi": false,
                    "requestQuantity": 0,
                    "productCode": "",
                    "iccLevels": [],
                    "cloudMfrCode": ""
                  },
                  {
                    "packSize": 1,
                    "minimumOrderQuantity": 307,
                    "sourcePartId": "20353671",
                    "Prices": {
                      "resaleList": [
                        {
                          "displayPrice": "0.0383",
                          "price": 0.0383,
                          "minQty": 307,
                          "maxQty": 499
                        },
                        {
                          "displayPrice": "0.0346",
                          "price": 0.0346,
                          "minQty": 500,
                          "maxQty": 999
                        },
                        {
                          "displayPrice": "0.0307",
                          "price": 0.0307,
                          "minQty": 1000,
                          "maxQty": 99999999
                        }
                      ]
                    },
                    "Availability": [
                      {
                        "fohQty": 19242,
                        "legacyBondedQty": 0,
                        "availabilityCd": "INSTK",
                        "availabilityMessage": "In Stock",
                        "pipeline": []
                      }
                    ],
                    "customerSpecificPricing": [],
                    "customerSpecificInventory": [],
                    "resources": [
                      {
                        "type": "detail",
                        "uri": "https://www.verical.com/pd/fairchild-semiconductor-rectifier-BAV99-110217"
                      },
                      {
                        "type": "add_to_cart",
                        "uri": "https://www.verical.com/pd/fairchild-semiconductor-rectifier-BAV99-110217"
                      }
                    ],
                    "inStock": true,
                    "mfrLeadTime": 0,
                    "isNcnr": false,
                    "isNpi": false,
                    "requestQuantity": 0,
                    "productCode": "",
                    "iccLevels": [],
                    "cloudMfrCode": ""
                  }
                ]
              },
              {
                "currency": "EUR",
                "sourceCd": "EUROPE",
                "displayName": "Europe",
                "sourceParts": [
                  {
                    "packSize": 3000,
                    "minimumOrderQuantity": 3000,
                    "sourcePartId": "E02:0323_00043394",
                    "Prices": {
                      "resaleList": [
                        {
                          "displayPrice": "0,0425",
                          "price": 0.0425,
                          "minQty": 1,
                          "maxQty": 3000
                        },
                        {
                          "displayPrice": "0,0255",
                          "price": 0.0255,
                          "minQty": 3001,
                          "maxQty": 30000
                        },
                        {
                          "displayPrice": "0,0182",
                          "price": 0.0182,
                          "minQty": 30001,
                          "maxQty": 1500000
                        }
                      ]
                    },
                    "Availability": [
                      {
                        "fohQty": 59401,
                        "legacyBondedQty": 0,
                        "availabilityCd": "INSTKEU",
                        "availabilityMessage": "In Stock",
                        "pipeline": [
                          {
                            "delivery": "20170307",
                            "quantity": 24000
                          }
                        ]
                      }
                    ],
                    "customerSpecificPricing": [],
                    "customerSpecificInventory": [],
                    "dateCode": "1646+",
                    "resources": [
                      {
                        "type": "detail",
                        "uri": "http://components.arrow.com/part/detail/0323_00043394?region=arrowne"
                      },
                      {
                        "type": "add_to_cart",
                        "uri": "http://components.arrow.com/part/detail/0323_00043394?region=arrowne"
                      }
                    ],
                    "inStock": true,
                    "mfrLeadTime": 6,
                    "isNcnr": false,
                    "isNpi": false,
                    "requestQuantity": 0,
                    "productCode": "",
                    "iccLevels": [],
                    "unityCombinedIccLevel3": "2015|13290|2021",
                    "cloudMfrCode": ""
                  },
                  {
                    "packSize": 3000,
                    "minimumOrderQuantity": 3000,
                    "sourcePartId": "E21:3489_00043394",
                    "Prices": {
                      "resaleList": [
                        {
                          "displayPrice": "0,1834",
                          "price": 0.1834,
                          "minQty": 1,
                          "maxQty": 9
                        },
                        {
                          "displayPrice": "0,1232",
                          "price": 0.1232,
                          "minQty": 10,
                          "maxQty": 99
                        },
                        {
                          "displayPrice": "0,0503",
                          "price": 0.0503,
                          "minQty": 100,
                          "maxQty": 999
                        },
                        {
                          "displayPrice": "0,0340",
                          "price": 0.0340,
                          "minQty": 1000,
                          "maxQty": 2999
                        },
                        {
                          "displayPrice": "0,0281",
                          "price": 0.0281,
                          "minQty": 3000,
                          "maxQty": 9999999
                        }
                      ]
                    },
                    "Availability": [
                      {
                        "fohQty": 599,
                        "legacyBondedQty": 0,
                        "availabilityCd": "INSTKEU",
                        "availabilityMessage": "In Stock",
                        "pipeline": [
                          {
                            "delivery": "20170306",
                            "quantity": 59401
                          }
                        ]
                      }
                    ],
                    "customerSpecificPricing": [],
                    "customerSpecificInventory": [],
                    "dateCode": "1518",
                    "resources": [
                      {
                        "type": "detail",
                        "uri": "http://components.arrow.com/part/detail/3489_00043394?region=arrowne"
                      },
                      {
                        "type": "add_to_cart",
                        "uri": "http://components.arrow.com/part/detail/3489_00043394?region=arrowne"
                      }
                    ],
                    "inStock": true,
                    "mfrLeadTime": 6,
                    "isNcnr": false,
                    "isNpi": false,
                    "requestQuantity": 0,
                    "productCode": "",
                    "iccLevels": [],
                    "unityCombinedIccLevel3": "2015|13290|2021",
                    "cloudMfrCode": ""
                  }
                ]
              },
              {
                "currency": "USD",
                "sourceCd": "NAC",
                "displayName": "Americas",
                "sourceParts": [
                  {
                    "packSize": 3000,
                    "minimumOrderQuantity": 0,
                    "sourcePartNumber": "BAV99",
                    "sourcePartId": "1340091S1589807N9186",
                    "Prices": {
                      "resaleList": [
                        {
                          "displayPrice": "0.0198",
                          "price": 0.0198,
                          "minQty": 6000,
                          "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/bav99/fairchild-semiconductor/"
                      },
                      {
                        "type": "add_to_cart",
                        "uri": "https://www.arrow.com/en/products/bav99/fairchild-semiconductor/"
                      }
                    ],
                    "inStock": false,
                    "mfrLeadTime": 6,
                    "isNcnr": false,
                    "isNpi": false,
                    "requestQuantity": 0,
                    "productCode": "",
                    "iccLevels": [],
                    "cloudMfrCode": ""
                  },
                  {
                    "packSize": 3000,
                    "minimumOrderQuantity": 0,
                    "sourcePartNumber": "BAV99",
                    "sourcePartId": "1340091S1589807N7769",
                    "Prices": {
                      "resaleList": [
                        {
                          "displayPrice": "0.0292",
                          "price": 0.0292,
                          "minQty": 3000,
                          "maxQty": 9999999
                        }
                      ]
                    },
                    "Availability": [
                      {
                        "fohQty": 117000,
                        "legacyBondedQty": 0,
                        "availabilityCd": "INSTK",
                        "availabilityMessage": "In Stock",
                        "pipeline": [
                          {
                            "delivery": "20170320",
                            "quantity": 78000
                          }
                        ]
                      }
                    ],
                    "customerSpecificPricing": [],
                    "customerSpecificInventory": [],
                    "dateCode": "1640+",
                    "resources": [
                      {
                        "type": "detail",
                        "uri": "https://www.arrow.com/en/products/bav99/fairchild-semiconductor/"
                      },
                      {
                        "type": "add_to_cart",
                        "uri": "https://www.arrow.com/en/products/bav99/fairchild-semiconductor/"
                      }
                    ],
                    "inStock": true,
                    "mfrLeadTime": 6,
                    "isNcnr": false,
                    "isNpi": false,
                    "requestQuantity": 0,
                    "productCode": "",
                    "iccLevels": [],
                    "cloudMfrCode": ""
                  },
                  {
                    "packSize": 1,
                    "minimumOrderQuantity": 0,
                    "sourcePartNumber": "BAV99**MULT1",
                    "sourcePartId": "1340091S2326911N9186",
                    "Prices": {
                      "resaleList": [
                        {
                          "displayPrice": "0.0592",
                          "price": 0.0592,
                          "minQty": 1,
                          "maxQty": 9
                        },
                        {
                          "displayPrice": "0.0549",
                          "price": 0.0549,
                          "minQty": 10,
                          "maxQty": 24
                        },
                        {
                          "displayPrice": "0.0531",
                          "price": 0.0531,
                          "minQty": 25,
                          "maxQty": 99
                        },
                        {
                          "displayPrice": "0.0425",
                          "price": 0.0425,
                          "minQty": 100,
                          "maxQty": 249
                        },
                        {
                          "displayPrice": "0.0383",
                          "price": 0.0383,
                          "minQty": 250,
                          "maxQty": 499
                        },
                        {
                          "displayPrice": "0.0346",
                          "price": 0.0346,
                          "minQty": 500,
                          "maxQty": 999
                        },
                        {
                          "displayPrice": "0.0307",
                          "price": 0.0307,
                          "minQty": 1000,
                          "maxQty": 999999999
                        }
                      ]
                    },
                    "Availability": [
                      {
                        "fohQty": 19242,
                        "legacyBondedQty": 0,
                        "availabilityCd": "CSTRP",
                        "availabilityMessage": "Cut Strips",
                        "pipeline": []
                      }
                    ],
                    "customerSpecificPricing": [],
                    "customerSpecificInventory": [],
                    "dateCode": "1616+",
                    "resources": [
                      {
                        "type": "detail",
                        "uri": "https://www.arrow.com/en/products/bav99/fairchild-semiconductor/"
                      },
                      {
                        "type": "add_to_cart",
                        "uri": "https://www.arrow.com/en/products/bav99/fairchild-semiconductor/"
                      }
                    ],
                    "inStock": true,
                    "mfrLeadTime": 6,
                    "isNcnr": false,
                    "isNpi": false,
                    "requestQuantity": 0,
                    "productCode": "",
                    "iccLevels": [],
                    "cloudMfrCode": ""
                  },
                  {
                    "packSize": 1,
                    "minimumOrderQuantity": 0,
                    "sourcePartNumber": "BAV99",
                    "sourcePartId": "1340091S1589807N2983",
                    "Prices": {
                      "resaleList": [
                        {
                          "displayPrice": "0.0292",
                          "price": 0.0292,
                          "minQty": 3000,
                          "maxQty": 9999999
                        }
                      ]
                    },
                    "Availability": [
                      {
                        "fohQty": 785,
                        "legacyBondedQty": 0,
                        "availabilityCd": "WHSUPLST",
                        "availabilityMessage": "While Supplies Last",
                        "pipeline": []
                      }
                    ],
                    "customerSpecificPricing": [],
                    "customerSpecificInventory": [],
                    "dateCode": "1610",
                    "distStockAllow": {
                      "@class": "com.arrow.ecommerce.argocommon.model.dsa.NaDsaLookupObject",
                      "isWarrantied": true,
                      "sourceCode": "NAC",
                      "countryCode": "US",
                      "companyName": "ARROW/AMERICAS",
                      "neda": "2983"
                    },
                    "resources": [
                      {
                        "type": "detail",
                        "uri": "https://www.arrow.com/en/products/bav99/fairchild-semiconductor/"
                      },
                      {
                        "type": "add_to_cart",
                        "uri": "https://www.arrow.com/en/products/bav99/fairchild-semiconductor/"
                      }
                    ],
                    "inStock": true,
                    "mfrLeadTime": 0,
                    "isNcnr": false,
                    "isNpi": false,
                    "requestQuantity": 0,
                    "productCode": "",
                    "iccLevels": [],
                    "cloudMfrCode": ""
                  }
                ]
              }
            ]
          },
          "hasDatasheet": true
        }
      ]
    }
  ]
}}
		

Response Elements

The response document returned by the “Search By Token” service may contain the following elements.

Compliance value, e.g. “Compliant”
JSON Element Description
itemserviceresult Container for the entire response
serviceMetaData Conatiner for transaction status and metrics
transactionData Container for transaction status and metrics
data Container for primary reponse content
serviceMetaData Child of itemservice result
version The API version that sent the response
transactionArea Child of itemservice result
response Container for transaction status
responseSequence Container for transaction metrics
response Child of transactionArea
returnCode 0 if successful, otherwise an error code
returnMsg “” if successful, or a descriptive message otherwise
success “true” if successful, “false” otherwise
responseSequence Child of transactionArea
transactionTime
queryTime
dbTime
totalItems
resources
qq
data Child of itemserviceresult
resources[] List of resource elements, each defined within {}
PartList[] List of parts, each defined within {}
resources[] Child of data or PartList[] instance. Multiple instances of:
type Resource type, e.g. “search”
uri Uniform Resource Identifier: HTTP address
PartList[] Child of data. Multiple instances of:
itemID Arrow part identifier
partNum Manufacturer Part Number (MPN)
manufacturer Container for part manufacturer information
desc Human-readable description of the part
packageType
resources List of resource elements, each defined within {}
EnvData Container for environmental data
InvOrg Container for inventory data
hasDataSheet “true” if a data sheet containing technical information is available, “false” otherwise
manufacturer Child of a PartList[] instance
mfrCd Short code identifying the manufacturer
mfrName Full display name of the manufacturer
EnvData Child of a PartList[] instance
compliance[] Container for compliance-related data
compliance[] Child of EnvData. Multiple instances of:
displayLabel Compliance label, e.g. “eurohs”
displayValue
InvOrg Child of a PartList[] instance
sources[] List of inventory sources, each contained in {}
sources[] Child of InvOrg
currency The currency used to express prices.
USD: US Dollar
AUD: Australian Dollar
EUR: European Union Euro
KRW: South Korean Won
ILS: Israeli Shekel
sourceCd A short identifier for the source/region of the inventory. The most common are:
NAC: Arrow North America
EUROPE: Arrow Europe
ASIA: Arrow Asia
VERICAL: Verical Marketplace
displayName The full name for the source/region of the inventory, for example “Americas”
sourceParts[] List of source parts, each contained in {}
sourceParts[] Child of a source[] instance.Each element is a specific combination of part number, packaging, and inventory source.
packSize Number of parts per package/reel
minimumOrderQuantity The minimum number of parts that can be ordered. This will be a multiple of the packSize.
sourcePartId Unique identifier for this source part
Prices Container for pricing data
Availability[] List of elements containing inventory data
customerSpecificPricing[] List of elements with pricing and inventory data specific to the account number associated with the API credentials.
customerSpecificInventory[] Reserved for future use
dateCode Indicates the date the part was manufactured
distStockAllow Container for distibutor stocck allowances
resources[] See the resources[] element above
inStock true if there is inventory available, false otherwise
mfrLeadTime
isNcnr
isNpi
requestQuantity
productCode
iccLevels[]
cloudMfrCode
eccnCode
htsCode
containerType
Prices Child of a sourceParts[] instance
resaleList[] List of price breaks, each contained in {}
resaleList[]
displayPrice Price as a string that can be displayed in a client application
price Price as a numeric value
minQty Minimum quantity which must be purchased to receive this price
maxQty Maximum quantity which can be purchased before moving to the next price tier
Availability[] Child of a sourceParts[] instance. Multiple instances of:
fohQty Free On Hand Quantity, i.e. available inventory.
legacyBondedQty Inventory held for a specific customer
availabilityCd A short code indicating part availability. See table below.
availabilityMessage A longer descriptive string indicating part availability. See table below.
pipeline[]
customerSpecificPricing[] Child of a sourceParts[] instance. Multiple instances of:
customerNumber Primary account number
endCustomerNumber Account number for associated account
prices See the Prices element above
Availability[] See the Availability element above
distStockAllow Child of a sourceParts[] instance.
isWarrantied
sourceCode
countryCode
companyName
neda