ROroblox
Assets
Avatars

Returns structured restock eligibility information for a given collectible item. This is the single source of truth the frontend should use to determine whether restocking is available, instead of re-deriving from individual flags.

Changed on
get/v1/collectibles/{collectibleItemId}/restock-eligibility

Request

  • Base URL
    https://itemconfiguration.roblox.com
  • Auth
    • API key in cookie .ROBLOSECURITY
    • or API key in header x-api-key

Path parameters

collectibleItemIdstring required

Response

OK

isRestockingEnabledboolean

Whether the restocking feature is globally enabled.

isEligibleboolean

Whether the item is eligible for restocking right now.

ineligibilityReason0 | 1 | 2 | 3 | 4 | 5 | 6 | 7

Why the item is ineligible for restocking. Serialized as PascalCase enum name (e.g. "NotLimited", "NotFree"). Null/omitted when the item is eligible.

hasBeenRestockedboolean

Whether the item has been restocked before (derived from TotalRestockedQuantity > 0).

totalRestockedQuantityinteger

Cumulative restocked quantity so far.

maxRestockQuantityPerOperationinteger

Maximum additional quantity allowed in a single restock operation.

Changes