Catalog overview

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

Overview

The Catalog API looks up Samtec parts by part number, keyword, or bulk export — returning current pricing, stock quantity, packaging, environmental compliance, and related-part data for each result. Use it to power a part-detail page, keep local inventory data in sync, or feed part data into your own procurement or design tools.

Three versions exist. V1 is deprecated and will be removed after remaining users migrate. V2 deprecated virtualStockQuantity in favor of stockQuantity. V3 — the version documented here — improved the underlying paging mechanism for faster traversal of the full catalog. See What's New for the V3 migration notice if you're still on V1 or V2.

Prerequisites

Every request needs two headers:

Header	Value
`Authorization`	`Bearer <your token>`
`client-app-name`	3–100 characters identifying your application

See Authentication if you don't have a token yet. All Samtec APIs, including Catalog, are limited to 1,000 requests per second.

Quick start

curl "https://api.samtec.com/catalog/v3/TSW-110-08-T-D" \
  -H "Authorization: Bearer YOUR_JWT_TOKEN" \
  -H "client-app-name: your-app-name"

{
  "part": "TSW-110-08-T-D",
  "description": "TSW Series, 8 Position, Single Row, Straight, Through Hole, 0.100\" (2.54mm) Pitch, Socket Strip",
  "stockQuantity": 184320,
  "minimumOrderQuantity": 1,
  "currency": "USD",
  "price": [
    { "column": 1, "minimumQuantity": 1, "maximumQuantity": 24, "price": 1.42 },
    { "column": 2, "minimumQuantity": 25, "maximumQuantity": 99, "price": 1.08 }
  ],
  "packaging": { "description": "Tube", "standardQuantity": 50, "fullIncrementRequired": false },
  "lifecycleStatus": "Production"
}

Common use cases

Part-detail pages. Look up a single part by number (GET /v3/{part}) to show live pricing, stock, packaging, and compliance data.
Keyword search. Let a user find a part without knowing the exact part number (GET /v3/search).
Local catalog sync. Page through the full catalog (GET /v3) to build or refresh a local mirror, then use GET /v3/delta/availability afterward to pick up only what changed rather than re-fetching everything.
Bulk export. Download a full pricing or catalog file for offline processing (GET /v1/export, GET /v1/export/{date}) instead of making one request per part.

Common errors

Status	Meaning	How to resolve
400	Missing or invalid parameter — an empty part number, an unsupported `isoCurrencyCode`, or (for search) a missing `query`	Check the specific message in the response body; it names which parameter failed.
401	Missing or invalid JWT	See Authentication.
403	Valid JWT, but it doesn't have Catalog claims	Email apionboarding@samtec.com to request Catalog access.
429	Rate limit exceeded (1,000 req/s)	Retry with backoff.

Lead Time — once you've found a part here, check its next available shipment date before quoting a delivery window.
Pricing — Catalog's price field is book pricing; use Pricing for customer-specific quantity-break pricing on the same part.
Models — download a 3D model or footprint for any part you find here.

What's next?

Catalog Reference — every endpoint, parameter, and response schema, with a live playground.
Lead Time — check delivery windows for a part you just looked up.
Pricing — get customer-specific pricing for the same part.