Bulk Delete Bills

DELETE 
/api/bills

Bulk delete landed cost bills by explicit IDs or by list filters ("all filtered" scope).

Required scope: purchase-orders:write

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

Provide ONE of:

• ids — array of bill IDs (each must exist)
• filters — object of List Bills filter params (same keys as the filter[...] query params, plus optional filter_groups); the matching bill IDs are resolved server-side
• apply_to_all: true — delete ALL bills (optionally narrowed by filters); without this flag an empty/missing filters object deletes nothing

Behavior:

• 25 bills or fewer → deleted synchronously; response includes per-bill results
• More than 25 bills → dispatched as a Tracked Job (Delete Landed Cost Bills: N bill(s)); response returns tracked_job_log_id for the tracked job log endpoints
• Deleting a bill removes its lines/allocations and triggers FIFO landed-cost recalculation on affected layers

Authentication: Requires Bearer token. Scope: purchase-orders (read/write).

Request

Responses

200

OK

Response Headers

Content-Type

401

Unauthenticated — the bearer token is missing, revoked, expired, or malformed. Never retry automatically; fix the credential. See the Errors guide.

403

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.

422

Unprocessable Entity

Response Headers

Content-Type

429

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.