{"templateId":"markdown","sharedDataIds":{"sidebar":"sidebar-sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":[]},"type":"markdown","redocly_category":"Guides","api_domain":"Catalog"},"seo":{"title":"Select query parameter","description":"How to use the $select query parameter to choose specific fields in Sales Layer Catalog API responses.","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":"select","__idx":0},"children":["Select"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Use ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["$select"]}," to choose which properties of a resource should be included in a response."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["This parameter is supported by selected Catalog API endpoints. It is not documented in the current DAM OpenAPI specification."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"when-to-use-select","__idx":1},"children":["When to use ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["$select"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Use ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["$select"]}," when an integration only needs a subset of fields."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["This can reduce response size, simplify processing, and make synchronization jobs easier to debug."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"syntax","__idx":2},"children":["Syntax"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"text","header":{"controls":{"copy":{}}},"source":"$select=PROPERTY_NAME,ANOTHER_PROPERTY_NAME\n","lang":"text"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Example:"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"http","header":{"controls":{"copy":{}}},"source":"GET https://api2.saleslayer.com/catalog/rest/Catalog/Products?$select=prod_ref,prod_title\n","lang":"http"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"supported-properties","__idx":3},"children":["Supported properties"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The property names must match the resource metadata exposed by the Catalog API."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Use metadata endpoints to inspect available fields before building dynamic requests:"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"http","header":{"controls":{"copy":{}}},"source":"GET https://api2.saleslayer.com/catalog/rest/Catalog/Products/$metadata\nGET https://api2.saleslayer.com/catalog/rest/Catalog/Categories/$metadata\nGET https://api2.saleslayer.com/catalog/rest/Catalog/Variants/$metadata\n","lang":"http"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"example-response","__idx":4},"children":["Example response"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{\n  \"value\": [\n    {\n      \"prod_ref\": \"PROD-001\",\n      \"prod_title\": {\n        \"en\": \"Example product\"\n      }\n    }\n  ],\n  \"@count\": 1,\n  \"@readLink\": \"https://api2.saleslayer.com/catalog/rest/Catalog/Products?$select=prod_ref,prod_title\"\n}\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"notes","__idx":5},"children":["Notes"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["$select"]}," applies to properties of the requested resource."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Use exact property names from metadata."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Combine ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["$select"]}," with ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["$filter"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["$orderby"]},", and pagination when supported by the endpoint."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["If a field is missing from the response, verify that it was included in ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["$select"]}," and is available for the resource."]}]}]},"headings":[{"value":"Select","id":"select","depth":1},{"value":"When to use $select","id":"when-to-use-select","depth":2},{"value":"Syntax","id":"syntax","depth":2},{"value":"Supported properties","id":"supported-properties","depth":2},{"value":"Example response","id":"example-response","depth":2},{"value":"Notes","id":"notes","depth":2}],"frontmatter":{"seo":{"title":"Select query parameter","description":"How to use the $select query parameter to choose specific fields in Sales Layer Catalog API responses."},"keywords":{"includes":["$select","query parameters","field selection","Catalog API"]},"metadata":{"redocly_category":"Guides","api_domain":"Catalog"}},"lastModified":"2026-06-04T20:25:57.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/guides/select","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}