pricebook.priceHistory

The dated prices saved for one price book item, newest effective date first (owner or office, needs see_prices). cost_minor is null when you cannot see costs. The current price is the latest row on or before today.


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

When to use it

The dated prices saved for one price book item, newest effective date first (owner or office, needs see_prices). cost_minor is null when you cannot see costs.

What to tell the owner

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

Input

Field	Type	Required
`item_id`	string (uuid)	yes

Example

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

Output

Field	Type	Always there
`item_id`	string (uuid)	yes
`name`	string	yes
`sku`	['string', 'null']	yes
`today`	string (date)	yes
`current`	['object', 'null']	yes
`history`	array	yes
`history[].effective_date`	string (date)	yes
`history[].price_minor`	integer	yes
`history[].cost_minor`	['integer', 'null']	yes
`history[].source`	string	yes
`history[].imported_by`	['string', 'null', ' ', '(', 'u', 'u', 'i', 'd', ')']	yes
`history[].created_at`	string (date-time)	yes
`history[].current`	boolean	yes
`history[].future`	boolean	yes

{
  "item_id": "00000000-0000-4000-8000-000000000000",
  "name": "Ruiz Plumbing",
  "sku": "...",
  "today": "...",
  "current": "...",
  "history": [
    {
      "effective_date": "...",
      "price_minor": 50000,
      "cost_minor": "...",
      "source": "...",
      "imported_by": "00000000-0000-4000-8000-000000000000",
      "created_at": "...",
      "current": true,
      "future": true
    }
  ]
}

Errors

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