Docs / Catalog

History and provenance

Where each fact came from, every change to an item, and a feed of changes to sync against.

Provenance

Each item's provenance says which source set each field, and when:

"provenance": {
  "min_players": { "source": "wikidata", "url": "https://www.wikidata.org/wiki/Q17271", "at": "2026-10-05T03:17:19Z" },
  "max_playtime": { "source": "shopify:catanshop.com", "url": "https://…", "at": "…" }
}

GET /v1/sources lists every source with its kind (manufacturer, open_data, community, other), url, and license.

An item's history

curl "https://tablearchive.dev/v1/items/the-settlers-of-catan/history" -H "Authorization: Bearer $TA_KEY"

Returns events, newest first, each with a type (created, updated, merged, photo_added, photo_removed), the changes as from/to pairs, who submitted and approved it, and the source. Takes limit and offset.

Syncing

To keep a copy up to date, poll the global feed with the highest event id you have seen:

curl "https://tablearchive.dev/v1/events?after=14172&limit=200" -H "Authorization: Bearer $TA_KEY"

With after, events come oldest first, so you can process them in order and store the last id. Without it, they come newest first. Filter by type to watch only, say, photo_added.

Each event names its item_id, so a sync loop is: fetch events, collect the item ids, re-fetch those items.

Previous← Credits, terms, relations NextSubmissions →