---
title: "Retrieve notification event list"
method: GET
path: "/v2/partition/{partitionId}/account/{accountId}/emergency-notifications/events"
tags: ["Emergency Notification"]
---

# Retrieve notification event list

`GET /v2/partition/{partitionId}/account/{accountId}/emergency-notifications/events`

## Request

- Base URL: `https://api.alianza.com`
- URL: `https://api.alianza.com/v2/partition/{partitionId}/account/{accountId}/emergency-notifications/events`
- Auth: API key in header `X-AUTH-TOKEN`
- TypeScript: <https://skmtc.dev/alianza/apis/alianza-public-api/docs/v2/partition/:partitionId/account/:accountId/emergency-notifications/events/get.ts> (a function with typed inputs; its response is checked against the schema)

Use to retrieve all Emergency Notification Events for an account.  For accounts with Emergency Notification enabled, one of these is automatically generated anytime any enduser of the account places a 911 or 933 call.

## Path parameters

- `accountId` string, required
- `partitionId` string, required

## Response `200`

Successful operation

- EmergencyNotificationEvent[]
  - `id` string, uuid: The unique identifier of the event, auto generated by the system.
  - `callTime` string, date-time: The time the emergency call was placed. ISO 8601 format.
  - `timeZoneId` string: The time zone from which the call was placed.
  - `groupId` string: The id of the group that was notified. What this points to depends on the groupType field. If groupType is ACCOUNT, this refers to <a href="#/~schema/Account">account.id</a>.
  - `groupType` 'ACCOUNT'
  - `triggerType` 'EMERGENCY_CALL' | 'EMERGENCY_TEST_CALL' | 'NOTIFICATION_TEST': The type of event that triggered the notification.
  - `triggeringPhoneNumber` string: The phone number from which the 911 call was made. Will be null for events with triggerType of NOTIFICATION_TEST.
  - `status` 'SENT' | 'FAILED' | 'PARTIAL': Indicates the success of the notification delivery.<BR>SENT - notification successfully sent to all intended recipients.<BR>FAILED - notification failed to be sent to any intended recipients.<BR>PARTIAL - notification was sent to some, but not all, intended recipients.
  - `emailNotificationRecipients` RecipientStatus[]: The list of recipients that were attempted ed via email.
    - `recipient` string: This represents the intended recipient of the emergency notification. For email, this is the email address. For SMS, this is the phone number.
    - `status` 'SENT' | 'FAILED': Indicates the success of the notification delivery.<BR>SENT - notification successfully sent to this recipient.<BR>FAILED - notification failed to be sent to this recipient.
  - `smsNotificationRecipients` RecipientStatus[]: The list of recipients that were attempted via SMS.
    - `recipient` string: This represents the intended recipient of the emergency notification. For email, this is the email address. For SMS, this is the phone number.
    - `status` 'SENT' | 'FAILED': Indicates the success of the notification delivery.<BR>SENT - notification successfully sent to this recipient.<BR>FAILED - notification failed to be sent to this recipient.

## Other responses

- `400`: Invalid request parameters
- `401`: Unauthorized
- `404`: Not found

---

[API](https://skmtc.dev/alianza/apis/alianza-public-api.md) - [All operations](https://skmtc.dev/alianza/apis/alianza-public-api/llms.txt) - [OpenAPI document](https://skmtc.dev/alianza/apis/alianza-public-api/revisions/cb514a0728ed?raw)