Read current market values
A read-only POST for up to 200 unique unit IDs. Missing or out-of-view units are omitted; visible units with no price have null marketValue. Price-only changes do not enter the change feed; use this operation for current prices.
/inventory/market-valuesAuthorizationOAuth2 access token · headerrequiredAuthorization code flow (PKCE S256 required). Send resource=https://api.toreca-cloud.com/partner/v1 with the authorization, token and refresh requests. Access tokens last 15 minutes; refresh tokens last 90 days and rotate on every refresh.
inventory:readapplication/jsonidsstring<uuid>[]requiredSuccess
itemsobject[]requiredShow propertiesHide properties
objectidstring<uuid>requiredmarketValueMarketValue | nullrequiredShow propertiesHide properties
amountMinorintegerrequiredcurrencystringrequiredpricedAtstring<date-time>requirednullinvalid_request: a parameter is invalid.
errorstringrequiredThe error code
scopestringWith insufficient_scope, the missing scope
requestIdstring<uuid>inventoryItemIdsstring<uuid>[]holdIdsstring<uuid>[]commitmentIdsstring<uuid>[]invalid_token: the token is missing, expired, or for another resource.
errorstringrequiredThe error code
scopestringWith insufficient_scope, the missing scope
requestIdstring<uuid>inventoryItemIdsstring<uuid>[]holdIdsstring<uuid>[]commitmentIdsstring<uuid>[]One of insufficient_scope, connection_revoked, client_disabled or forbidden.
errorstringrequiredThe error code
scopestringWith insufficient_scope, the missing scope
requestIdstring<uuid>inventoryItemIdsstring<uuid>[]holdIdsstring<uuid>[]commitmentIdsstring<uuid>[]
