Lead Time overview

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

Overview

The Lead Time API tells you when a part will ship and how many business days out that is, for a given quantity. Use it to give a customer a delivery estimate before they commit to an order, or to confirm a quantity you're about to order won't trigger a longer lead time than expected.

Prerequisites

Every request needs two headers: Authorization: Bearer <your token> and client-app-name (3–100 characters). See Authentication if you don't have a token yet. All APIs, including this one, are limited to 1,000 requests per second — requests beyond that get a 429.

Quick start

curl "https://api.samtec.com/leadtime/v1/scheduling/TSW-110-08-T-D?quantity=5000" \
  -H "Authorization: Bearer YOUR_JWT_TOKEN" \
  -H "client-app-name: your-app-name"

{
  "part": "TSW-110-08-T-D",
  "businessDaysToShip": 12,
  "nextShipDate": "2026-09-18",
  "adjustedQuantity": 5000
}

adjustedQuantity is the quantity actually used to calculate the schedule — some parts must be ordered in full packaging increments, so a requested quantity that doesn't land on one gets rounded up. Check it against the quantity you asked for if that matters to your workflow.

Common use cases

Quote a delivery date before a customer commits. Call this ahead of creating a quote or order so you can show a real ship date, not a placeholder.
Confirm a quantity won't trigger a longer wait. Check adjustedQuantity against the quantity you intended to order — if a part requires full-increment ordering, a small change in requested quantity can change the schedule.

A 200 response does not always mean a schedule was calculated. Check the error field — when it is non-null, nextShipDate and businessDaysToShip are null and error.code tells you why: 1 = general failure (contact customer service), 2 = unavailable for this part, 3 = supply constraint. A 204 response means no schedule data exists for this part at all.

Common errors

HTTP status	Meaning	How to resolve
401	Missing or invalid JWT	Confirm the `Authorization` header is `Bearer <token>` and the token is valid.
403	Valid JWT, but missing the claims for this API	Email apionboarding@samtec.com to request access.
429	Rate limit exceeded (1,000 req/s)	Retry with backoff.
500	Unexpected server error	Retry; if it persists, contact apionboarding@samtec.com with the part and quantity you sent.

Catalog — look up a part's packaging rules, which determine whether the quantity you request gets rounded up.

What's next?

Lead Time Reference — the full endpoint, its parameters, and a live playground.
Lead Time Swagger UI — the API's own built-in Swagger page, served directly from the API.
Catalog — look up part details before checking its schedule.