# Get a life event

`GET /api/v1/vaults/{vault}/life-events/{lifeEvent}`

Retrieve one life event, with who was there and the values of its custom fields.

The value of a sensitive field comes back as null, with is_hidden set to true, unless the key holds the sensitive-fields scope.

This endpoint also answers QUERY, with the same parameters sent in the request body. [How QUERY works](https://my.monicahq.com/docs/api/query-method).

## Path parameters

- `vault` (string, required): The vault the life events live in, named either by the readable name it reports as slug or by its id.
- `lifeEvent` (uuid, required): The id of the life event. One addressed through the wrong vault, or belonging to another account, answers 404.

## Returns

A life event object. One of another account or vault answers 404.

- `data` (object): The life event.
- `data.type` (string): Always life_event. 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.name` (string): What the life event is called: its title, or the name of its type when it has none.
- `data.attributes.title` (string): The title written for it, or null.
- `data.attributes.life_event_type` (object): Its type. A type deleted since still names the life events recorded as it.
- `data.attributes.life_event_type.id` (uuid): The id of the type, as the life event types endpoints give it.
- `data.attributes.life_event_type.name` (string): What the type is called.
- `data.attributes.group` (object): The group it was recorded on, as an object holding its id and its name, or null when it was not recorded on a group or the group has been deleted.
- `data.attributes.happened_on` (string): The day it happened, written as a year, a month and a day.
- `data.attributes.duration_in_minutes` (integer): How long it lasted, in minutes, or null.
- `data.attributes.narrative` (string): What was written about it, or null.
- `data.attributes.location` (string): Where it happened, or null.
- `data.attributes.participants` (array): The contacts who were there, in order. The first is the person the life event is recorded for.
- `data.attributes.participants[]` (object): One contact who was there.
- `data.attributes.participants[].id` (uuid): The id of the contact.
- `data.attributes.participants[].name` (string): The name the contact is shown under.
- `data.attributes.participants[].position` (integer): Where the contact stands in the list, counting from 0.
- `data.attributes.fields` (array): The values of the custom fields its type asks for. A field left empty is not listed.
- `data.attributes.fields[]` (object): One value.
- `data.attributes.fields[].field_id` (string): The id of the field, which is the key a value is written under when the life event is updated.
- `data.attributes.fields[].key` (string): How the field is named in an import or an export. It is unique inside its group only.
- `data.attributes.fields[].label` (string): What the field is called on the life event.
- `data.attributes.fields[].type` (string): The kind of field: text, date, select, address and so on.
- `data.attributes.fields[].row` (integer): For a field inside a repeating group, the id of the repetition it belongs to, which is the id an update keeps that repetition by. Null otherwise.
- `data.attributes.fields[].value` (string): The value, written as the contact page shows it. A file field gives the name of the file. Null when hidden.
- `data.attributes.fields[].is_hidden` (boolean): Whether the value was held back because the field is sensitive and the key does not hold the sensitive-fields scope.
- `data.attributes.created_from` (string): Where it was written from: contact, dashboard, group, api, mcp, day, import or module.
- `data.attributes.deleted_at` (timestamp): When it was deleted, as a count of seconds since 1970, or null.
- `data.attributes.created_at` (timestamp): When it was written down, as a count of seconds since 1970.
- `data.attributes.updated_at` (timestamp): When it last changed, as a count of seconds since 1970.
- `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 page of the contact the life event is recorded for, whose timeline shows it, in the application. 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`.

## Request

```sh
curl https://my.monicahq.com/api/v1/vaults/dunder-mifflin/life-events/7c1e5a92-4b3d-4f80-a6e2-93d0b1c4f857 \
  -H "Authorization: Bearer $MONICA_TOKEN"
```

```javascript
const response = await fetch('https://my.monicahq.com/api/v1/vaults/dunder-mifflin/life-events/7c1e5a92-4b3d-4f80-a6e2-93d0b1c4f857', {
  headers: { Authorization: `Bearer ${token}` },
})
const data = await response.json()
```

```php
$response = Http::withToken($token)->get('https://my.monicahq.com/api/v1/vaults/dunder-mifflin/life-events/7c1e5a92-4b3d-4f80-a6e2-93d0b1c4f857');
```

## Response

`200`

```json
{
    "data": {
        "type": "life_event",
        "id": "7c1e5a92-4b3d-4f80-a6e2-93d0b1c4f857",
        "attributes": {
            "name": "Lunch at Cugino’s",
            "title": "Lunch at Cugino’s",
            "life_event_type": {
                "id": "b2f4d6a8-1c3e-4a5b-8d7f-0e9c2b4a6d81",
                "name": "Meal"
            },
            "group": null,
            "happened_on": "2026-10-09",
            "duration_in_minutes": 60,
            "narrative": "Michael insisted on paying, then asked for the receipt.",
            "location": "Scranton",
            "participants": [
                {
                    "id": "0d3f9b2e-6a41-4c7d-9e58-2b1a7c4e6f90",
                    "name": "Pam Beesly",
                    "position": 0
                },
                {
                    "id": "e5a8c1f3-7b29-4d06-8a4e-5c2d9f1b3a67",
                    "name": "Jim Halpert",
                    "position": 1
                }
            ],
            "fields": [
                {
                    "field_id": "412",
                    "key": "dish",
                    "label": "Dish",
                    "type": "text",
                    "row": null,
                    "value": "Chicken parm",
                    "is_hidden": false
                }
            ],
            "created_from": "api",
            "deleted_at": null,
            "created_at": 1791547200,
            "updated_at": 1791547200
        },
        "links": {
            "self": "https://my.monicahq.com/api/v1/vaults/dunder-mifflin/life-events/7c1e5a92-4b3d-4f80-a6e2-93d0b1c4f857",
            "web": "https://my.monicahq.com/vaults/dunder-mifflin/contacts/pam-beesly"
        }
    }
}
```
