Get Inventory Revaluation
GET/api/cogs-revaluation/:revaluation
Get one inventory revaluation with its full context: the cost movement, the revalued FIFO layer, the document that layer came from, the product and warehouse, and the accounting ledger entries the revaluation posted.
inventory:readGrant this scope to your token under Settings → Developer → Personal Access Tokens.
Authentication: Requires Bearer token (PAT).
Path parameter: {revaluation} — the revaluation ID (numeric).
Layer vs source: fifo_layer_reference / fifo_layer_route identify the FIFO layer itself; origin is the document that created it (purchase order, inbound receipt, assembly, stock take …).
Accounting: ledger.entries[] lists every live journal entry this revaluation posted — one per accounting month it is recognised in — each with its own status, totals, monthly batch and provider-sync state. ledger.sync_status aggregates those worst-first. An empty list means the revaluation moved no accounting balance.
Returns 404 when no revaluation has that ID.
Request
Responses
- 200
- 401
- 403
- 404
- 429
OK
Response Headers
Unauthenticated — the bearer token is missing, revoked, expired, or malformed. Never retry automatically; fix the credential. See the Errors guide.
Forbidden — the token lacks a required scope, the endpoint is not available to API tokens, or the user behind the token lacks the permission. A human must adjust the token scopes or user permissions; do not retry.
Not Found
Response Headers
Rate limited — platform limit is 1,000 requests/min; individual tokens may carry lower limits. Honor the Retry-After header before retrying. See the Rate Limits guide.