Quotes overview

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

Overview

The Quotes API returns the price-registered opportunities (quotes) tied to your organization — the parts, price breaks, and expiration windows Samtec has on file for you — plus a dedicated report for quotes that are about to expire. Use it to check current pricing on a part before a design decision, or to catch a price protection or design registration quote before it lapses.

Prerequisites

Every request needs the two headers described in Authentication:

Authorization: Bearer <your token>
client-app-name: <your application name>

The API is rate-limited to 1,000 requests per second. Requests beyond that return 429 Too Many Requests.

Quick start

curl "https://api.samtec.com/quotes/v1?part=TSW-110-08-T-D&includeCurrentOnly=true" \
  -H "Authorization: Bearer YOUR_JWT_TOKEN" \
  -H "client-app-name: your-app-name"

Response

{
  "totalResultsCount": 1,
  "opportunities": [
    {
      "designCustomer": "Acme Robotics Inc.",
      "distributor": "Digi-Key Electronics",
      "contractManufacturer": "Flex Ltd.",
      "samtecPart": "TSW-110-08-T-D",
      "opportunityId": 771234,
      "effectiveDate": "2026-08-14",
      "expirationDate": "2026-11-14",
      "priceBreaks": [
        { "moq": 100, "oemPrice": 0.842, "distPrice": 0.958 },
        { "moq": 1000, "oemPrice": 0.701, "distPrice": 0.799 }
      ],
      "priceProtectionType": "Design Registration",
      "willAutoRenew": false,
      "estimatedAnnualUsage": 48000
    }
  ]
}

Common use cases

Check current quoted pricing for a part before a design decision. Filter by part to see whether your organization already has a registered quote and price breaks for it, rather than requesting a new one.
Track all of your active quotes in one place. Page through /v1 without a part or opportunityId filter to build an internal dashboard of every opportunity tied to your account, including expiration dates and auto-renewal status.
Catch a lapsing price protection or design registration before it expires. /v1/Reports/expiring returns only the opportunities that are within 29 days of expiring and aren't set to auto-renew, so you can request a renewal instead of losing registered pricing.

Common errors

Status	Meaning	How to resolve
400	Your token's organization couldn't be resolved to a customer account	Confirm your token is valid for a customer organization; contact apionboarding@samtec.com if the problem persists.
401	Missing or invalid JWT	Confirm the `Authorization` header is `Bearer <token>` with no typos.
403	Valid JWT, but it doesn't have the claims needed for this API	Email apionboarding@samtec.com to request access.
429	Rate limit exceeded (1,000 req/s)	Retry with backoff.

Pricing — customer-specific pricing feeds into the price breaks on a quote.
Orders — related API for placing and tracking orders.

What's next?

Quotes Reference — every endpoint, its parameters, and a live playground.
Pricing — where the price breaks on a quote come from.
Orders — the related API for placing and tracking orders.