Purchases

A price watch as it stands now

Live

GET https://shopitup.ca/api/v1/price-watches/{price_watch_id}

Access: purchase:write How to get a token
Returns: The price watch

Request

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

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

const data = await response.json();

import requests

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

data = response.json()

Response

200 · The price watch

{
  "price_watch_id": 42,
  "status": "active",
  "catalog_item_id": "5171",
  "title": "(S) Arc'teryx Casual Cozy Outdoor Gray Fleece Turtleneck Pullover",
  "max_price": {
    "amount": "90.00",
    "currency": "CAD"
  },
  "max_total": {
    "amount": "115.00",
    "currency": "CAD"
  },
  "current_price": {
    "amount": "110.00",
    "currency": "CAD"
  },
  "outcome": null,
  "order_number": null,
  "expires_at": "2026-11-03T18:00:00Z",
  "created_at": "2026-10-04T18: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_watch_id integer Required

Response

200 The price watch

price_watch_id integer
status string

One of active executing fulfilled item_sold needs_you cancelled expired
catalog_item_id string
title string
max_price Money
2 child attributes
- amount string Required
  
  Decimal string, two places
- currency string Required
  
  One of CAD
max_total 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
outcome string

Why it ended, when it did (e.g. bought, item_sold, over_your_total, card_declined, limits_lowered, assistant_disconnected, expired).
order_number string
expires_at string date-time
created_at string date-time

Status codes

200

The price watch

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.