---
title: "Returns a list of all contacts"
method: GET
path: "/alerting/contacts"
tags: ["Contacts"]
---

# Returns a list of all contacts

`GET /alerting/contacts`

Returns a list of all contacts with their contact methods (notification targets)

## Response `200`

Successful operation

- ContactsList
  - `contacts` ContactTargets[] — List of all contacts targets
    - `id` integer — Contact ID
    - `name` string — Contact name
    - `paused` true | false — Describes whether alerts are paused for this contact
    - `type` 'user' | 'contact' — Type defines whether this is a user (login user) or a contact only
    - `owner` true | false — Indicates whether the contact is the owner of the organization
    - `notification_targets` union
      - object[]
        - `severity` string — Contact target's severity level
        - `country_code` string — Country code
        - `number` string — Phone number
        - `provider` string — Provider
      - object[]
        - `severity` string — Contact target's severity level
        - `address` string — Email address
      - object[]
        - `severity` string — Contact target's severity level
        - `device_name` string — Contact targets's device name
        - `apns_device` string — Contact target's apns
      - object[]
        - `severity` string — Contact target's severity level
        - `agcm_id` string — Contact target's agcm id
    - `teams` object[]
      - `id` integer — Team ID
      - `name` string — Name of the team

---

[API](https://skmtc.net/pingdom/apis/pingdom-public-api.md) · [All operations](https://skmtc.net/pingdom/apis/pingdom-public-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/pingdom/pingdom-public-api/revisions/d05c91a3c64b/schema)