## List loans of a copy

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

Retrieve the loans recorded against a copy: the pieces lent out and the pieces borrowed in. They are returned newest first.

A loan moves custody without moving ownership. An outgoing loan that is active or overdue means the copy is not currently in your physical custody, and the copy reads as loaned out while one is outstanding.

A loan marked for provenance generates a matching provenance event for the loan and, once it is returned, another for the return, so an institutional loan or an exhibition 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 loan belongs to.

### Query parameters

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

### Example request

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

### Example response

`Status: 200`

```json
{
    "data": [
        {
            "type": "loan",
            "id": "2",
            "attributes": {
                "copy_id": "1",
                "loan_provenance_event_id": null,
                "return_provenance_event_id": null,
                "direction": "outgoing",
                "status": "active",
                "party": "The Whitney Museum",
                "purpose": "Retrospective exhibition, east wing.",
                "loaned_at": 1704067200,
                "due_at": 1719792000,
                "returned_at": null,
                "item_condition_out_id": "1",
                "item_condition_in_id": null,
                "deposit_amount": 250000,
                "deposit_currency_code": "USD",
                "include_in_provenance": true,
                "created_at": 1752537600,
                "updated_at": 1752537600
            },
            "context": {
                "item_name": "Amazing Spider-Man #1",
                "copy_identifier": "CBX-042",
                "collection_name": "My Comics"
            },
            "links": {
                "self": "https://getkollek.com/api/copies/1/loans/2"
            }
        },
        {
            "type": "loan",
            "id": "1",
            "attributes": {
                "copy_id": "1",
                "loan_provenance_event_id": null,
                "return_provenance_event_id": null,
                "direction": "incoming",
                "status": "returned",
                "party": "A private collector",
                "purpose": "Retrospective exhibition, east wing.",
                "loaned_at": 1704067200,
                "due_at": 1719792000,
                "returned_at": null,
                "item_condition_out_id": "1",
                "item_condition_in_id": null,
                "deposit_amount": 250000,
                "deposit_currency_code": "USD",
                "include_in_provenance": true,
                "created_at": 1752537600,
                "updated_at": 1752537600
            },
            "context": {
                "item_name": "Amazing Spider-Man #1",
                "copy_identifier": "CBX-042",
                "collection_name": "My Comics"
            },
            "links": {
                "self": "https://getkollek.com/api/copies/1/loans/1"
            }
        }
    ],
    "links": {
        "first": "https://getkollek.com/api/copies/1/loans?page=1",
        "last": "https://getkollek.com/api/copies/1/loans?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/loans?page=1",
                "label": "1",
                "active": true
            },
            {
                "url": null,
                "label": "Next »",
                "active": false
            }
        ],
        "path": "https://getkollek.com/api/copies/1/loans",
        "per_page": 10,
        "to": 2,
        "total": 2
    }
}
```