Skip to main content
POST
Bulk Delete Purchases
← Purchases API
Deprecated. Use POST /v2/purchases/delete: up to 5,000 purchases per request, idempotent, deleted asynchronously with their emissions, with webhooks. This endpoint keeps working; its responses carry Deprecation and Link: </v2/purchases/delete>; rel="successor-version" headers. Its responses also carry Sunset: Fri, 30 Apr 2027 00:00:00 GMT: the endpoint is retired on April 30, 2027 (see the changelog).
Delete multiple purchases by their IDs. All purchases must belong to the requesting organization. Related emission records (total_impacts) are automatically deleted to maintain referential integrity. Returns detailed results for each ID, allowing you to handle partial failures gracefully.

Request

Headers

string
required
Your API key for authenticationExample: sk_live_1234567890abcdef
string
required
Your organization UUIDExample: a8315ef3-dd50-43f8-b7ce-d839e68d51fa

Body Parameters

string[]
required
Array of purchase UUIDs to delete (1–100,000 per request)

Response

string[]
UUIDs of successfully deleted purchases
object[]
Failed deletions with reason:

Example

Successful Response

Common Errors

401 Unauthorized

Cause: Missing or invalid API key

403 Forbidden

Cause: The authenticated user is not a member of the organization

422 Validation Error

Cause: Empty array or more than 100,000 IDs

Bulk Delete by Filters

Delete all purchases matching filter criteria

List Purchases

Browse and filter purchases