Skip to content
Pong Docs

List alert contacts

GET
/api/v1/alert-contacts

Returns all alert contacts belonging to the authenticated user.

Authorizations

Section titled “Authorizations ”

Responses

Section titled “ Responses ”

200

Section titled “200 ”

A list of alert contacts.

object
contacts
required
Array<object>

A contact channel for receiving alerts.

object
id
required

Unique alert contact identifier.

integer
Example
1
user_id
required

ID of the user who owns this contact.

integer
Example
1
type
required

Notification channel type.

string
Allowed values: email slack webhook
Example
email
value
required

Channel address (email, Slack webhook URL, or webhook URL).

string
Example
ops@example.com
name
required

Human-readable label for this contact.

string
Example
Ops Team Email
verified

Whether the contact has been verified. Email contacts require verification before receiving alerts. Slack and webhook contacts are verified automatically.

boolean
Example
true
created_at
required

When the contact was created.

string format: date-time
Example
2026-01-10T09:00:00Z

401

Section titled “401 ”

Authentication credentials are missing or invalid.

Error response returned when a request fails.

object
error
required

A human-readable error message.

string
Example
monitor not found
Example
{
  "error": "unauthorized"
}