## List maintenance records

`GET https://getkollek.com/api/copies/{copy}/maintenance-records`

Retrieve the work logged against a copy: the cleanings, repairs, servicings, conservations, restorations, replacements and inspections it has been through. They are returned newest first.

Maintenance costs live on this model rather than in transactions, so a record carries its own cost and currency.

A record marked for provenance generates a matching provenance event, so a significant restoration or conservation also reads in the object's documented story.

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

### Path parameters

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

### Query parameters

- `per_page` (integer, optional): The number of maintenance records 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 maintenance record objects.

### Example request

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

### Example response

`Status: 200`

```json
{
    "data": [
        {
            "type": "maintenance_record",
            "id": "2",
            "attributes": {
                "copy_id": "1",
                "provenance_event_id": null,
                "type": "conservation",
                "title": "Archival cleaning and re-housing",
                "description": "Surface cleaned and re-boxed in archival storage.",
                "performed_by": "Atelier Restauration",
                "performed_at": 1704067200,
                "cost_amount": 12000,
                "cost_currency_code": "USD",
                "item_condition_before_id": "3",
                "item_condition_after_id": "1",
                "next_due_at": 1735689600,
                "include_in_provenance": false,
                "created_at": 1752537600,
                "updated_at": 1752537600
            },
            "links": {
                "self": "https://getkollek.com/api/copies/1/maintenance-records/2"
            }
        },
        {
            "type": "maintenance_record",
            "id": "1",
            "attributes": {
                "copy_id": "1",
                "provenance_event_id": null,
                "type": "inspection",
                "title": "Annual condition check",
                "description": "Surface cleaned and re-boxed in archival storage.",
                "performed_by": "Atelier Restauration",
                "performed_at": 1704067200,
                "cost_amount": null,
                "cost_currency_code": "USD",
                "item_condition_before_id": "3",
                "item_condition_after_id": "1",
                "next_due_at": 1735689600,
                "include_in_provenance": false,
                "created_at": 1752537600,
                "updated_at": 1752537600
            },
            "links": {
                "self": "https://getkollek.com/api/copies/1/maintenance-records/1"
            }
        }
    ],
    "links": {
        "first": "https://getkollek.com/api/copies/1/maintenance-records?page=1",
        "last": "https://getkollek.com/api/copies/1/maintenance-records?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/maintenance-records?page=1",
                "label": "1",
                "active": true
            },
            {
                "url": null,
                "label": "Next »",
                "active": false
            }
        ],
        "path": "https://getkollek.com/api/copies/1/maintenance-records",
        "per_page": 10,
        "to": 2,
        "total": 2
    }
}
```