List Vendor Credit Inventory Movements
GET/api/vendor-credits/:vendor_credit/inventory-movements
Paginated inventory movements posted against a vendor credit: write-off movements on credit lines and outbound movements from return shipments. Each row includes the product, warehouse, quantity, and the FIFO layer and unit cost where known; unit_cost_provisional is true for rows whose cost is estimated from the product's current unit cost because no layer was consumed.
accounting:readGrant this scope to your token under Settings → Developer → Personal Access Tokens.
Sortable by id, inventory_movement_date, type, inventory_status, quantity, reference, and created_at (default: -inventory_movement_date). Text filters on type, inventory_status, and reference support the advanced-filter operators (is / contains / starts_with / etc.); quantity supports numeric comparisons and inventory_movement_date / created_at support date comparisons.
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 — no record with the given identifier (or the route does not exist). Verify the ID before retrying.
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.