## Get a copy's history

`GET https://getkollek.com/api/copies/{copy}/history`

Retrieve the unified history of a copy: its qualifying transactions, provenance events, valuations, insurance records, meaningful maintenance, loans and returns, and location moves, merged into one chronological read, newest first.

The history is a read model, not a stored table. Every entry is assembled from a source record at read time, and each source stays the source of truth for its own data. An entry names the source it came from through source_type and source_id, so you can fetch the full record from its own endpoint.

Only the historically meaningful entries are returned by default. Pass view=complete to add the routine records. Undated entries, and provenance events recorded as unknown, sort to the end. Amounts are returned in cents in the currency they were recorded in, and are never converted.

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

### Path parameters

- `copy` (integer, required): The ID of the copy whose history you are reading.

### Query parameters

- `view` (string, optional): Which entries to include. meaningful returns only the historically meaningful ones; complete adds the routine records too, such as ordinary location moves, informal loans and routine maintenance. Default: `meaningful`.
- `type` (array, optional): Filter to one or more sources, sent as repeated type parameters (type[]=valuation&type[]=loan). One of transaction, provenance, valuation, insurance, maintenance, loan or location. Omit to include every source.

**Returns:** A list of timeline entry objects, newest first.

### Example request

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

### Example response

`Status: 200`

```json
{
    "data": [
        {
            "type": "timeline_entry",
            "id": "location-9",
            "attributes": {
                "source_type": "location",
                "source_id": "9",
                "title": "Moved to Secure storage",
                "summary": "Climate-controlled unit",
                "date": 1782777600,
                "date_precision": "exact",
                "amount": null,
                "currency_code": null,
                "meaningful": false
            }
        },
        {
            "type": "timeline_entry",
            "id": "loan-4-return",
            "attributes": {
                "source_type": "loan",
                "source_id": "4",
                "title": "Returned from Montreal Museum of Fine Arts",
                "summary": "Condition in: Excellent",
                "date": 1743465600,
                "date_precision": "exact",
                "amount": null,
                "currency_code": null,
                "meaningful": true
            }
        },
        {
            "type": "timeline_entry",
            "id": "valuation-5",
            "attributes": {
                "source_type": "valuation",
                "source_id": "5",
                "title": "Professional appraisal",
                "summary": "Jane Smith",
                "date": 1325376000,
                "date_precision": "exact",
                "amount": 450000,
                "currency_code": "CAD",
                "meaningful": true
            }
        },
        {
            "type": "timeline_entry",
            "id": "provenance-2",
            "attributes": {
                "source_type": "provenance",
                "source_id": "2",
                "title": "Acquired from Sotheby's",
                "summary": "Purchased at the London spring sale.",
                "date": 542764800,
                "date_precision": "month",
                "amount": null,
                "currency_code": null,
                "meaningful": true
            }
        }
    ]
}
```