Skip to main content

Search COGS Revaluations

POST 
/api/cogs-revaluation

Returns the same paginated inventory revaluation ledger as the GET version of this endpoint, but accepts filters as a JSON request body instead of the query string. Use this POST variant when the filter set is too large or too complex to fit in a URL (for example, deeply nested AND/OR filter groups or long lists of values).

Required scope: inventory:write

Grant this scope to your token under Settings → Developer → Personal Access Tokens.

Provide advanced filters under filter_groups, a tree of conditions combined with a conjunction of and or or. Each condition names a column, an operator, and a value.

Text columns (reason, cogs_source, reason_notes, sku, product_name) accept: is, is_not, contains, does_not_contain, starts_with, ends_with, is_empty, is_not_empty, is_one_of, is_not_one_of. Numeric and date columns (id, fifo_layer_id, old_unit_cost, new_unit_cost, units_on_hand_at_time, product_id, warehouse_id, effective_at, posted_at, created_at) accept: is, is_not, greater_than, greater_than_or_equal, less_than, less_than_or_equal, between, is_empty, is_not_empty.

Sortable columns (via sort, prefix with - for descending): id, effective_at, posted_at, new_unit_cost, old_unit_cost, reason, cogs_source, created_at, product, warehouse. Results default to -effective_at. The legacy effective_from / effective_to date-range filters remain supported.

Request​

Responses​

OK

Response Headers
    Content-Type