---
title: "List alerts"
method: GET
path: "/alerts"
tags: ["Alerts"]
---

# List alerts

`GET /alerts`

## Request

- Base URL: `https://outdoorithm.com/api/v1`
- URL: `https://outdoorithm.com/api/v1/alerts`
- Auth: one of:
  - HTTP bearer
  - API key in header `X-API-Key`

List your availability alerts (cursor paginated).

## Query parameters

- `end_user_id` string: Required for partner keys: list only this customer's alerts. A filtered page may contain fewer than `limit` items — follow `has_more`.
- `status` 'active' | 'paused' | 'expired' | 'error' | 'permanent_error'
- `limit` integer, nullable: 1–100, default 50.
- `cursor` string

## Response `200`

A page of alerts.

- object
  - `data` Alert[], required
    - `object` 'alert', required
    - `id` string, required
    - `end_user_id` string: Partner keys only: your own identifier for the customer this alert belongs to.
    - `name` string, required
    - `description` string, nullable, required
    - `status` string, required: active | paused | expired | error | permanent_error
    - `provider` string, nullable, required
    - `campsites` object[], required
      - `campground_cuid` string, required
      - `campground_name` string, nullable, required
      - `campsite_id` string, nullable, required
      - `campsite_name` string, nullable, required
    - `date_type` string, nullable, required
    - `start_date` string, nullable, required
    - `end_date` string, nullable, required
    - `specific_months` integer[], nullable, required
    - `days_of_week` integer[], nullable, required
    - `min_nights` integer, nullable, required
    - `max_nights` integer, nullable, required
    - `recurring` boolean, nullable, required
    - `notify_email` boolean, nullable, required
    - `notify_sms` boolean, nullable, required
    - `notify_in_app` boolean, nullable, required
    - `check_interval_seconds` integer, nullable, required
    - `last_checked_at` string, nullable, required
    - `next_check_at` string, nullable, required
    - `total_notifications_sent` integer, required
    - `created_at` string, nullable, required
    - `updated_at` string, nullable, required
  - `pagination` Pagination, required
    - `has_more` boolean, required
    - `next_cursor` string, nullable, required

## Other responses

- `401`: Missing or invalid API key.
- `429`: Rate limit exceeded.

---

[API](https://skmtc.dev/outdoorithm/apis/outdoorithm-api.md) · [All operations](https://skmtc.dev/outdoorithm/apis/outdoorithm-api/llms.txt) · [OpenAPI document](https://skmtc.dev/outdoorithm/apis/outdoorithm-api/revisions/2cdb8f1f7df2?raw)