Purchases

The price watches this assistant set for the person

Live

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

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

Request

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

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

const data = await response.json();

import requests

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

data = response.json()

Response

200 · Newest first

{
  "data": [
    {
      "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"
    }
  ]
}

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 PriceWatch
11 child attributes
- 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

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.