Account

Stop one of the person's price-drop alerts

Live

DELETE https://shopitup.ca/api/v1/price-alerts/{price_alert_id}

Access: alerts:write How to get a token
Returns: The alert, stopped (or as it ended, if it already had)

Request

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

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

const data = await response.json();

import requests

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

data = response.json()

Response

200 · The alert, stopped (or as it ended, if it already had)

{
  "price_alert_id": 7,
  "status": "cancelled",
  "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"
}

404 · Not found, or not listed on this marketplace

{
  "error": {
    "code": "not_found",
    "message": "No item with that id is listed on this marketplace."
  }
}

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."
  }
}

Path parameters

price_alert_id integer Required

Response

200 The alert, stopped (or as it ended, if it already had)

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

The alert, stopped (or as it ended, if it already had)

404

Not found, or not listed on this marketplace

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.