# Adds loans of a possession

12 November 2026 · Added · Possession loans

Record a possession lent to a contact of its vault or borrowed from one, then list, get, change (including marking it as returned) and delete the loan. A possession has at most one active loan.

## Why it changed

Who has a possession and when it is due back had no place in the API. A loan changes no owner, so it records no transaction. Name a contact with contact_id, or write a new one down with new_contact.

## Changes

- `loans` (Added): `GET /api/v1/vaults/{vault}/possessions/{possession}/loans`, `GET /api/v1/vaults/{vault}/possessions/{possession}/loans/{loan}`, `POST /api/v1/vaults/{vault}/possessions/{possession}/loans`, `PUT /api/v1/vaults/{vault}/possessions/{possession}/loans/{loan}`, `DELETE /api/v1/vaults/{vault}/possessions/{possession}/loans/{loan}`

## In the same release

- Added: [Adds the current value of a possession](https://my.monicahq.com/docs/api/changelog/possession-current-value.md)
- Added: [Adds a compact list of possessions](https://my.monicahq.com/docs/api/changelog/possession-compact-list.md)
- Added: [Adds valuations of a possession](https://my.monicahq.com/docs/api/changelog/possession-valuations.md)
- Added: [Adds the provenance of a possession](https://my.monicahq.com/docs/api/changelog/possession-provenance.md)
- Added: [Adds the location history of a possession](https://my.monicahq.com/docs/api/changelog/possession-location-stays.md)

## Example

POST loans

```
{ "direction": "lent", "status": "active", "contact_id": "<contact id>", "started_on": "2026-11-01" }
```
