API v1
v1
View as Markdown

List the insurance records of a possession

GET /api/v1/vaults/{vault}/possessions/{possession}/insurance-records

List every insurance record of a possession, active first.

Active records come first, then pending, expired and cancelled ones. Within each status the latest start comes first, an undated record after the dated ones. The list is whole rather than paginated.

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

Path 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.

Returns

Every insurance record object of the possession, or an empty list. A vault or a possession of another account answers 404.

data array

Every one of the possession insurance records, whole rather than a page at a time.

data[] object

One possession insurance record.

data[].type string

Always possession_insurance_record. It names the kind of record, so a caller holding several kinds can tell them apart without looking at where they came from.

data[].id string

The id of this record, as a string even when it reads as a number. It is what every endpoint naming this record takes.

data[].attributes object

Everything the record holds.

data[].attributes.insurer string

Who insures the possession, as text.

data[].attributes.status string

Where the policy stands: active, pending, expired or cancelled. It is the one entered and never follows the dates.

data[].attributes.is_current boolean

Whether this is the record the possession is insured under now: the active one with the latest start.

data[].attributes.policy_number string

The number of the policy, or null.

data[].attributes.coverage string

What the policy covers, or null.

data[].attributes.insured_value string

The value the possession is insured for, as a string with two decimals.

data[].attributes.excess string

What is paid before the insurer pays, or null when it is not recorded.

data[].attributes.currency string

The currency of the insured value and the excess, in lower case. Nothing is ever converted.

data[].attributes.starts_on string

The day the policy period starts, written as 2026-01-01, or null.

data[].attributes.ends_on string

The day the policy period ends or renews, or null for a policy with no end date.

data[].attributes.is_listed_individually boolean

Whether the policy names this possession, rather than covering it under the general contents of the home.

data[].attributes.contact_name string

Who to call at the insurer, or null.

data[].attributes.contact_email string

The email of that person, or null.

data[].attributes.contact_phone string

The phone of that person, or null.

data[].attributes.note string

Conditions, exclusions, what the insurer asked for, or null.

data[].attributes.created_at timestamp

When the record was added, as a count of seconds since 1970.

data[].attributes.updated_at timestamp

When it last changed, as a count of seconds, or null.

data[].links object

Where to find this record.

data[].links.self string

The absolute address this record is read from.

data[].links.web string

The Insurance section of the possession in the application, which opens for somebody signed in rather than for a key. It is the link to give a person.

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/9c4e2a71-5b38-4f06-8d1e-2a7f3c6b9e15/insurance-records \
-H "Authorization: Bearer $MONICA_TOKEN"
const response = await fetch('https://my.monicahq.com/api/v1/vaults/dunder-mifflin/possessions/9c4e2a71-5b38-4f06-8d1e-2a7f3c6b9e15/insurance-records', {
headers: { Authorization: `Bearer ${token}` },
})
const data = await response.json()
$response = Http::withToken($token)->get('https://my.monicahq.com/api/v1/vaults/dunder-mifflin/possessions/9c4e2a71-5b38-4f06-8d1e-2a7f3c6b9e15/insurance-records');
Response 200
{
"data": [
{
"type": "possession_insurance_record",
"id": "5a2e8c14-6b3f-4d71-9e08-c7f1a3b5d2e6",
"attributes": {
"insurer": "Sabre Insurance",
"status": "active",
"is_current": true,
"policy_number": "SAB-2026-0042",
"coverage": "Theft, fire and accidental damage",
"insured_value": "500.00",
"excess": "50.00",
"currency": "usd",
"starts_on": "2026-01-01",
"ends_on": "2027-01-01",
"is_listed_individually": true,
"contact_name": "Gabe Lewis",
"contact_email": "[email protected]",
"contact_phone": null,
"note": "Not covered when Michael lends it to Dwight.",
"created_at": 1761436800,
"updated_at": 1761436800
},
"links": {
"self": "https://my.monicahq.com/api/v1/vaults/dunder-mifflin/possessions/9c4e2a71-5b38-4f06-8d1e-2a7f3c6b9e15/insurance-records/5a2e8c14-6b3f-4d71-9e08-c7f1a3b5d2e6",
"web": "https://my.monicahq.com/vaults/dunder-mifflin/possessions/9c4e2a71-5b38-4f06-8d1e-2a7f3c6b9e15/insurance"
}
},
{
"type": "possession_insurance_record",
"id": "e09b4d27-3c58-4a1f-8b62-1d7e5f9a0c34",
"attributes": {
"insurer": "Utica Assurance",
"status": "expired",
"is_current": false,
"policy_number": null,
"coverage": "Office contents",
"insured_value": "300.00",
"excess": null,
"currency": "usd",
"starts_on": "2019-11-05",
"ends_on": "2025-12-31",
"is_listed_individually": false,
"contact_name": null,
"contact_email": null,
"contact_phone": null,
"note": null,
"created_at": 1761440400,
"updated_at": 1761440400
},
"links": {
"self": "https://my.monicahq.com/api/v1/vaults/dunder-mifflin/possessions/9c4e2a71-5b38-4f06-8d1e-2a7f3c6b9e15/insurance-records/e09b4d27-3c58-4a1f-8b62-1d7e5f9a0c34",
"web": "https://my.monicahq.com/vaults/dunder-mifflin/possessions/9c4e2a71-5b38-4f06-8d1e-2a7f3c6b9e15/insurance"
}
}
]
}

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