## List provenance events

`GET https://getkollek.com/api/copies/{copy}/provenance-events`

Retrieve the documented story of a copy: how it was acquired, who held it, where it was shown, when it was authenticated. Provenance reads as a narrative rather than as a feed, so events are returned oldest first, and an undated event sorts to the front.

No amounts live here. Prices, taxes, fees and shipping belong to the transaction and are never duplicated onto the event, so an event that came from an exchange sets `transaction_id` and you read the money from the transaction itself.

A transaction is one exchange, so it can be the source of at most one event. Deleting a linked transaction unlinks the event rather than deleting it: the moment in the object story outlives the record of what was paid for it.

Provenance dates are frequently uncertain, so every date is paired with `occurred_at_precision`. A precision of unknown stores no date at all, and `formatted_date` is the read only rendering of the date at its precision, which is what you should show rather than formatting `occurred_at` yourself.

**Permissions:** Any member of the account.

### Path parameters

- `copy` (integer, required): The ID of the copy the provenance event belongs to.

### Query parameters

- `per_page` (integer, optional): The number of provenance events to return per page, between 1 and 100. Default: `10`.
- `page` (integer, optional): The page number to return. Default: `1`.

**Returns:** A paginated list of provenance event objects.

### Example request

```bash
curl https://getkollek.com/api/copies/1/provenance-events \
  -H "Authorization: Bearer $API_KEY" \
  -H "Accept: application/json"
```

### Example response

`Status: 200`

```json
{
    "data": [
        {
            "type": "provenance_event",
            "id": "1",
            "attributes": {
                "copy_id": "1",
                "transaction_id": null,
                "type": "origin",
                "title": "Printed in New York",
                "description": null,
                "occurred_at": 550972800,
                "occurred_at_precision": "year",
                "formatted_date": "1987",
                "location": "New York",
                "from_party": "Central Perk Collectibles",
                "to_party": "Ross Geller",
                "reference_number": null,
                "source_url": null,
                "is_verified": false,
                "verification_note": null,
                "created_at": 1752537600,
                "updated_at": 1752537600
            },
            "links": {
                "self": "https://getkollek.com/api/copies/1/provenance-events/1"
            }
        },
        {
            "type": "provenance_event",
            "id": "2",
            "attributes": {
                "copy_id": "1",
                "transaction_id": "1",
                "type": "acquisition",
                "title": "Bought at the Central Perk estate sale",
                "description": null,
                "occurred_at": 1752537600,
                "occurred_at_precision": "exact",
                "formatted_date": "July 15, 2025",
                "location": "New York",
                "from_party": "Central Perk Collectibles",
                "to_party": "Ross Geller",
                "reference_number": null,
                "source_url": null,
                "is_verified": false,
                "verification_note": null,
                "created_at": 1752537600,
                "updated_at": 1752537600
            },
            "links": {
                "self": "https://getkollek.com/api/copies/1/provenance-events/2"
            }
        }
    ],
    "links": {
        "first": "https://getkollek.com/api/copies/1/provenance-events?page=1",
        "last": "https://getkollek.com/api/copies/1/provenance-events?page=1",
        "prev": null,
        "next": null
    },
    "meta": {
        "current_page": 1,
        "from": 1,
        "last_page": 1,
        "links": [
            {
                "url": null,
                "label": "« Previous",
                "active": false
            },
            {
                "url": "https://getkollek.com/api/copies/1/provenance-events?page=1",
                "label": "1",
                "active": true
            },
            {
                "url": null,
                "label": "Next »",
                "active": false
            }
        ],
        "path": "https://getkollek.com/api/copies/1/provenance-events",
        "per_page": 10,
        "to": 2,
        "total": 2
    }
}
```