Supply: Change your Region

Modified on Tue, 21 Apr at 10:51 AM

Many of our distributor partners provide different inventory levels and prices depending on the user's country. The API defaults to US and USD for country and currency but these can be overridden to get results more suitable to your region.

Many distributors will ship to multiple countries or not segregate stock by country, and as such, the input country and currency are not used as a hard filter.

Country codes follow the ISO 3166 (alpha-2) standard; currency codes follow the ISO 4217 standard.

Inventory Level

Compare the query for inventory level for Great Britain:

query GBMatch {
  supMultiMatch(
    country: "GB"
    currency: "GBP"
    queries: [{ mpn: "AR 32 HZL-TT", limit: 3 }]
  ) {
    parts {
      sellers(authorizedOnly: true) {
        company {
          name
        }
        offers {
          inventoryLevel
        }
      }
    }
  }
}

... with the query in the US:

query USMatch {
  supMultiMatch(
    queries: [{ mpn: "AR 32 HZL-TT", limit: 3 }]
  ) {
    parts {
      sellers(authorizedOnly: true) {
        company {
          name
        }
        offers {
          inventoryLevel
        }
      }
    }
  }
}

In this case, on this particular day, there were 1,370 parts available to ship to GB. However, those in the US would only see 300 parts available.

Currency Conversion

When an offer is returned it may be converted between currencies. For example:

query CurrencyConversion {
  supSearch(
    q: "74546-04"
    country: "FR"
    currency: "EUR"
  ) {
    results {
      part {
        name
        sellers(authorizedOnly: true) {
          offers {
            prices {
              quantity
              price
              currency
              convertedPrice
              convertedCurrency
              conversionRate
            }
          }
        }
      }
    }
  }
}

In this example the USD price was converted into the user's EUR currency at a conversion rate of 0.849985 Euros per US Dollar:

  "sellers": [
    {
      "offers": [
        "prices": [
          {
            "quantity": 50,
            "price": 134.21,
            "currency": "USD",
            "convertedPrice": 114.07648685000001,
            "convertedCurrency": "EUR",
            "conversionRate": 0.849985
          }
        ]
      }
    ]
  }

Note the conversion is an estimate based on foreign change rates. We recommend alerting the user to this estimate in the case where currency is not the same as convertedCurrency.