---
title: "Get an alert"
method: GET
path: "/alerts/{alertId}"
tags: ["Alerts"]
---

# Get an alert

`GET /alerts/{alertId}`

## Request

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

## Path parameters

- `alertId` string, required: The alert UUID.

## Query parameters

- `end_user_id` string: Required for partner keys: the customer that owns this alert. A different customer receives the same 404 as an unknown alert.

## Response `200`

The alert.

- 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

## Other responses

- `401`: Missing or invalid API key.
- `404`: No alert with that id.
- `422`: Partner key omitted end_user_id.
- `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)