Orders overview

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

Overview

Samtec's Orders API places and tracks orders programmatically — submit a new order, submit a change to an existing one, or look up orders by status: received but not yet scheduled, open and scheduled, or full history including shipments. Use it to keep your own order-management system in sync with Samtec without re-entering data by hand.

Prerequisites

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

Quick start

Look up open, scheduled orders for your account:

curl "https://api.samtec.com/orders/v1/openorders?topMatches=10" \
  -H "Authorization: Bearer YOUR_JWT_TOKEN" \
  -H "client-app-name: your-app-name"

[
  {
    "OrderId": 4512389,
    "MfgLineNumber": 1,
    "ConfirmationNumber": "TTQ44XTJM6P8",
    "Status": "Open",
    "PONumber": "PO-88214-A",
    "Part": "TSW-110-08-T-D",
    "Quantity": 2500,
    "NetPrice": 0.184,
    "Currency": "USD",
    "Scheduled": "2026-08-14T00:00:00Z"
  }
]

Common use cases

Order status sync. Poll /v1/openorders and /v1/history on a schedule to keep your own order-management or ERP system's order statuses current without manual lookups.
Confirming receipt. After submitting an order with /v1/new, check /v1/receivedorders to confirm Samtec has received it before it moves into production scheduling.
Submitting orders programmatically. Use /v1/new to place orders directly from your procurement system instead of email or a manual portal.
Tracking shipments against a PO. Use /v1/history with includeShipments=true and a poNumber filter to see tracking numbers and ship dates for a specific purchase order.

Common errors

Status	Meaning	How to resolve
204	No orders matched your filters	Not an error — no data for the given request.
400	Missing/invalid header, or (on `/v1/history`) no filter supplied — at least one of order ID, PO number, confirmation number, part number, customer part number, end customer name, or a date range is required	Check the response body, which lists each validation error as a string.
401	Missing or invalid JWT	Confirm the `Authorization` header is `Bearer <token>`.
403	Valid JWT without claims for this API	Email apionboarding@samtec.com to request access.
429	Rate limit exceeded (1,000 req/s)	Retry with backoff.

Quotes — quotes and orders are related, but this portal doesn't describe converting one into the other; treat them as separate APIs for now.
Catalog — look up part details and current availability for the Part/CustomerPart values that show up on an order line.

What's next?

Orders Reference — every endpoint, its parameters, and a live playground.
Quotes — the related API for formal price quotes.
Catalog — look up the parts on an order line.