## List all loans

`GET https://getkollek.com/api/loans`

Retrieve every loan in your account, across all copies, newest first. This is the account-wide view the Loans section is built on. Optional filters narrow the list by direction and status.

A loan moves custody without moving ownership. Each entry carries a context block with the object it is about (item name, copy identifier and collection), so a list is readable without a second request per loan.

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

### Query parameters

- `direction` (string, optional): Narrow the list to one direction: outgoing (lent out) or incoming (borrowed in).
- `status` (string, optional): Narrow the list to one status: planned, active, overdue, returned, cancelled or lost.
- `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/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/loans?page=1",
        "last": "https://getkollek.com/api/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/loans?page=1",
                "label": "1",
                "active": true
            },
            {
                "url": null,
                "label": "Next »",
                "active": false
            }
        ],
        "path": "https://getkollek.com/api/loans",
        "per_page": 10,
        "to": 2,
        "total": 2
    }
}
```