--- updatedAt: 2026-06-30T16:05:21.000Z agentTools: projectIndex: https://docs.pelcro.com/llms.txt --- # List SKUs Retrieve a paginated list of product SKUs. ## Overview Retrieve a paginated list of all SKUs (product variants). Use filters to narrow results by product or availability. **Example:** List all SKUs for inventory management or to populate a product selection dropdown. *** | Feature | Fields | | -------------------------------------------- | -------------------------- | | [Searchable](api-core-filtering-and-sorting) | `id`, `name`, `product_id` | | [Sortable](api-core-filtering-and-sorting) | `id`, `name`, `product_id` | # OpenAPI definition ```json { "openapi": "3.1.0", "info": { "title": "core-api", "version": "1.88" }, "servers": [ { "url": "https://www.pelcro.com/api/v1/core" } ], "components": { "securitySchemes": { "sec0": { "type": "apiKey", "in": "header", "name": "Authorization", "x-bearer-format": "bearer" }, "sec1": { "type": "apiKey", "in": "query", "name": "site_id" } } }, "security": [ { "sec0": [], "sec1": [] } ], "paths": { "/ecommerce/products/skus": { "get": { "summary": "List SKUs", "description": "Retrieve a paginated list of product SKUs.", "operationId": "api-core-list-skus", "parameters": [ { "name": "Authorization", "in": "header", "required": true, "schema": { "type": "string", "default": "Bearer eyJ***" } }, { "name": "site_id", "in": "query", "description": "The unique identifier of the site associated with your account.", "required": true, "schema": { "type": "integer", "format": "int32" } }, { "name": "limit", "in": "query", "description": "The maximum number of objects you want returned per result set. For instance, if you set limit=10, the API will return a maximum of 10 objects in the response. (max: 100)", "schema": { "type": "integer", "format": "int32", "default": 10 } }, { "name": "page", "in": "query", "description": "The specific page of the result set you want to retrieve, typically used in conjunction with limit. For example, if you set page=2 and limit=10, the API will return the second page of results, containing a maximum of 10 objects starting from the 11th object.", "schema": { "type": "integer", "format": "int32", "default": 1 } }, { "name": "sort", "in": "query", "description": "Sort field. Prefix with - for descending.", "schema": { "type": "string", "enum": [ "id", "-id", "name", "-name", "product_id", "-product_id" ] } }, { "name": "filter[id]", "in": "query", "schema": { "type": "string" }, "description": "Filter by SKU ID. Example: eq:42" }, { "name": "filter[name]", "in": "query", "schema": { "type": "string" }, "description": "Filter by SKU name. Operators: eq, like. Example: like:premium" }, { "name": "filter[product_id]", "in": "query", "schema": { "type": "string" }, "description": "Filter by product ID. Example: eq:15" } ], "responses": { "200": { "description": "Success.", "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "integer" }, "product_id": { "type": "integer" }, "name": { "type": "string" }, "active": { "type": "boolean" }, "currency": { "type": "string" }, "countries": { "type": "array", "items": { "type": "string" }, "nullable": true }, "image": { "type": "string", "nullable": true }, "inventory_type": { "type": "integer" }, "inventory_quantity": { "type": "integer", "nullable": true }, "inventory_description": { "type": "string", "nullable": true }, "price": { "type": "integer" }, "weight": { "type": "number", "nullable": true }, "metadata": { "type": "object", "nullable": true }, "expires_at": { "type": "integer", "format": "int64", "nullable": true }, "entitlements": { "type": "array", "nullable": true }, "created_at": { "type": "integer", "format": "int64" }, "updated_at": { "type": "integer", "format": "int64" } } } }, "meta": { "type": "object" } } }, "examples": { "Result": { "value": "{\n\t\"data\": [\n\t\t{\n\t\t\t\"id\": 7,\n\t\t\t\"product_id\": 15,\n\t\t\t\"name\": \"core sku\",\n\t\t\t\"active\": false,\n\t\t\t\"currency\": \"cad\",\n\t\t\t\"image\": null,\n\t\t\t\"inventory_type\": 0,\n\t\t\t\"inventory_quantity\": null,\n\t\t\t\"price\": 2000,\n\t\t\t\"expires_at\": null,\n\t\t\t\"created_at\": 1661411822,\n\t\t\t\"updated_at\": 1661868750\n\t\t},\n\t\t{\n\t\t\t\"id\": 28,\n\t\t\t\"product_id\": 15,\n\t\t\t\"name\": \"core sku\",\n\t\t\t\"active\": true,\n\t\t\t\"currency\": \"cad\",\n\t\t\t\"image\": null,\n\t\t\t\"inventory_type\": 0,\n\t\t\t\"inventory_quantity\": null,\n\t\t\t\"price\": 150,\n\t\t\t\"expires_at\": null,\n\t\t\t\"created_at\": 1661865785,\n\t\t\t\"updated_at\": 1661865785\n\t\t},\n\t\t{\n\t\t\t\"id\": 32,\n\t\t\t\"product_id\": 15,\n\t\t\t\"name\": \"core sku\",\n\t\t\t\"active\": true,\n\t\t\t\"currency\": \"cad\",\n\t\t\t\"image\": null,\n\t\t\t\"inventory_type\": 1,\n\t\t\t\"inventory_quantity\": 10,\n\t\t\t\"price\": 1500,\n\t\t\t\"expires_at\": null,\n\t\t\t\"created_at\": 1661866254,\n\t\t\t\"updated_at\": 1661866254\n\t\t},\n\t],\n\t\"links\": {\n\t\t\"first\": \"https:\\/\\/staging.pelcro.com\\/api\\/v1\\/core\\/ecommerce\\/products\\/skus?page=1\",\n\t\t\"last\": \"https:\\/\\/www.pelcro.com\\/api\\/v1\\/core\\/ecommerce\\/products\\/skus?page=2\",\n\t\t\"prev\": null,\n\t\t\"next\": \"https:\\/\\/www.pelcro.com\\/api\\/v1\\/core\\/ecommerce\\/products\\/skus?page=2\"\n\t},\n\t\"meta\": {\n\t\t\"current_page\": 1,\n\t\t\"from\": 1,\n\t\t\"last_page\": 2,\n\t\t\"links\": [\n\t\t\t{\n\t\t\t\t\"url\": null,\n\t\t\t\t\"label\": \"« Previous\",\n\t\t\t\t\"active\": false\n\t\t\t},\n\t\t\t{\n\t\t\t\t\"url\": \"https:\\/\\/staging.pelcro.com\\/api\\/v1\\/core\\/ecommerce\\/products\\/skus?page=1\",\n\t\t\t\t\"label\": \"1\",\n\t\t\t\t\"active\": true\n\t\t\t},\n\t\t\t{\n\t\t\t\t\"url\": \"https:\\/\\/staging.pelcro.com\\/api\\/v1\\/core\\/ecommerce\\/products\\/skus?page=2\",\n\t\t\t\t\"label\": \"2\",\n\t\t\t\t\"active\": false\n\t\t\t},\n\t\t\t{\n\t\t\t\t\"url\": \"https:\\/\\/staging.pelcro.com\\/api\\/v1\\/core\\/ecommerce\\/products\\/skus?page=2\",\n\t\t\t\t\"label\": \"Next »\",\n\t\t\t\t\"active\": false\n\t\t\t}\n\t\t],\n\t\t\"path\": \"https:\\/\\/staging.pelcro.com\\/api\\/v1\\/core\\/ecommerce\\/products\\/skus\",\n\t\t\"per_page\": 10,\n\t\t\"to\": 10,\n\t\t\"total\": 11\n\t}\n}" } } } } }, "400": { "description": "Invalid request.", "content": { "application/json": { "examples": { "Result": { "value": "{\n \"error\": {\n \"status\": 400,\n \"message\": \"Invalid request, please try again.\"\n }\n}" } }, "schema": { "type": "object", "properties": { "error": { "type": "object", "properties": { "status": { "type": "integer", "example": 400, "default": 0 }, "message": { "type": "string", "example": "Invalid request, please try again." } } } } } } } }, "401": { "description": "Unauthenticated.", "content": { "application/json": { "examples": { "Result": { "value": { "error": "Unauthenticated." } } } } } } }, "deprecated": false } } }, "x-readme": { "headers": [], "explorer-enabled": true, "proxy-enabled": true }, "x-readme-fauxas": true } ``` # Sibling pages * [Get SKU](https://docs.pelcro.com/reference/api-core-get-ecommerce-sku.md) * [Create SKU](https://docs.pelcro.com/reference/api-core-create-ecommerce-sku.md) * [Update SKU](https://docs.pelcro.com/reference/api-core-update-ecommerce-sku.md) * [Delete SKU](https://docs.pelcro.com/reference/api-core-delete-ecommerce-sku.md)