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.
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
The count whose lines to read.
Query parameters
Match against product title and SKU.
How many rows to return. Defaults to 25; the platform cap is 10,000.
How many rows to skip. Page against filtered_max_size, not max_size.
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.
The older spelling of line_scope=differences, honoured where line_scope is not given. Prefer line_scope.
Sort fields, comma-separated, - for descending. One of product_title, sku, location_name, system_quantity, counted_quantity, variance, variance_value.
Headers
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.
Changes
No recorded changes to this operation across all 1 revision of this API.