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

# List your alerts

`GET /v1/alerts`

## Request

- Base URL: `https://api.pricetrack.dev`
- URL: `https://api.pricetrack.dev/v1/alerts`
- Auth: HTTP bearer

## Response `200`

Alerts + tier limits

- object
  - `data` Alert[]
    - `id` string, uuid
    - `product` object
      - `slug` string
      - `name` string
    - `alertType` 'any_change' | 'increase' | 'decrease' | 'threshold' | 'price_above' | 'price_below'
    - `thresholdPercentage` integer, nullable
    - `targetPrice` number, nullable: Dollar threshold for price_above / price_below alerts. Fires on the crossing, not while the price remains on that side.
    - `customLabel` string, nullable: Short note shown in the dashboard and included in matching email subjects and webhook payloads.
    - `deliveryMethod` 'email' | 'webhook' | 'both'
    - `webhookUrl` string, nullable
    - `isActive` boolean
    - `lastTriggeredAt` string, date-time, nullable
    - `createdAt` string, date-time
  - `limits` object
    - `used` integer
    - `max` integer

---

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