SDSamtec Developer Portal
APIsCatalogReferencePart Lookup

Retrieve the parts where availability has changed since the given timestamp.

Returns parts whose stock quantity has changed since the given `epochMilliseconds` timestamp — useful for keeping a local availability cache in sync without re-fetching the whole catalog. Pass `0`, or omit the parameter, to retrieve the full history. Results are capped at `recordCount` records per call (default 1,000); page through by re-calling with the timestamp of the last record you received.

GET
/v3/delta/availability
AuthorizationBearer <token>

JWT Authorization header using the Bearer scheme. Example: "Authorization: Bearer {your token here}"

In: header

Query Parameters

epochMilliseconds?integer

The number of milliseconds since Unix epoch for the first difference (pass 0 to get all parts). There are websites that can assist you in calculating the milliseconds since Unix epoch; one example is https://currentmillis.com/.

Formatint64
recordCount?integer

Number of records to retrieve in a single page

Formatint32
Default1000

Header Parameters

client-app-name?string

Name of the client application

Default"samtec-dev-portal"

Response Body

application/json

curl -X GET "https://example.com/v3/delta/availability"
[  {    "timestamp": "2026-08-14T09:32:07Z",    "part": "TSW-110-08-T-D",    "stockQuantity": 184320,    "timestampTicks": 638608675270000000  },  {    "timestamp": "2026-08-14T11:05:41Z",    "part": "SFM-150-02-L-D-A",    "stockQuantity": 42750,    "timestampTicks": 638608735410000000  }]