List Applicable Bills for Vendor Deposit
GET/api/vendor-deposits/:vendorDepositId/applicable-bills
List open purchase invoices (bills) from the deposit's supplier that the deposit can be applied to, including each bill's outstanding balance after payments and previously applied deposits. Returns up to 100 bills.
accounting:readGrant this scope to your token under Settings → Developer → Personal Access Tokens.
Each bill includes a suggested boolean: true when the deposit carries a third-party purchase order reference and the bill belongs to that referenced PO — those bills sort first. The suggestion is advisory; any listed bill can be applied.
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.