pricebook.stalePrices

Price book items whose current price was set more than the shop's stale window ago (owner or office, needs see_prices). The window defaults to 365 days. An item with no dated price is stale. Archived items are left out.


Who	Agents can call this
REST	`GET /v1/pricebook/prices/stale`
MCP tool	`pricebook_stalePrices`
Writes	no
Area	Quotes (unlimited)

When to use it

Price book items whose current price was set more than the shop's stale window ago (owner or office, needs see_prices). The window defaults to 365 days.

What to tell the owner

Tell them what you found in plain words. Don't read back raw fields.

Input

Field	Type	Required
`shop_id`	string (uuid)	yes
`older_than_days`	integer	no

Example

GET https://doingwork.work/v1/pricebook/prices/stale?shop_id=00000000-0000-4000-8000-000000000000

Output

Field	Type	Always there
`shop_id`	string (uuid)	yes
`stale_days`	integer	yes
`today`	string (date)	yes
`items`	array	yes
`items[].item_id`	string (uuid)	yes
`items[].name`	string	yes
`items[].sku`	['string', 'null']	yes
`items[].price_minor`	integer	yes
`items[].effective_date`	['string', 'null', ' ', '(', 'd', 'a', 't', 'e', ')']	yes
`items[].source`	['string', 'null']	yes
`items[].age_days`	['integer', 'null']	yes
`items[].stale`	boolean	yes

{
  "shop_id": "00000000-0000-4000-8000-000000000000",
  "stale_days": 1,
  "today": "...",
  "items": [
    {
      "item_id": "00000000-0000-4000-8000-000000000000",
      "name": "Ruiz Plumbing",
      "sku": "...",
      "price_minor": 50000,
      "effective_date": "...",
      "source": "...",
      "age_days": "...",
      "stale": true
    }
  ]
}

Errors

Code	Status	What to do
`invalid_input`, `invalid_token`, `rate_limited`		Can happen on any call. See errors.