Pricing overview

What the Pricing API does, prerequisites, quick start, common use cases, and errors.

Overview

The Pricing API returns the price Samtec would quote your organization for a specific part and quantity. It checks for contract pricing tied to a specific OEM customer relationship first, then falls back to standard book pricing — so the same call works whether you're pricing a one-off prototype order or a high-volume production run under an existing contract.

Prerequisites

Every request needs the Authorization: Bearer <token> and client-app-name headers described in Authentication. Pricing is subject to the same 1,000 requests/second rate limit as every other API on this portal — see Common errors for the 429 response.

Quick start

curl "https://api.samtec.com/pricing/v1/customerpricing/TSW-110-08-T-D?quantity=2500&isoCurrencyCode=USD" \
  -H "Authorization: Bearer YOUR_JWT_TOKEN" \
  -H "client-app-name: your-app-name"

{
  "part": "TSW-110-08-T-D",
  "fullIncrementsRequired": false,
  "packagingQuantity": 100,
  "isoCurrencyCode": "USD",
  "customerInformation": {
    "oemNameProvided": false,
    "oemMatchFound": false,
    "oemSamtecCustomerName": null,
    "cmNameProvided": false,
    "cmMatchFound": false,
    "cmSamtecCustomerName": null
  },
  "bookPrice": {
    "oem": 0.842,
    "distributor": 0.913
  },
  "prices": [
    {
      "suggestedPrice": 0.842,
      "contract": null,
      "oemCustomer": null,
      "minimumOrderQuantity": 100
    }
  ]
}

bookPrice and prices[].contract are mutually exclusive: if a matching contract is found for the OEM/CM relationship you specify, contract is populated with its price breaks and bookPrice is left out; otherwise you get standard book pricing in bookPrice, keyed by oem and distributor.

Common use cases

Live pricing on a quote or checkout page. Call this per line item as a customer builds an order to show an accurate, quantity-adjusted price before they commit.
Contract vs. book pricing checks. Pass oemPart or customerName to see whether a specific OEM relationship has negotiated contract pricing, versus falling back to list book pricing.
Quantity-break cost modeling. Call with a range of quantity values to build a price-break curve for BOM costing or production-volume planning.
Multi-currency price display. Set isoCurrencyCode to USD, EUR, GBP, or CNY to show prices in a customer's local currency without a separate conversion step.

Common errors

Status	Meaning	How to resolve
400	`part` is missing, `isoCurrencyCode` isn't one of `USD`/`EUR`/`GBP`/`CNY`, or both `oemPart` and `customerName` were provided	Provide exactly one of `oemPart` or `customerName`, not both, and use a supported currency code.
400	Contract manufacturer (`CM`) accounts must provide `oemPart` or `customerName`	Include one of those two parameters when calling as a CM-type account.
401	Missing or invalid JWT	Confirm your `Authorization: Bearer <token>` header.
403	Valid JWT, but it doesn't have the claims needed for the Pricing API	Email apionboarding@samtec.com to request access.
429	Rate limit exceeded (1,000 req/s)	Retry with backoff.

Catalog — look up a part before checking its price.
Quotes — pricing data feeds into formal customer quotes.

What's next?

Pricing Reference — the full endpoint, its parameters, and a live playground.
Catalog — look up a part before pricing it.
Quotes — turn pricing data into a formal customer quote.