stocktakes

The lines of one count, with the difference

One page of the lines in a count. Each row is one variant at one location: system_quantity (the level snapshotted when the count was created), counted_quantity, variance and variance_value, with sku, product_title, variant_title, location_name and unit_cost for display.

counted_quantity, variance and variance_value are null on a line nobody has counted yet. That null is not a zero: a line counted at exactly system stock carries variance: 0, and the two are opposite statements about a shelf. line_scope narrows the page: differences returns only counted lines whose count differs from system (so it excludes the matched lines AND the uncounted ones), and uncounted returns only the lines nobody has counted, which is the work left to do on a count part way through. variance_only=true is the older spelling of line_scope=differences and still works.

unit_cost is null where no cost is on file, and a counted line with no cost is valued at zero, so variance_value: 0 beside a null unit_cost means not priced rather than no money at stake.

search matches product title and SKU. sort_args takes product_title, sku, location_name, system_quantity, counted_quantity, variance or variance_value, prefixed - for descending. limit defaults to 25. For variance measured across posted counts and attributed to a supplier rather than listed line by line, use get_stock_variance_by_supplier.

Scope: stocktakes:read.

get/api/v1/stocktakes/{stocktake_id}/table

Request

  • Base URL: https://api.app.tightly.io
  • URL: https://api.app.tightly.io/api/v1/stocktakes/{stocktake_id}/table
  • Auth: HTTP bearer

Path parameters

stocktake_idinteger required
Example:1

The count whose lines to read.

Query parameters

searchstring
Example:CREW-NAVY

Match against product title and SKU.

limitinteger
Example:25

How many rows to return. Defaults to 25; the platform cap is 10,000.

offsetinteger

How many rows to skip. Page against filtered_max_size, not max_size.

line_scope'all' | 'differences' | 'uncounted'
Example:uncounted

Which lines to return. all is every line in the count. differences returns only counted lines whose count differs from system stock, leaving out both the matched lines and the uncounted ones. uncounted returns only the lines nobody has counted yet, which is the work left.

variance_onlyboolean
Example:true

The older spelling of line_scope=differences, honoured where line_scope is not given. Prefer line_scope.

sort_argsstring
Example:-variance

Sort fields, comma-separated, - for descending. One of product_title, sku, location_name, system_quantity, counted_quantity, variance, variance_value.

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

One page of the count's lines, system against counted.

messageobject

severity, service and desc.

Changes

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