# List storage slots Source: https://holofolder.com/app/docs/reference/collection/list-storage-slots GET https://app.holofolder.com/app/api/v1/storage/collections/{collectionId}/slots OpenAPI operation (parameters, authentication, request body and responses): ```json { "operationId": "list_storage_slots", "summary": "List storage slots", "description": "Page ordered stable slots, current targets and wanted entries with item/placement/collection/layout preconditions. Empty targets are goals, not ownership. Cursor rejects changed revisions, scope or filters.\n\nRequired permissions: `collection:read`, `binders:read`. MCP tool: `list_storage_slots`.", "tags": [ "Collection" ], "security": [ { "apiKey": [] } ], "parameters": [ { "name": "collectionId", "in": "path", "required": true, "schema": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" } }, { "name": "limit", "in": "query", "required": false, "schema": { "type": "integer", "minimum": 1, "maximum": 100 } }, { "name": "cursor", "in": "query", "required": false, "schema": { "type": "string", "minLength": 1, "maxLength": 1024 } }, { "name": "cardId", "in": "query", "required": false, "schema": { "type": "string", "minLength": 1, "maxLength": 200 } }, { "name": "status", "in": "query", "required": false, "schema": { "type": "string", "enum": [ "collected", "finalized", "considering", "wishlisted" ] } } ], "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "projection": { "type": "string", "const": "developer-native-v1" }, "completeSnapshot": { "type": "boolean", "const": false }, "inventoryRevision": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "readRevision": { "type": "string", "pattern": "^[a-f0-9]{64}$" }, "data": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string", "minLength": 1, "maxLength": 200 }, "collectionId": { "type": "string", "minLength": 1, "maxLength": 200 }, "position": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "version": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "collectionVersion": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "layoutRevision": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "inventoryItemId": { "anyOf": [ { "type": "string", "minLength": 1, "maxLength": 200 }, { "type": "null" } ] }, "itemVersion": { "anyOf": [ { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, { "type": "null" } ] }, "placementVersion": { "anyOf": [ { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, { "type": "null" } ] }, "target": { "anyOf": [ { "oneOf": [ { "type": "object", "properties": { "kind": { "type": "string", "const": "pokemon" }, "pokemonId": { "type": "integer", "minimum": 1, "maximum": 9007199254740991 } }, "required": [ "kind", "pokemonId" ], "additionalProperties": false }, { "type": "object", "properties": { "kind": { "type": "string", "const": "card" }, "cardId": { "type": "string", "minLength": 1, "maxLength": 200 }, "language": { "type": "string", "enum": [ "en", "fr", "de", "es", "it", "pt-br", "ja", "ko" ] }, "finish": { "type": "string", "enum": [ "normal", "holo", "reverse_holo", "double_rare", "ultra_rare", "illustration_rare", "special_illustration_rare", "secret_rare", "hyper_rare", "radiant_rare", "ace_spec", "amazing_rare", "shiny_rare", "jumbo" ] } }, "required": [ "kind", "cardId" ], "additionalProperties": false } ] }, { "type": "null" } ] }, "status": { "anyOf": [ { "type": "string", "enum": [ "collected", "finalized", "considering", "wishlisted" ] }, { "type": "null" } ] }, "wantedCards": { "type": "array", "items": { "type": "object", "properties": { "card_id": { "type": "string", "minLength": 1, "maxLength": 200 }, "card_name": { "type": "string" }, "added_at": { "type": "string" }, "card_language": { "type": "string", "enum": [ "en", "fr", "de", "es", "it", "pt-br", "ja", "ko" ] }, "card_finish": { "type": "string", "enum": [ "normal", "holo", "reverse_holo", "double_rare", "ultra_rare", "illustration_rare", "special_illustration_rare", "secret_rare", "hyper_rare", "radiant_rare", "ace_spec", "amazing_rare", "shiny_rare", "jumbo" ] }, "card_set": { "type": "string" }, "rarity": { "type": "string" }, "local_id": { "type": "string" }, "illustrator": { "type": "string" }, "set_total": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 } }, "required": [ "card_id", "card_name", "added_at" ], "additionalProperties": false } } }, "required": [ "id", "collectionId", "position", "version", "collectionVersion", "layoutRevision", "inventoryItemId", "itemVersion", "placementVersion", "target", "status", "wantedCards" ], "additionalProperties": false } }, "total": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "nextCursor": { "type": [ "string", "null" ] } }, "required": [ "projection", "completeSnapshot", "inventoryRevision", "readRevision", "data", "total", "nextCursor" ], "additionalProperties": false } } } }, "400": { "description": "See the API conventions page.", "content": { "application/json": { "schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "requestId": { "type": "string" } }, "required": [ "code", "message", "requestId" ], "additionalProperties": false } }, "required": [ "error" ], "additionalProperties": false } } } }, "401": { "description": "See the API conventions page.", "content": { "application/json": { "schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "requestId": { "type": "string" } }, "required": [ "code", "message", "requestId" ], "additionalProperties": false } }, "required": [ "error" ], "additionalProperties": false } } } }, "402": { "description": "See the API conventions page.", "content": { "application/json": { "schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "requestId": { "type": "string" } }, "required": [ "code", "message", "requestId" ], "additionalProperties": false } }, "required": [ "error" ], "additionalProperties": false } } } }, "403": { "description": "See the API conventions page.", "content": { "application/json": { "schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "requestId": { "type": "string" } }, "required": [ "code", "message", "requestId" ], "additionalProperties": false } }, "required": [ "error" ], "additionalProperties": false } } } }, "404": { "description": "See the API conventions page.", "content": { "application/json": { "schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "requestId": { "type": "string" } }, "required": [ "code", "message", "requestId" ], "additionalProperties": false } }, "required": [ "error" ], "additionalProperties": false } } } }, "409": { "description": "See the API conventions page.", "content": { "application/json": { "schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "requestId": { "type": "string" } }, "required": [ "code", "message", "requestId" ], "additionalProperties": false } }, "required": [ "error" ], "additionalProperties": false } } } }, "413": { "description": "See the API conventions page.", "content": { "application/json": { "schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "requestId": { "type": "string" } }, "required": [ "code", "message", "requestId" ], "additionalProperties": false } }, "required": [ "error" ], "additionalProperties": false } } } }, "422": { "description": "See the API conventions page.", "content": { "application/json": { "schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "requestId": { "type": "string" } }, "required": [ "code", "message", "requestId" ], "additionalProperties": false } }, "required": [ "error" ], "additionalProperties": false } } } }, "429": { "description": "See the API conventions page.", "content": { "application/json": { "schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "requestId": { "type": "string" } }, "required": [ "code", "message", "requestId" ], "additionalProperties": false } }, "required": [ "error" ], "additionalProperties": false } } } }, "503": { "description": "See the API conventions page.", "content": { "application/json": { "schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "requestId": { "type": "string" } }, "required": [ "code", "message", "requestId" ], "additionalProperties": false } }, "required": [ "error" ], "additionalProperties": false } } } } } } ```