API v1
v1
View as Markdown

List the timeline of a possession

GET /api/v1/vaults/{vault}/possessions/{possession}/timeline

List everything that happened to a possession, the newest first.

An entry comes from each transaction, insurance record, valuation, provenance event, maintenance record and stay, and from each loan once it started and again once it came back. A planned loan gives none. A provenance event that a loan or a transaction wrote gives none, since the loan or the transaction already gives that moment.

On the same day, the latest recorded comes first. Entries without a date come last.

This endpoint also answers QUERY, with the same parameters sent in the request body. How QUERY works.

Parameters

Sent as JSON. Anything not listed here is ignored.

vault string Required

The vault the possession is kept in, named either by the readable name it reports as slug or by its id. A vault of another account answers 404.

possession uuid Required

The id of the possession. A possession of another vault or of another account answers 404.

section string Optional

Only the entries of this section: transactions, insurance, valuations, provenance, maintenance, loans or locations. Anything else answers 422.

Returns

Every entry of the timeline, or an empty list. A vault or a possession of another account answers 404.

data array

Every entry of the timeline, whole rather than a page at a time, the newest first and the undated last.

data[] object

One entry.

data[].type string

Always possession_timeline_entry. An entry is computed, so it has no id of its own.

data[].attributes object

What the entry says.

data[].attributes.section string

The section it is read from: transactions, insurance, valuations, provenance, maintenance, loans or locations.

data[].attributes.kind string

What happened: transaction, insurance, valuation, provenance, maintenance, loan_started, loan_returned or stay. A loan that came back gives two entries, one of each loan kind.

data[].attributes.date string

When it happened, written as 2026-11-02, or null when nobody knows.

data[].attributes.date_precision string

How precise the date is: day, month, year, circa or unknown. Only a provenance event is ever less precise than a day.

data[].attributes.is_current boolean

Whether this is the valuation giving the current value, or the stay where the possession is now.

data[].attributes.is_acquisition boolean

Whether this transaction brought the possession in: a purchase, an exchange, a gift received or an inheritance.

data[].attributes.record_id uuid

The id of the record the entry is read from.

data[].links object

Where to find the record.

data[].links.record string

The absolute address the record is read from, in its own section.

Rate limit

Sixty requests per minute, per user, shared by every key and device. Every answer carries the budget left in X-RateLimit-Remaining.

GET
curl https://my.monicahq.com/api/v1/vaults/dunder-mifflin/possessions/5e2c8a14-7d39-4b61-a0f3-c9e18b2d4f70/timeline \
-H "Authorization: Bearer $MONICA_TOKEN"
const response = await fetch('https://my.monicahq.com/api/v1/vaults/dunder-mifflin/possessions/5e2c8a14-7d39-4b61-a0f3-c9e18b2d4f70/timeline', {
headers: { Authorization: `Bearer ${token}` },
})
const data = await response.json()
$response = Http::withToken($token)->get('https://my.monicahq.com/api/v1/vaults/dunder-mifflin/possessions/5e2c8a14-7d39-4b61-a0f3-c9e18b2d4f70/timeline');
Response 200
{
"data": [
{
"type": "possession_timeline_entry",
"attributes": {
"section": "loans",
"kind": "loan_returned",
"date": "2026-11-02",
"date_precision": "day",
"is_current": false,
"is_acquisition": false,
"record_id": "8a3f1c60-2b47-4e9d-b1a5-7c0e9d3f2b48"
},
"links": {
"record": "https://my.monicahq.com/api/v1/vaults/dunder-mifflin/possessions/5e2c8a14-7d39-4b61-a0f3-c9e18b2d4f70/loans/8a3f1c60-2b47-4e9d-b1a5-7c0e9d3f2b48"
}
},
{
"type": "possession_timeline_entry",
"attributes": {
"section": "maintenance",
"kind": "maintenance",
"date": "2026-09-14",
"date_precision": "day",
"is_current": false,
"is_acquisition": false,
"record_id": "2c9d4e71-6a15-4f38-9b02-e7f1a3c5d846"
},
"links": {
"record": "https://my.monicahq.com/api/v1/vaults/dunder-mifflin/possessions/5e2c8a14-7d39-4b61-a0f3-c9e18b2d4f70/maintenance-records/2c9d4e71-6a15-4f38-9b02-e7f1a3c5d846"
}
}
]
}

Keys act as you, with exactly the access you have. Make one per integration so you can revoke it alone.