Deleted Items
When a record leaves the catalog, your delta sync sees a compact tombstone row on the same dateModifiedFrom loop — one watermark covers both updates and removals.
What a tombstone is
A tombstone is the same envelope as a normal feed row, stripped down to the bare identifying fields plus a removal marker. It tells a long-lived mirror that an identifier it cached has left the catalog — hard-deleted, soft-deleted (“trashed”), or merged into another record — so you can drop or redirect the row. Removals ride the same delta loop you already run for updates: there is no second endpoint and no second watermark.
When they appear
Only on delta polls — never on catalog browsing.
Tombstones require dateModifiedFrom
dateModifiedFrom. Queries without it (catalog browsing) never return tombstones — they would just be noise. A tombstone’s dateModified equals the moment the removal happened, so the same watermark that catches updates catches the removal.deletionStatus values
A single discriminator carries the removal class. Live rows omit the field entirely.
| Value | Meaning | Extra fields | What to do |
|---|---|---|---|
deleted | Hard-deleted upstream. The identifier is gone and will not be re-used. | deletedAt | Drop the row from your cache. |
trashed | Soft-deleted (events only — recoverable upstream). If it returns it arrives as a normal dateModified row. | deletedAt | Treat the same as deleted — drop it. |
merged | Folded into another record. This row’s identifier is the loser; mergedInto is the survivor. | deletedAt, mergedInto | Repoint cached references to mergedInto. |
mergedInto is the next-hop survivor only. If a survivor later merges again, that produces another tombstone pointing at the next survivor — walk merges as they arrive across delta windows.
Wire shape
A single delta page can mix live rows and tombstones.
A page from GET /v3/events?dateModifiedFrom=2026-04-12T00:00:00Z can include a live row, a deleted row, and a merged row together. Tombstone rows carry only @type, identifier, deletionStatus, deletedAt, dateModified, and (on merged) mergedInto — everything else is omitted.
{"success": { "code": 200 },"pagination": {"page": 1, "perPage": 40, "totalItems": 3, "totalPages": 1,"nextPage": null, "previousPage": null},"events": [{"@type": "Concert","identifier": "jambase:16100021","name": "Phish at Madison Square Garden","eventStatus": "scheduled","dateModified": "2026-04-12T