---
title: "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."
method: GET
path: "/v1/collectibles/{collectibleItemId}/restock-eligibility"
tags: ["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.

`GET /v1/collectibles/{collectibleItemId}/restock-eligibility`

## Request

- Base URL: `https://itemconfiguration.roblox.com`
- URL: `https://itemconfiguration.roblox.com/v1/collectibles/{collectibleItemId}/restock-eligibility`
- Auth: one of:
  - API key in cookie `.ROBLOSECURITY`
  - API key in header `x-api-key`

## Path parameters

- `collectibleItemId` string, required

## Response `200`

OK

- RobloxItemConfigurationApiModelsResponseCollectiblesRestockEligibilityResponse: Structured eligibility response so the frontend does not need to re-derive restocking eligibility.
  - `isRestockingEnabled` boolean: Whether the restocking feature is globally enabled.
  - `isEligible` boolean: Whether the item is eligible for restocking right now.
  - `ineligibilityReason` 0 | 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.
  - `hasBeenRestocked` boolean: Whether the item has been restocked before (derived from TotalRestockedQuantity > 0).
  - `totalRestockedQuantity` integer: Cumulative restocked quantity so far.
  - `maxRestockQuantityPerOperation` integer: Maximum additional quantity allowed in a single restock operation.

## Other responses

- `400`: 37: Invalid CollectibleItemId.
- `401`: 0: Authorization has been denied for this request.
- `403`: 12: User does not have permission for the group owned asset 18: User does not own the item
- `404`: 3: Service Unavailable
- `500`: 38: Failed to get Collectible Item information. 141: Failed to get restock eligibility.

## Changes

- **2026-11-13** `e1e00fbc18e5`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/roblox/apis/roblox-api/changes/v1/collectibles/:collectibleItemId/restock-eligibility/get.md)

---

[API](https://skmtc.dev/roblox/apis/roblox-api.md) - [All operations](https://skmtc.dev/roblox/apis/roblox-api/llms.txt) - [OpenAPI document](https://skmtc.dev/roblox/apis/roblox-api/revisions/c2ba38e6ba62?raw)