← Purchases APIDelete all purchases that match the given filter criteria. Uses the same filter parameters as the list endpoint, plus a filter_hash for optimistic concurrency — ensuring you delete exactly what the user saw.
How filter_hash works
Call the list endpoint with your filters — the response includes a filter_hash
Pass that filter_hash in the body of this request along with the same filters
If the filters changed between the two calls, the server returns 409 Conflict
This prevents accidental mass deletions when filters have been modified.
Request
Headers
string
required
Your API key for authenticationExample:sk_live_1234567890abcdef
string
required
Your organization UUIDExample:a8315ef3-dd50-43f8-b7ce-d839e68d51fa
Query Parameters
No filter is required: without one the delete covers every purchase the unfiltered list shows (the header organization, or under group view the accepted family narrowed by organization_id[], and the project scope when it is on). Supports all the same filters as the list endpoint:
string
Filter purchases on or after this date (YYYY-MM-DD)
string
Filter purchases on or before this date (YYYY-MM-DD)
string
Search by description or supplier name
string[]
Filter by status. Values: active, error, in_progress, in_review, inactive, pending
string[]
Filter by calculation methodology. Values: spend_based, supplier_specific, average_data
string[]
Filter by expense classification. Values: capex, opex
string[]
Filter by file UUID
string[]
Filter by supplier UUID
string[]
Filter by currency unit UUID
string
Filter records created on or after this date
string
Filter records created on or before this date
string
Filter by CO2e calculation status
Body Parameters
string
required
Hash from the list endpoint response. Must match the current filter set.
Response
string[]
UUIDs of successfully deleted purchases
object[]
Failed deletions with reason
Example
# Step 1: Get filter_hash from listRESPONSE=$(curl -s "https://api.dcycle.io/v1/purchases?expense_type[]=opex&purchase_date_to=2024-12-31" \ -H "x-api-key: ${DCYCLE_API_KEY}" \ -H "x-organization-id: ${DCYCLE_ORG_ID}")FILTER_HASH=$(echo $RESPONSE | jq -r '.filter_hash')# Step 2: Bulk delete with the same filterscurl -X POST "https://api.dcycle.io/v1/purchases/bulk-delete-by-filters?expense_type[]=opex&purchase_date_to=2024-12-31" \ -H "x-api-key: ${DCYCLE_API_KEY}" \ -H "x-organization-id: ${DCYCLE_ORG_ID}" \ -H "Content-Type: application/json" \ -d "{\"filter_hash\": \"${FILTER_HASH}\"}"
import requestsimport osheaders = { "x-api-key": os.getenv("DCYCLE_API_KEY"), "x-organization-id": os.getenv("DCYCLE_ORG_ID"),}filters = {"expense_type[]": "opex", "purchase_date_to": "2024-12-31"}# Step 1: Get filter_hash from listlist_resp = requests.get( "https://api.dcycle.io/v1/purchases", headers=headers, params=filters,)filter_hash = list_resp.json()["filter_hash"]# Step 2: Bulk delete with the same filtersdelete_resp = requests.post( "https://api.dcycle.io/v1/purchases/bulk-delete-by-filters", headers={**headers, "Content-Type": "application/json"}, params=filters, json={"filter_hash": filter_hash},)result = delete_resp.json()print(f"Deleted: {len(result['deleted'])} | Failed: {len(result['failed'])}")