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.
| Parameter | Description |
|---|---|
since | only deletions since that instant (ISO 8601 with time zone) |
type | product, batch, category, brand or store |
limit, cursor | pagination |
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 }
}
| Field | Description |
|---|---|
type | type of the deleted item |
id | id of the deleted item |
deleted_at | when it was deleted |
See how to use it together with updated_since in Pagination and sync.