Payload
{
"id": "evt_2b7c41e09f6a4b1d8f3e5a7c9d0b1e2f",
"type": "call.analyzed",
"created_at": "2026-11-03T19:12:04.000Z",
"data": {
"call_id": "6f1d2c3b-8a9e-4f70-b1c2-d3e4f5a6b7c8",
"agent_id": "39d63614-2b1a-4c5d-9e8f-7a6b5c4d3e2f",
"caller_phone": "+15551234567",
"called_phone": "+15557654321",
"forwarded_from": "+15553334444",
"funeral_home_phone": "+15553334444",
"started_at": "2026-11-03T19:05:22.000Z",
"ended_at": "2026-11-03T19:11:40.000Z",
"duration_seconds": 378,
"recording": {
"url": "https://app.miraven.com/api/recordings/6f1d2c3b-8a9e-4f70-b1c2-d3e4f5a6b7c8?exp=1777835524&sig=EXAMPLE",
"content_type": "audio/wav",
"expires_at": "2027-05-04T19:12:04.000Z"
}
}
}data attributes
call_idstringMiraven’s ID for the call. Unique and never changes.
agent_idstringThe funeral home agent that answered. Use it to tell funeral homes apart.
caller_phonestring, E.164, or nullThe number the call came from. Null when the caller blocked their caller ID.
called_phonestring, E.164The Miraven number that answered the call.
forwarded_fromstring, E.164, or nullThe number the caller dialed before the call was forwarded to Miraven, when the phone carrier passes it along. A funeral home with several locations can forward each one, so this tells you which location was called. Null when the carrier didn’t say, which doesn’t mean the caller dialed Miraven directly.
funeral_home_phonestring, E.164, or nullThe funeral home’s main number from its Miraven settings, or null if none is set. To get the funeral home number for a call, use forwarded_from when it’s set and this otherwise.
started_atstring, ISO 8601When the call started, in UTC.
ended_atstring, ISO 8601When the call ended, in UTC.
duration_secondsintegerHow long the call lasted, in whole seconds.
recordingobjectThe call’s audio. See Recordings.
urlstringA link to download the recording. No login or headers needed.
content_typestringThe file format:
audio/wav.expires_atstring, ISO 8601When the link stops working, in UTC.
Value formats
| Type | Format | Example |
|---|---|---|
| ID | A UUID. Compare IDs as whole strings; don’t parse them. | "8a1d1f6e-3c2b-4e7a-9f10-2b6c4d5e7f80" |
| Phone number | E.164: a +, the country code, then the number, with no spaces or punctuation. | "+15551234567" |
| Time | ISO 8601 in UTC, to the millisecond. | "2026-11-03T19:05:22.000Z" |
| Duration | A whole number of seconds. | 378 |
| Unknown | Fields marked “or null” are always present, and null when Miraven doesn’t know the value. They’re never left out. | null |
Phone numbers
Most funeral homes forward their own number to Miraven, so a call involves up to three of the funeral home’s numbers. Each field holds one of them, and never a guess. In these examples the funeral home’s Miraven number is +15557654321, its main number is +15553334444, and its second location is +15553336666.
| What happened | forwarded_from | funeral_home_phone |
|---|---|---|
| A family calls the main number, and the phone carrier forwards it to Miraven. | +15553334444 | +15553334444 |
| A family calls the second location, which also forwards to Miraven. | +15553336666 | +15553334444 |
| The call is forwarded, but the carrier or phone system doesn’t say from where. This is common when a business phone system forwards the call. | null | +15553334444 |
| A family dials the Miraven number directly, for example from a website that lists it. | null | +15553334444 |
| The funeral home has no main number saved in Miraven. | +15553334444 | null |
In every case, called_phone is +15557654321 and caller_phone is the family’s number, or null if they blocked their caller ID.
A null forwarded_from doesn’t tell you whether the call was forwarded: some carriers never pass it on. To show which funeral home number a family called, use forwarded_from, and funeral_home_phone when it’s null. To tell funeral homes apart, use agent_id, which stays the same whichever number was called.
Which calls are sent
One event per call the agent answers, except:
- calls from before the funeral home went live on Miraven, like test calls during setup;
- calls with no recording, like a caller hanging up before the agent answered;
- calls Miraven filtered as spam or robocalls;
- calls deleted before they were sent.
Recordings
| Format | Two-channel WAV. Channel 1 is the caller and channel 2 is the funeral home’s side. Transcribing each channel separately gives the best accuracy. |
| Download | A plain GET to recording.url. |
| Expiry | About 6 months, until recording.expires_at, or sooner if the funeral home deletes the call. |
curl -L -o call.wav \
"https://app.miraven.com/api/recordings/6f1d2c3b-8a9e-4f70-b1c2-d3e4f5a6b7c8?exp=1777835524&sig=…"