Skip to main content

Deletions (/v1/deletions)

GET /v1/deletions​

Lists what was deleted in the organization in the last 90 days, oldest first. It includes deletions made in the app, on the website and through the API, and cascade deletions (batches of a deleted product, products and batches of a deleted store).

Scope: read.

ParameterDescription
sinceonly deletions since that instant (ISO 8601 with time zone)
typeproduct, batch, category, brand or store
limit, cursorpagination
curl "https://api.validades.com/v1/deletions?since=2026-11-06T13:00:00Z&limit=100" \
-H "Authorization: Bearer vld_live_YOUR_KEY"
{
"data": [
{ "type": "batch", "id": "1f2e…", "deleted_at": "2026-11-06T14:02:11.120Z" },
{ "type": "product", "id": "6b7e…", "deleted_at": "2026-11-06T14:02:11.120Z" }
],
"pagination": { "limit": 100, "has_more": false, "next_cursor": null }
}
FieldDescription
typetype of the deleted item
idid of the deleted item
deleted_atwhen it was deleted

See how to use it together with updated_since in Pagination and sync.