{"templateId":"markdown","sharedDataIds":{"sidebar":"sidebar-sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":[]},"type":"markdown","redocly_category":"API Reference","api_domain":"Catalog"},"seo":{"title":"Catalog REST API overview","description":"Functional overview of the Sales Layer Catalog REST API for products, variants, categories, custom entities, metadata, and changelogs.","keywords":["Sales Layer","REST API","OpenAPI","DAM API","Catalog API","product catalog API","image management API","API integration"],"lang":"en-US","meta":[{"name":"og:type","content":"website"},{"name":"og:site_name","content":"Sales Layer REST API Documentation"},{"name":"og:title","content":"Sales Layer REST API Documentation"},{"name":"og:description","content":"Complete REST API documentation for Sales Layer's DAM and Catalog APIs. Learn authentication, pagination, filtering, and integration patterns."},{"name":"twitter:card","content":"summary_large_image"},{"name":"twitter:site","content":"@saleslayer"},{"name":"twitter:title","content":"Sales Layer REST API Documentation"},{"name":"twitter:description","content":"Complete REST API documentation for Sales Layer's DAM and Catalog APIs. Learn authentication, pagination, filtering, and integration patterns."}],"llmstxt":{"hide":false,"title":"Sales Layer REST API Documentation","description":"Technical guides and OpenAPI references for Sales Layer DAM and Catalog REST APIs.","sections":[{"title":"Guides","description":"Static API guides for authentication, headers, query parameters, responses, rate limiting, and best practices.","includeFiles":["guides/**/*.md","changelog.md"],"excludeFiles":[]},{"title":"API Reference","description":"OpenAPI-based references and API overview pages for Sales Layer REST APIs.","includeFiles":["apis/**/*.md","apis/**/*.yaml"],"excludeFiles":[]},{"title":"Postman collections","description":"Importable Postman collection and environment instructions for testing Sales Layer REST APIs.","includeFiles":["postman/**/*.md"],"excludeFiles":[]}],"excludeFiles":[]}},"dynamicMarkdocComponents":[],"compilationErrors":[],"ast":{"$$mdtype":"Tag","name":"article","attributes":{},"children":[{"$$mdtype":"Tag","name":"Heading","attributes":{"level":1,"id":"catalog-rest-api-overview","__idx":0},"children":["Catalog REST API overview"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The Catalog REST API is used to integrate external systems with Sales Layer catalog data."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["It exposes resources such as products, variants, categories, attribute sets, custom entities, metadata, and changelogs. These endpoints are useful for integrations that need to read catalog information, synchronize changes, or create and update catalog records from another system."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Use this API when Sales Layer is part of a wider product information flow involving ecommerce platforms, ERPs, marketplaces, DAM systems, supplier systems, translation workflows, or reporting tools."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"main-resource-areas","__idx":1},"children":["Main resource areas"]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Area"},"children":["Area"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"What it represents"},"children":["What it represents"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Products"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Core product records managed in Sales Layer."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Variants"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Product variant records associated with products."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Categories"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Category structures used to organize catalog information."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Attribute sets"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Attribute set definitions used to group product data requirements."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Custom entities"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Customer-specific catalog entities and their items."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Metadata"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["JSON schema-style information that describes available fields and relationships."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Changelogs"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Change history that helps integrations detect updates over time."]}]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"common-use-cases","__idx":2},"children":["Common use cases"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Use the Catalog REST API to:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Retrieve products, variants, categories, and custom entity items for downstream systems."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Filter and paginate catalog data for synchronization jobs."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Create, update, or delete catalog records when the integration owns that workflow."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Retrieve metadata so an integration can understand available fields before building requests."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Read changelogs to detect what changed since a previous synchronization."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Access product data in the context of categories or attribute sets."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"endpoint-groups","__idx":3},"children":["Endpoint groups"]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"metadata-endpoints","__idx":4},"children":["Metadata endpoints"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Metadata endpoints describe the structure of catalog resources. They help integrations discover available fields, relationships, and localized content rules before requesting or writing data."]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Endpoint area"},"children":["Endpoint area"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Functional description"},"children":["Functional description"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Catalog metadata"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Describes the public catalog model."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Product metadata"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Describes product fields and relationships."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Variant metadata"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Describes variant fields and relationships."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Category metadata"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Describes category fields and relationships."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Attribute set metadata"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Describes attribute set fields and relationships."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Custom entity metadata"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Describes custom entity structures by denominator."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Point of sale metadata"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Describes point of sale metadata exposed by the catalog API."]}]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"read-endpoints","__idx":5},"children":["Read endpoints"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Read endpoints return catalog resources. They support integration patterns such as search, filtering, synchronization, and export."]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Resource"},"children":["Resource"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Functional description"},"children":["Functional description"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Attribute sets"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["List or retrieve attribute set records."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Categories"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["List, filter, or retrieve category records."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Custom entities"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["List, filter, or retrieve custom entity items for a specific custom entity type."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Products"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["List, filter, or retrieve product records."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Products in categories"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Retrieve products associated with a category."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Products in attribute sets"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Retrieve products associated with an attribute set."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Variants"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["List, filter, or retrieve variant records."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Variants in products"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Retrieve variants associated with a product."]}]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"write-endpoints","__idx":6},"children":["Write endpoints"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Write endpoints create, update, or delete catalog records. Use them when your integration is responsible for sending controlled changes into Sales Layer."]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Resource"},"children":["Resource"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Supported actions"},"children":["Supported actions"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Categories"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Create, update, and delete categories."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Custom entities"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Create, update, and delete custom entity items."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Products"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Create, update, and delete products."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Variants"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Create, update, and delete variants."]}]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"changelog-endpoints","__idx":7},"children":["Changelog endpoints"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Changelog endpoints help integrations identify changes without reprocessing the full catalog every time."]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Resource"},"children":["Resource"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Functional description"},"children":["Functional description"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Categories changelog"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Returns changes for categories or a specific category."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Custom entities changelog"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Returns changes for custom entity items."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Products changelog"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Returns changes for products or a specific product."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Variants changelog"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Returns changes for variants or a specific variant."]}]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"before-implementing","__idx":8},"children":["Before implementing"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Make sure your integration:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Sends a valid API key in the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["X-API-KEY"]}," header."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Uses metadata endpoints to understand available fields before building dynamic requests."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Uses filtering and pagination for large catalog reads."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Uses changelog endpoints for incremental synchronization when possible."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Applies retry and rate limiting behavior as described in ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/guides/rate-limiting"},"children":["Rate limiting"]},"."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Reviews ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/guides/versioning-and-compatibility"},"children":["Versioning and compatibility"]}," before updating generated clients or mappings."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"technical-reference","__idx":9},"children":["Technical reference"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Use the ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/apis/catalog-v2.0"},"children":["Catalog REST API v2.0 OpenAPI reference"]}," for request parameters, schemas, examples, and status codes."]}]},"headings":[{"value":"Catalog REST API overview","id":"catalog-rest-api-overview","depth":1},{"value":"Main resource areas","id":"main-resource-areas","depth":2},{"value":"Common use cases","id":"common-use-cases","depth":2},{"value":"Endpoint groups","id":"endpoint-groups","depth":2},{"value":"Metadata endpoints","id":"metadata-endpoints","depth":3},{"value":"Read endpoints","id":"read-endpoints","depth":3},{"value":"Write endpoints","id":"write-endpoints","depth":3},{"value":"Changelog endpoints","id":"changelog-endpoints","depth":3},{"value":"Before implementing","id":"before-implementing","depth":2},{"value":"Technical reference","id":"technical-reference","depth":2}],"frontmatter":{"seo":{"title":"Catalog REST API overview","description":"Functional overview of the Sales Layer Catalog REST API for products, variants, categories, custom entities, metadata, and changelogs."},"keywords":{"includes":["Catalog API","products API","variants API","categories API","custom entities API"]},"metadata":{"redocly_category":"API Reference","api_domain":"Catalog"}},"lastModified":"2026-06-03T15:43:35.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/apis/catalog","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}