> ## Documentation Index > Fetch the complete documentation index at: https://skulabs.mintlify.site/llms.txt > Use this file to discover all available pages before exploring further. # Warehouse - Stats > Retrieve warehouse statistics including item counts and inventory totals. ## OpenAPI ````yaml get /warehouse/stats openapi: 3.0.3 info: title: SKULabs API description: >- Most API keys have "platformGeneric" and "platformApi" scopes included. Contact us to convert more routes from "platformUser" (only available to users) to "platformGeneric" (available to users and api keys) upon request. version: 4.5.0 servers: - url: https://api.skulabs.com - url: https://app.skulabs.com/s security: [] tags: - name: batch - name: customer description: Manage customers, tags, and notes - name: cycle_count - name: distributor - name: inventory description: Query and modify inventory levels across locations - name: inventory_table - name: item description: Manage items, barcodes, serial numbers, and tags - name: kit description: Manage kits and their component items - name: listing - name: location - name: oauth - name: order description: Manage orders, shipments, tags, and statuses - name: purchase_order description: Manage purchase orders and receiving - name: run - name: shipments - name: shipping - name: store - name: tag description: Create, update, and remove tags - name: transfer_order - name: warehouse description: Manage warehouses and view statistics - name: webhook description: Manage webhook handlers paths: /warehouse/stats: get: tags: - warehouse summary: Warehouse - Stats description: >- Retrieve warehouse statistics including item counts and inventory totals. operationId: get_warehouse_stats parameters: - name: warehouse_id in: query required: false schema: type: string description: Warehouse ID to filter stats for a single warehouse example: 507f1f77bcf86cd799439011 - name: with_locations in: query required: false schema: type: boolean description: Group stats by location instead of warehouse responses: '200': description: Array of warehouse (or location) statistics from aggregation content: application/json: schema: type: array items: type: object properties: _id: type: string description: >- Warehouse ID (or location ID when with_locations is true) example: 507f1f77bcf86cd799439011 on_hand: type: number description: Total on-hand quantity across all SKUs sku_count: type: number description: Total number of distinct SKUs skus_available: type: number description: Number of SKUs with on_hand greater than zero pct_available: type: number description: Percentage of SKUs in stock (0-100) summary: type: string description: Human-readable summary, e.g. "1.2k skus, 85% in stock" required: - _id - on_hand - sku_count - skus_available - pct_available - summary '400': description: Bad request content: application/json: schema: type: object properties: error: type: object properties: message: type: string description: Detailed error message code: type: string description: Machine-readable error code overview: type: string description: Short human-friendly description statusCode: type: number description: HTTP status code origin: type: string description: Error source skulabsTraceId: type: string description: Trace ID for support type: type: string enum: - error - notice - success description: Error severity for UI handling user_error: type: boolean description: Whether the error was caused by user input display: type: string enum: - notification - panel description: Suggested UI display mode for the error required: - message - statusCode required: - error '401': description: Unauthorized content: application/json: schema: type: object properties: error: type: object properties: message: type: string description: Detailed error message code: type: string description: Machine-readable error code overview: type: string description: Short human-friendly description statusCode: type: number description: HTTP status code origin: type: string description: Error source skulabsTraceId: type: string description: Trace ID for support type: type: string enum: - error - notice - success description: Error severity for UI handling user_error: type: boolean description: Whether the error was caused by user input display: type: string enum: - notification - panel description: Suggested UI display mode for the error required: - message - statusCode required: - error '403': description: Forbidden. Insufficient permissions. content: application/json: schema: type: object properties: error: type: object properties: message: type: string description: Detailed error message code: type: string description: Machine-readable error code overview: type: string description: Short human-friendly description statusCode: type: number description: HTTP status code origin: type: string description: Error source skulabsTraceId: type: string description: Trace ID for support type: type: string enum: - error - notice - success description: Error severity for UI handling user_error: type: boolean description: Whether the error was caused by user input display: type: string enum: - notification - panel description: Suggested UI display mode for the error required: - message - statusCode required: - error '429': description: Too many requests. Rate limit exceeded. content: application/json: schema: type: object properties: error: type: object properties: message: type: string description: Detailed error message code: type: string description: Machine-readable error code overview: type: string description: Short human-friendly description statusCode: type: number description: HTTP status code origin: type: string description: Error source skulabsTraceId: type: string description: Trace ID for support type: type: string enum: - error - notice - success description: Error severity for UI handling user_error: type: boolean description: Whether the error was caused by user input display: type: string enum: - notification - panel description: Suggested UI display mode for the error required: - message - statusCode required: - error '500': description: Internal server error. content: application/json: schema: type: object properties: error: type: object properties: message: type: string description: Detailed error message code: type: string description: Machine-readable error code overview: type: string description: Short human-friendly description statusCode: type: number description: HTTP status code origin: type: string description: Error source skulabsTraceId: type: string description: Trace ID for support type: type: string enum: - error - notice - success description: Error severity for UI handling user_error: type: boolean description: Whether the error was caused by user input display: type: string enum: - notification - panel description: Suggested UI display mode for the error required: - message - statusCode required: - error security: - SKULabsToken: [] servers: - url: https://api.skulabs.com components: securitySchemes: SKULabsToken: type: http scheme: bearer bearerFormat: JWT ````