List alert channels

GET

/api/v1/alerts

curl --request GET \
  --url 'https://app.hostrepute.com/api/v1/alerts?page=1&per_page=15' \
  --header 'Authorization: Bearer <token>'

List your team’s alert channels with the delivery hours each one follows, 15 per page by default. Channel settings such as addresses, webhook URLs and secrets are never returned.

Needs the alert:read ability.

Authorizations

• bearer

Parameters

Query Parameters

page

The page to return, starting at 1.

integer

The page to return, starting at 1.

Example

1

per_page

How many items to return per page, from 1 to 100. Defaults to 15.

integer

How many items to return per page, from 1 to 100. Defaults to 15.

Example

15

Responses

200

Media typeapplication/json

object

data

Array<object>

object

uuid

string

type

string

frequency

string

is_active

boolean

last_sent_at

string

alert_groups

Array<object>

object

uuid

string

name

string

slug

string

timezone

string

schedule

object

mon

object

enabled

boolean

start

string

end

string

tue

object

enabled

boolean

start

string

end

string

wed

object

enabled

boolean

start

string

end

string

thu

object

enabled

boolean

start

string

end

string

fri

object

enabled

boolean

start

string

end

string

sat

object

enabled

boolean

start

string

end

string

sun

object

enabled

boolean

start

string

end

string

is_default

boolean

created_at

string

updated_at

string

created_at

string

updated_at

string

links

object

first

string

last

string

prev

string

nullable

next

string

nullable

meta

object

current_page

integer

from

integer

last_page

integer

links

Array<object>

object

url

string

nullable

label

string

page

string

nullable

active

boolean

path

string

per_page

integer

to

integer

total

integer

Example

{
  "data": [
    {
      "uuid": "01a178db-d7b6-7131-a50c-cb60224dd1cd",
      "type": "email",
      "frequency": "once_on_listed_delisted",
      "is_active": true,
      "last_sent_at": "2026-10-25T21:31:02.000000Z",
      "alert_groups": [
        {
          "uuid": "01a178db-d7b4-730d-82fa-5fb952d888e4",
          "name": "Business hours",
          "slug": "business-hours",
          "timezone": "America/New_York",
          "schedule": {
            "mon": {
              "enabled": true,
              "start": "08:00",
              "end": "18:00"
            },
            "tue": {
              "enabled": true,
              "start": "08:00",
              "end": "18:00"
            },
            "wed": {
              "enabled": true,
              "start": "08:00",
              "end": "18:00"
            },
            "thu": {
              "enabled": true,
              "start": "08:00",
              "end": "18:00"
            },
            "fri": {
              "enabled": true,
              "start": "08:00",
              "end": "18:00"
            },
            "sat": {
              "enabled": false,
              "start": "08:00",
              "end": "18:00"
            },
            "sun": {
              "enabled": false,
              "start": "08:00",
              "end": "18:00"
            }
          },
          "is_default": false,
          "created_at": "2026-07-15T13:02:19.000000Z",
          "updated_at": "2026-07-15T13:02:19.000000Z"
        }
      ],
      "created_at": "2026-07-15T13:04:51.000000Z",
      "updated_at": "2026-07-15T13:04:51.000000Z"
    },
    {
      "uuid": "01a178db-d7c2-7f6e-9b35-4d8c1a2e6f07",
      "type": "slack",
      "frequency": "once_per_check_while_listed",
      "is_active": true,
      "last_sent_at": "2026-10-25T21:31:02.000000Z",
      "alert_groups": [
        {
          "uuid": "01a178db-d5e0-7b44-8c1d-2f6a9e3b7d10",
          "name": "Default Contacts",
          "slug": "default-contacts",
          "timezone": "UTC",
          "schedule": null,
          "is_default": true,
          "created_at": "2026-07-14T09:12:44.000000Z",
          "updated_at": "2026-07-14T09:12:44.000000Z"
        }
      ],
      "created_at": "2026-07-15T13:06:27.000000Z",
      "updated_at": "2026-07-15T13:06:27.000000Z"
    },
    {
      "uuid": "01a178db-d7c9-7a10-8e44-6c2b9f1d3a85",
      "type": "webhook",
      "frequency": "once_on_listed_delisted",
      "is_active": true,
      "last_sent_at": null,
      "alert_groups": [
        {
          "uuid": "01a178db-d5e0-7b44-8c1d-2f6a9e3b7d10",
          "name": "Default Contacts",
          "slug": "default-contacts",
          "timezone": "UTC",
          "schedule": null,
          "is_default": true,
          "created_at": "2026-07-14T09:12:44.000000Z",
          "updated_at": "2026-07-14T09:12:44.000000Z"
        }
      ],
      "created_at": "2026-08-03T10:20:00.000000Z",
      "updated_at": "2026-08-03T10:20:00.000000Z"
    }
  ],
  "links": {
    "first": "https://app.hostrepute.com/api/v1/alerts?page=1",
    "last": "https://app.hostrepute.com/api/v1/alerts?page=1",
    "prev": null,
    "next": null
  },
  "meta": {
    "current_page": 1,
    "from": 1,
    "last_page": 1,
    "links": [
      {
        "url": null,
        "label": "« Previous",
        "page": null,
        "active": false
      },
      {
        "url": "https://app.hostrepute.com/api/v1/alerts?page=1",
        "label": "1",
        "page": 1,
        "active": true
      },
      {
        "url": null,
        "label": "Next »",
        "page": null,
        "active": false
      }
    ],
    "path": "https://app.hostrepute.com/api/v1/alerts",
    "per_page": 15,
    "to": 3,
    "total": 3
  }
}