Lead Time overview

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.
• Skip the lead-time check when stock covers the order. If the requested quantity is at or below current stock, this returns a same-day-class estimate (1 business day) without a downstream scheduling lookup — cheap enough to call on every quote.

A request for a quantity or part with no schedule data available still returns 200, with businessDaysToShip and nextShipDate as null rather than an error — check for nulls in the response instead of relying on an HTTP error code to detect "no schedule available."

Common errors

Related APIs

• Catalog — look up a part's current stock quantity and packaging rules, which directly affect the schedule this API returns.

What's next?

• Lead Time Reference — the full endpoint, its parameters, and a live playground.
• Catalog — look up part details before checking its schedule.