Stock Availability API

Live inventory availability for Heritage Fabrics trade partners, one HTTP call per item. Read-only, key-authenticated, updated every 15 minutes.

Authentication

Include your API key in every request:

X-API-Key: sk_live_your_key_here

Your API key is tied to your customer account. Contact Heritage Fabrics to request access.

Check Availability

GET https://wms.asthetik.com/api/v1/stock?id=YOUR-ITEM-CODE

Response

{
  "item_code": "YOUR-ITEM-CODE",
  "description": "Fabric Description",
  "available_to_ship": 142.5,
  "uom": "YD",
  "incoming": [
    { "qty": 500.0, "expected_date": "2026-05-02", "status": "in_transit" },
    { "qty": 200.0, "expected_date": "2026-05-18", "status": "on_order" }
  ],
  "last_updated": "2026-04-14T15:30:00Z"
}

Fields

Field	Description
`item_code`	Your item code as registered with Heritage
`description`	Item description
`available_to_ship`	Quantity available for immediate shipment
`uom`	Unit of measure (typically YD for yards)
`incoming`	Shipments on order with expected arrival dates
`last_updated`	When inventory data was last refreshed

Incoming Shipment Status

Status	Meaning
`on_order`	Purchase order placed with vendor
`confirmed`	Vendor has acknowledged the order
`in_production`	Goods are being manufactured
`in_transit`	Shipped from vendor, en route
`at_port`	Arrived at destination port

Bulk Query

Check up to 50 items in a single request:

GET https://wms.asthetik.com/api/v1/stock?id=ITEM-001,ITEM-002,ITEM-003

Returns:

{
  "items": [
    { "item_code": "ITEM-001", "available_to_ship": 142.5, ... },
    { "item_code": "ITEM-002", "available_to_ship": 0, ... }
  ]
}

Items not found are omitted from the response (not returned as errors).

Rate Limits

60 requests per minute per API key. If exceeded, you will receive HTTP 429.

Error Codes

HTTP Code	Meaning
400	Missing or invalid `id` parameter
401	Invalid or missing API key
404	Item code not found (single item query only)
429	Rate limit exceeded — wait and retry

Data Freshness

Inventory updates every 15 minutes. Incoming shipment dates reflect the latest information from our logistics team and are updated as new ETAs are received.