Account

The person's price-drop alerts

Live

GET https://shopitup.ca/api/v1/price-alerts

Newest first, wherever the person set them (on an item's page or through any assistant).

Access: alerts:write How to get a token
Returns: Newest first

Request

curl "https://shopitup.ca/api/v1/price-alerts" \
  -H "Authorization: Bearer $TOKEN"

const response = await fetch("https://shopitup.ca/api/v1/price-alerts", {
  headers: {
    Authorization: `Bearer ${token}`,
  },
});

const data = await response.json();

import requests

response = requests.get(
    "https://shopitup.ca/api/v1/price-alerts",
    headers={"Authorization": f"Bearer {token}"},
)

data = response.json()

Response

200 · Newest first

{
  "data": [
    {
      "price_alert_id": 7,
      "status": "active",
      "catalog_item_id": "5171",
      "title": "(S) Arc'teryx Casual Cozy Outdoor Gray Fleece Turtleneck Pullover",
      "target_price": {
        "amount": "90.00",
        "currency": "CAD"
      },
      "current_price": {
        "amount": "110.00",
        "currency": "CAD"
      },
      "notified_at": null,
      "expires_at": "2026-11-08T18:00:00Z",
      "created_at": "2026-10-09T18:00:00Z"
    }
  ]
}

401 · Missing, invalid or expired access token

{
  "error": {
    "code": "unauthorized",
    "message": "The access token is missing, invalid or expired."
  }
}

403 · The token does not carry the scope this endpoint needs

{
  "error": {
    "code": "insufficient_scope",
    "message": "This request needs a token with the catalog:read scope."
  }
}

429 · Too many requests; retry after the number of seconds in `Retry-After`

{
  "error": {
    "code": "rate_limited",
    "message": "Too many requests. Try again in 30 seconds."
  }
}

503 · A service the API depends on is briefly unavailable; retry after the number of seconds in `Retry-After`

{
  "error": {
    "code": "unavailable",
    "message": "A service the API depends on is briefly unavailable. Try again in a few seconds."
  }
}

Response

200 Newest first

data array of PriceAlert
9 child attributes
- price_alert_id integer
- status string
  
  One of active notified cancelled expired item_sold
- catalog_item_id string
- title string
- target_price Money
  2 child attributes
  - amount string Required
    
    Decimal string, two places
  - currency string Required
    
    One of CAD
- current_price Money
  2 child attributes
  - amount string Required
    
    Decimal string, two places
  - currency string Required
    
    One of CAD
- notified_at string date-time
  
  When the person was emailed that the price reached their target.
- expires_at string date-time
- created_at string date-time

Status codes

200

Newest first

401

Missing, invalid or expired access token

403

The token does not carry the scope this endpoint needs

429

Too many requests; retry after the number of seconds in Retry-After

503

A service the API depends on is briefly unavailable; retry after the number of seconds in Retry-After

Errors share one shape — see Errors and rate limits.