variants

What is still on order for one variant

The open orders carrying one variant, with the quantities counted for that variant alone.

Each order carries id, name, status (FullyConfirmed or FullyShipped), expected_delivery_date, supplier_id and supplier_name, location_id and location_name, line_items and deliveries for this variant, and ordered_quantity and delivered_quantity summed over this variant's lines. An order that also carries other variants is here, but its quantities are not: what is served is this variant's share.

A variant with nothing inbound answers purchase_orders: [], which is the empty case and not an error.

For the whole order, with every line on it, read the purchase orders resource; for the same question across a product, read the product's incoming purchase orders.

Scope: products:read.

get/api/v1/variants/{variant_id}/incoming-pos

Request

  • Base URL: https://api.app.tightly.io
  • URL: https://api.app.tightly.io/api/v1/variants/{variant_id}/incoming-pos
  • Auth: HTTP bearer

Path parameters

variant_idstring required
Example:42318902722609

The variant whose inbound orders this reads.

Headers

Tightly-Versionstring
Example:2026-11

The date train to answer on. One train exists today, 2026-11, the one this reference describes and the one every key is minted on, so the call answers on it with or without this header. Send it anyway, so a client built now names its train from the start.

Response

The open orders carrying this variant, with its own ordered and delivered quantities.

messageobject

severity, service and desc.

Changes

No recorded changes to this operation across all 1 revision of this API.