> ## 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. # Item - Get > Retrieve a paginated list of items with optional filtering. ## OpenAPI ````yaml get /item/get 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: /item/get: get: tags: - item summary: Item - Get description: Retrieve a paginated list of items with optional filtering. operationId: get_item_get parameters: - name: selector in: query required: true schema: type: object properties: {} description: Query selector object for filtering results - name: limit in: query required: false schema: type: number description: Max results to return example: 50 - name: skip in: query required: false schema: type: number description: Number of results to skip example: 0 - name: sort in: query required: false schema: type: object properties: {} description: 'Sort fields object, e.g. { "name": 1 }' - name: fields in: query required: false schema: type: object properties: {} description: 'Projection fields object, e.g. { "name": 1 }' responses: '200': description: Array of items matching the query content: application/json: schema: type: array items: $ref: '#/components/schemas/Item' '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: schemas: Item: type: object properties: _id: type: string description: Unique item identifier example: 507f1f77bcf86cd799439011 name: type: string description: Item name sku: type: string description: Stock keeping unit image: type: string description: Image URL upc: type: string description: Universal product code listings: type: array items: $ref: '#/components/schemas/ItemListing' description: Store listing connections supplies: type: array items: $ref: '#/components/schemas/ItemSupply' description: Supply chain connections custom_fields: type: array items: $ref: '#/components/schemas/ItemCustomField' description: Custom field key-value pairs barcodes: type: array items: type: string description: Additional barcodes tags: type: array items: type: string description: >- Array of tag IDs assigned to this item (ObjectId strings referencing the tag collection) example: - 507f1f77bcf86cd799439011 - 507f1f77bcf86cd799439012 length: type: number description: Package length width: type: number description: Package width height: type: number description: Package height weight_unit: type: string enum: - oz - lb - g - kg description: Weight unit dimensions_unit: type: string enum: - in - cm description: Dimensions unit weight: type: number description: Package weight notes: type: string description: Item notes fulfillment_sku: type: string description: SKU used for fulfillment unit: type: string description: Unit of measure cost: type: number description: Item cost wholesale: type: number description: Wholesale price retail: type: number description: Retail price active: type: boolean description: Whether the item is active alias_locations: type: object properties: {} description: Warehouse location assignments (keyed by warehouse ID) required: - _id ItemListing: type: object properties: store_id: type: string description: Store ID the listing belongs to example: 507f1f77bcf86cd799439011 item_id: type: string description: Channel listing item ID variant_id: type: string description: Channel listing variant ID source_name: type: string description: Source of the listing link ItemSupply: type: object properties: item_id: type: string description: Supply item ID quantity: type: number description: Quantity per unit unit: type: string description: Unit of measure deduction_method: type: string description: Deduction method ItemCustomField: type: object properties: field: type: string description: Custom field name value: type: string description: Custom field value required: - field - value securitySchemes: SKULabsToken: type: http scheme: bearer bearerFormat: JWT ````