Skip to content
トレカクラウド
Esc
↑↓navigate↵open⌘Jpreview

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.

POST/inventory/market-values
Authorization
AuthorizationOAuth2 access token · headerrequired

Authorization 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.

Scopes:inventory:read
Request body
requiredapplication/json
idsstring<uuid>[]required
min items 1 · max items 200
Responses
200

Success

itemsobject[]required
Show properties
Array of object
idstring<uuid>required
marketValueMarketValue | nullrequired
Show properties
One of:
MarketValue
amountMinorintegerrequired
currencystringrequired
pricedAtstring<date-time>required
null
null
400

invalid_request: a parameter is invalid.

errorstringrequired

The error code

scopestring

With insufficient_scope, the missing scope

requestIdstring<uuid>
inventoryItemIdsstring<uuid>[]
holdIdsstring<uuid>[]
commitmentIdsstring<uuid>[]
401

invalid_token: the token is missing, expired, or for another resource.

errorstringrequired

The error code

scopestring

With insufficient_scope, the missing scope

requestIdstring<uuid>
inventoryItemIdsstring<uuid>[]
holdIdsstring<uuid>[]
commitmentIdsstring<uuid>[]
403

One of insufficient_scope, connection_revoked, client_disabled or forbidden.

errorstringrequired

The error code

scopestring

With insufficient_scope, the missing scope

requestIdstring<uuid>
inventoryItemIdsstring<uuid>[]
holdIdsstring<uuid>[]
commitmentIdsstring<uuid>[]
Try it
Server
Authorization
Bodyapplication/json
Request
curl -X POST 'https://api.toreca-cloud.com/partner/v1/inventory/market-values' \
  -H 'Authorization: Bearer YOUR_ACCESS_TOKEN' \
  -H 'Accept: application/json' \
  -H 'Content-Type: application/json' \
  -d '{
  "ids": [
    "497f6eca-6276-4993-bfeb-53cbbbba6f08"
  ]
}'
Response
{
  "items": [
    {
      "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
      "marketValue": {
        "amountMinor": 0,
        "currency": "JPY",
        "pricedAt": "2019-08-24T14:15:22Z"
      }
    }
  ]
}

Was this page helpful?