--- updatedAt: 2026-04-23T13:29:19.000Z agentTools: projectIndex: https://developer.xentral.com/llms.txt --- # List storage items V2 Returns all storage location items for the specified warehouse / location. # OpenAPI definition ```json { "openapi": "3.0.0", "info": { "title": "Xentral API", "version": "v0.1", "description": "Xentral is an ERP platform.", "contact": { "name": "Xentral", "url": "https://xentral.com", "email": "api@xentral.com" } }, "tags": [ { "name": "Storage Item", "description": "Represent a storage item in a storage location" } ], "components": { "securitySchemes": { "BearerAuth": { "type": "http", "scheme": "bearer", "description": "Bearer token obtained in POST /tokens endpoint or pregenerated in the system." } } }, "security": [ { "BearerAuth": [] } ], "servers": [ { "url": "https://{xentralId}.xentral.biz", "description": "Your Xentral Instance", "variables": { "xentralId": { "default": "xentral" } } }, { "url": "https://{domain}", "description": "Xentral at a custom domain", "variables": { "domain": { "default": "xentral.com" } } } ], "x-readme": { "samples-languages": [] }, "paths": { "/api/v2/warehouses/{warehouseId}/storageLocations/{storageLocationId}/items": { "get": { "tags": [ "Storage Item" ], "operationId": "storageLocation.listV2", "parameters": [ { "name": "warehouseId", "in": "path", "description": "ID of warehouse", "required": true, "schema": { "type": "string", "pattern": "\\d+", "example": "17", "description": "Resource identifier." } }, { "name": "storageLocationId", "in": "path", "description": "ID of storage location", "required": true, "schema": { "type": "string", "pattern": "\\d+", "example": "17", "description": "Resource identifier." } } ], "summary": "List storage items V2", "description": "Returns all storage location items for the specified warehouse / location.", "responses": { "200": { "description": "Operation completed successfully. Support for products where a product is both serial number tracked AND batch/best before date tracked at the same time is limited. In case serial number tracking is set to \"Generate own\" in the product master data, the qualityControlAttribute quantities will be reported (a) for the serial numbers on shelf and (b) for the batch/bestBeforeDate records on shelf, thus potentially resulting in a double count in the total across all qualityControlAttribute->quantity values. The quantity on the product->quantity level reflects the correct quantity on shelf in any case.", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "properties": { "data": { "description": "Representation of a list of Items in storage", "type": "array", "items": { "type": "object", "additionalProperties": false, "properties": { "productId": { "type": "string", "pattern": "\\d+", "example": "17", "description": "Resource identifier." }, "sku": { "type": "string", "description": "SKU code of the item", "example": "ABC-12345-S-BL" }, "quantity": { "type": "number", "description": "Quantity of the item to stock to storage location", "example": 5 }, "qualityControlAttributes": { "type": "array", "items": { "type": "object", "additionalProperties": false, "properties": { "quantity": { "type": "number", "description": "Quantity of the item to stock to storage location" }, "batch": { "type": "string", "nullable": true, "description": "Batch of the item" }, "bestBeforeDate": { "type": "string", "format": "date", "nullable": true, "description": "Best before date of the item" }, "serialNumbers": { "type": "array", "items": { "type": "object", "properties": { "number": { "type": "string", "description": "The serial numbers of the item" } } } } } }, "description": "List of Product unit specific quality properties", "example": [ { "quantity": 5, "batch": "Batch1", "bestBeforeDate": "2025-01-01", "serialNumbers": [ { "number": "001" } ] } ] } } }, "example": [ { "productId": "1", "sku": "ABC-12345-S-BL", "quantity": 5, "qualityControlAttributes": [ { "quantity": 5, "batch": "Batch1", "bestBeforeDate": "2025-01-01", "serialNumbers": [ { "number": "001" } ] } ] } ] }, "extra": { "type": "object", "required": [ "totalCount", "page" ], "additionalProperties": false, "x-description-ignore": true, "properties": { "totalCount": { "description": "the total count of all items", "type": "integer", "example": 1 }, "page": { "description": "The pagination object containing the current page number and size", "type": "object", "required": [ "number", "size" ], "additionalProperties": false, "properties": { "number": { "description": "The current page number", "type": "integer", "example": 1 }, "size": { "description": "The size of the pages", "type": "integer", "example": 10 } }, "example": { "number": 1, "size": 10 } } }, "example": { "totalCount": 1, "page": { "number": 1, "size": 10 } } } } } } } }, "400": { "description": "IETF RFC 9457 Problem API compliant response", "content": { "application/problem+json": { "schema": { "oneOf": [ { "type": "object", "additionalProperties": false, "required": [ "type", "title", "violations" ], "properties": { "type": { "type": "string", "enum": [ "https://api.xentral.biz/problems/request-validation" ] }, "title": { "type": "string", "minLength": 1, "example": "Request payload validation failed." }, "violations": { "oneOf": [ { "type": "array", "items": { "type": "object", "example": { "username": [ "This value should not be blank." ], "email": [ "This value is not a valid email address." ] } }, "description": "This field will be a mirrored request payload with only invalid fields and values replaced by error messages." }, { "type": "object", "example": { "_": [ "This value should contain at most `9` elements." ] }, "description": "This field will be a mirrored request payload with only invalid fields and values replaced by error messages." } ] } } }, { "type": "object", "additionalProperties": false, "required": [ "type", "title", "messages" ], "properties": { "type": { "type": "string", "enum": [ "https://api.xentral.biz/problems/generic-validation" ] }, "title": { "type": "string", "minLength": 1 }, "messages": { "type": "array", "items": { "type": "string" } } } }, { "type": "object", "additionalProperties": false, "required": [ "type", "title", "messages" ], "properties": { "type": { "type": "string", "enum": [ "https://api.xentral.biz/problems/conflict" ] }, "title": { "type": "string", "minLength": 1 }, "messages": { "type": "array", "items": { "type": "string" } } } }, { "type": "object", "additionalProperties": false, "required": [ "type", "title", "items" ], "properties": { "type": { "type": "string", "enum": [ "https://api.xentral.biz/problems/conflictItems" ] }, "title": { "type": "string", "minLength": 1 }, "items": { "type": "array", "items": { "type": "object", "additionalProperties": false, "required": [ "id", "title", "messages" ], "properties": { "id": { "type": "integer" }, "title": { "type": "string", "minLength": 1 }, "messages": { "type": "array", "items": { "type": "string" } } } } } } }, { "type": "object", "additionalProperties": false, "required": [ "type", "title", "scopes" ], "properties": { "type": { "type": "string", "enum": [ "https://developer.xentral.com/reference/problems#token-scopes" ] }, "title": { "type": "string", "minLength": 1 }, "scopes": { "type": "array", "items": { "type": "string" } } } }, { "type": "object", "additionalProperties": false, "required": [ "type", "title", "messages" ], "properties": { "type": { "type": "string", "enum": [ "https://api.xentral.biz/problems/generic-validation" ] }, "title": { "type": "string", "minLength": 1 }, "messages": { "type": "object", "additionalProperties": { "type": "array", "items": { "type": "string" } } } } } ] } } } }, "403": { "description": "Unable to authorize the client" }, "404": { "description": "Resource was not found or not enough access privileges" }, "429": { "description": "Too many API calls made." } } } } } } ```