Get Cost and Count Trust
GET/api/ledger/trust
How far the account's costs and month-end inventory counts can be trusted. Computed live; never writes.
accounting:readGrant this scope to your token under Settings → Developer → Personal Access Tokens.
Authentication: Requires Bearer token + accounting.index permission.
Cost trust (cost): the share of on-hand stock value whose unit cost rests on each basis, weighted: supplier invoice 1.0; purchase order price, transfers/manufacturing and customer returns 0.8; estimated landed cost 0.7; costs typed into a count or adjustment 0.6; average/backfilled 0.4; imported estimate 0.3; no cost 0 (stock with no cost is valued at the product's average cost). percent is the effective figure (an override replaces it), computed_percent is always the computed one. self_report is the confidence the account stated, shown beside the computed figure and never blended into it. gap_warning is true when the stated confidence is at least 95 while the computed figure is below 60. Consignment stock is excluded.
Count trust (count): per warehouse, per month end, what the quantity rests on: a full count that month (95), cycle counts covering at least the configured share of stocked value (85), a full count in the previous 3 months (75), a 3PL or fulfillment network with a complete audit trail (70), a 3PL with a partial or unrated trail (45), or nothing (percent null, label unknown). Months before a warehouse held stock are not_applicable. Coverage is measured against value on hand today. Supplier and virtual warehouses are excluded. Only physical counts qualify: stock takes that accept a 3PL's reported quantity, adjustment-mode stock takes, and discrepancy or catch-up stock takes are not counts. A full count only carries forward on a 3PL whose audit trail is rated Complete. Supplier invoices marked provisional do not count as supplier evidence.
Labels: high (85+), medium (60-84), low (30-59), estimate (below 30), unknown, not_applicable.
3PL audit trail (audit_trail, 3PL warehouses only): the rating somebody confirmed, plus a suggestion with its evidence. A warehouse holding kits or kit components whose 3PL ledger shows no kit or assembly event is suggested partial.
Last cost check (cost.last_validation): the latest confirmed check of the account's costs against its supplier documents (see Cost Validation): documents read, products confirmed, stock layers marked invoice-backed, cost trust before and after, who confirmed it and when. Null when none is in effect.
Request
Responses
- 200
- 401
- 403
- 422
- 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.
Unprocessable Content
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.