List products with pagination, filtering, and sorting. Results are automatically filtered by the authenticated merchant unless a different merchantId is provided in the filter.
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Cheqpay","colors":{"primary":"#16A34A","light":"#07C983","dark":"#15803D"},"logo":{"light":"https://mintcdn.com/cheqpay/WjCfb-k6AR5eUe0H/logo/logo.svg?fit=max\u0026auto=format\u0026n=WjCfb-k6AR5eUe0H\u0026q=85\u0026s=6e22e4768984a8158b3094e120aaf1ff","dark":"https://mintcdn.com/cheqpay/WjCfb-k6AR5eUe0H/logo/logo.svg?fit=max\u0026auto=format\u0026n=WjCfb-k6AR5eUe0H\u0026q=85\u0026s=6e22e4768984a8158b3094e120aaf1ff","href":"https://www.cheqpay.mx/"},"favicon":"https://mintlify.s3.us-west-1.amazonaws.com/cheqpay/logo/logo.avif","navbar":{},"footer":{"socials":{"x":"https://x.com/cheqpay","github":"https://github.com/cheqpay","linkedin":"https://linkedin.com/company/cheqpay"}},"contextual":{"options":["copy","view","chatgpt","claude","perplexity","mcp","cursor","vscode"],"display":"header"},"styling":{"latex":false},"navigation":{"global":{"anchors":[]},"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"cheqpay","hasAudioNarration":false,"actualSubdomain":"cheqpay","customDomains":["docs.cheqpay.mx"],"gitSource":{"type":"github","owner":"cheqpay","repo":"docs","deployBranch":"main","contentDirectory":"","isPrivate":true,"mountPath":"","label":""},"entitlements":{},"buildId":"6aac66185343956ba6628a63","clientVersion":"0.0.4087","searchFilterCounts":[{"language":"default","tag":"Payment Orchestrator API","count":37},{"language":"default","tag":"Features","count":14},{"language":"default","tag":"Link Product API","count":13},{"language":"default","tag":"Payment Order","count":9},{"language":"default","tag":"Products","count":6},{"language":"default","tag":"Subscription","count":6},{"language":"default","tag":"Customer V2","count":5},{"language":"default","tag":"Payment Method","count":5},{"language":"default","tag":"Subscription Plan","count":5},{"language":"default","tag":"Guides","count":4}]},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":false,"enableAskAiSearchBar":true},"basePath":"","hasChatPermissions":false,"hasWebMcpPermissions":false,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"rbac-expansion","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"full-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-dual-write","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"approve-review-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-metadata","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"sso-setup-deadline-banner","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-serve","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"live-agents","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"comment-mode","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[],"page":{"pagePath":"api-reference/products/list-products","slug":"/api-reference/products/list-products","pageMetadata":{"title":"List products","description":"List products with pagination, filtering, and sorting. Results are automatically filtered by the authenticated merchant unless a different merchantId is provided in the filter.","deprecated":null,"version":null,"openapi":"/api-reference/link-product-openapi.json post /products/list","href":"/api-reference/products/list-products","autogeneratedByOpenApi":true},"description":{"compiledSource":"\"use strict\";\nconst {jsx: _jsx} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsx(_components.p, {\n children: \"List products with pagination, filtering, and sorting. Results are automatically filtered by the authenticated merchant unless a different merchantId is provided in the filter.\"\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){return _jsx(_Fragment,{})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"List products","description":"List products with pagination, filtering, and sorting. Results are automatically filtered by the authenticated merchant unless a different merchantId is provided in the filter.","deprecated":null,"version":null,"openapi":"/api-reference/link-product-openapi.json post /products/list","href":"/api-reference/products/list-products","autogeneratedByOpenApi":true}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":["/_mintlify/custom/cheqpay/bdac4afbee45d6cc/scripts/sync-openapi.js"],"openApiReferenceData":{"operation":{"tags":["Products"],"summary":"List products","description":"List products with pagination, filtering, and sorting. Results are automatically filtered by the authenticated merchant unless a different merchantId is provided in the filter.","security":["c15cbf17-46e8-4de1-bb79-d312d685cf37"],"requestBody":"a4f192e9-65ed-4221-82b7-b711b1ca3a85","responses":{"200":"70264d6f-4c12-494e-9581-c590c233691e","400":"dc5951a9-5e53-43e0-a10a-3b74b767119b","401":"a78d60d7-e2e7-4064-97ff-877089d8e9d4","500":"35dbae31-5a31-401a-bb1e-e1640efff948"},"method":"post","type":"path","servers":["ee30a8d1-4607-4822-8023-57c60b4cd7d6","9e31f532-8a84-4880-a741-97cd3481ff79"],"path":"/products/list","baseUrlOptions":["https://api.sandbox.cheqpay.mx/lps","https://prod.cheqpay.mx/lps"],"title":"List products","codeSamples":[],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{},"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","description":"Request to list products with pagination and filters","properties":{"page":{"type":"integer","minimum":1,"default":1,"description":"Page number (1-indexed)","uniqueKey":"page","typeLabel":"integer"},"limit":{"type":"integer","minimum":1,"maximum":100,"default":10,"description":"Number of items per page","uniqueKey":"limit","typeLabel":"integer"},"filter":{"type":"object","description":"Filter criteria","properties":{"search":{"type":"string","description":"Search term to filter by product name (case-insensitive)","uniqueKey":"filter.search","typeLabel":"string"},"status":{"type":"string","enum":["active","inactive"],"description":"Product status","uniqueKey":"filter.status","typeLabel":"enum\u003cstring>"},"merchantId":{"type":"string","pattern":"^[a-f\\d]{24}$","description":"Merchant ID to filter by (defaults to authenticated merchant if not provided)","uniqueKey":"filter.merchantId","typeLabel":"string"}},"uniqueKey":"filter","typeLabel":"object"},"sort":{"type":"object","description":"Sort criteria","properties":{"field":{"type":"string","enum":["createdAt","name","price","status","updatedAt"],"default":"createdAt","description":"Field to sort by","uniqueKey":"sort.field","typeLabel":"enum\u003cstring>"},"order":{"type":"string","enum":["asc","desc"],"default":"desc","description":"Sort order","uniqueKey":"sort.order","typeLabel":"enum\u003cstring>"}},"uniqueKey":"sort","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"example":{"page":1,"limit":10,"filter":{"search":"Premium"},"sort":{"field":"createdAt","order":"desc"}},"examples":{"Example":{"title":"Example","value":{"page":1,"limit":10,"filter":{"search":"Premium"},"sort":{"field":"createdAt","order":"desc"}}}},"exampleType":"examples"}},"exampleType":"examples"},"responses":{"70264d6f-4c12-494e-9581-c590c233691e":{"description":"Products retrieved successfully","content":{"application/json":{"schema":{"type":"object","description":"Paginated response containing products","required":["data","currentPage","totalPages","totalCount","limit"],"properties":{"data":{"type":"array","description":"Array of products","items":{"type":"object","description":"Product entity","required":["_id","merchantId","name","price"],"properties":{"_id":{"type":"string","description":"MongoDB ObjectId","pattern":"^[a-f\\d]{24}$","isRequired":true,"uniqueKey":"data.items.[INDEX]._id","typeLabel":"string"},"merchantId":{"type":"string","pattern":"^[a-f\\d]{24}$","description":"Merchant identifier","isRequired":true,"uniqueKey":"data.items.[INDEX].merchantId","typeLabel":"string"},"name":{"type":"string","description":"Product name","isRequired":true,"uniqueKey":"data.items.[INDEX].name","typeLabel":"string"},"price":{"type":"number","minimum":0,"description":"Product price","isRequired":true,"uniqueKey":"data.items.[INDEX].price","typeLabel":"number"},"id":{"type":"string","description":"Custom product identifier","uniqueKey":"data.items.[INDEX].id","typeLabel":"string"},"description":{"type":"string","description":"Product description","uniqueKey":"data.items.[INDEX].description","typeLabel":"string"},"status":{"type":"string","enum":["active","inactive"],"default":"active","description":"Product status","uniqueKey":"data.items.[INDEX].status","typeLabel":"enum\u003cstring>"},"imageUrl":{"type":"string","description":"Product image URL","uniqueKey":"data.items.[INDEX].imageUrl","typeLabel":"string"},"createdAt":{"type":"string","format":"date-time","description":"Creation timestamp","uniqueKey":"data.items.[INDEX].createdAt","typeLabel":"string\u003cdate-time>"},"updatedAt":{"type":"string","format":"date-time","description":"Last update timestamp","uniqueKey":"data.items.[INDEX].updatedAt","typeLabel":"string\u003cdate-time>"},"deletedAt":{"oneOf":[{"type":"string","format":"date-time","description":"Soft deletion timestamp (null if not deleted)","uniqueKey":"data.items.[INDEX].deletedAt.oneOf.0","typeLabel":"string\u003cdate-time>"},{"type":"null","format":"date-time","description":"Soft deletion timestamp (null if not deleted)","uniqueKey":"data.items.[INDEX].deletedAt.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.items.[INDEX].deletedAt","typeLabel":"string\u003cdate-time> | null"}},"uniqueKey":"data.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"data","typeLabel":"object[]"},"currentPage":{"type":"integer","description":"Current page number","example":1,"isRequired":true,"uniqueKey":"currentPage","typeLabel":"integer"},"totalPages":{"type":"integer","description":"Total number of pages","example":5,"isRequired":true,"uniqueKey":"totalPages","typeLabel":"integer"},"totalCount":{"type":"integer","description":"Total number of products matching the filter","example":47,"isRequired":true,"uniqueKey":"totalCount","typeLabel":"integer"},"limit":{"type":"integer","description":"Number of items per page","example":10,"isRequired":true,"uniqueKey":"limit","typeLabel":"integer"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"data":[{"_id":"\u003cstring>","merchantId":"\u003cstring>","name":"\u003cstring>","price":1,"id":"\u003cstring>","description":"\u003cstring>","status":"active","imageUrl":"\u003cstring>","createdAt":"2023-11-07T05:31:56Z","updatedAt":"2023-11-07T05:31:56Z","deletedAt":"2023-11-07T05:31:56Z"}],"currentPage":1,"totalPages":5,"totalCount":47,"limit":10}}},"exampleType":"generated"}},"exampleType":"generated"},"dc5951a9-5e53-43e0-a10a-3b74b767119b":{"description":"Invalid input","content":{"application/json":{"schema":{"type":"object","description":"Validation error response","properties":{"message":{"type":"string","description":"Error message","example":"Validation failed","uniqueKey":"message","typeLabel":"string"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"message":"Validation failed"}}},"exampleType":"generated"}},"exampleType":"generated"},"a78d60d7-e2e7-4064-97ff-877089d8e9d4":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","description":"Unauthorized error response","properties":{"message":{"type":"string","description":"Error message","example":"Unauthorized","uniqueKey":"message","typeLabel":"string"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"message":"Unauthorized"}}},"exampleType":"generated"}},"exampleType":"generated"},"35dbae31-5a31-401a-bb1e-e1640efff948":{"description":"Internal server error","content":{"application/json":{"schema":{"type":"object","description":"Internal server error response","properties":{"message":{"type":"string","description":"Error message","example":"Internal server error","uniqueKey":"message","typeLabel":"string"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"message":"Internal server error"}}},"exampleType":"generated"}},"exampleType":"generated"}},"security":{"c15cbf17-46e8-4de1-bb79-d312d685cf37":{"ApiKeyAuth":{"type":"apiKey","in":"header","name":"x-api-key","description":"API key for merchant authentication","scopes":[]}}},"servers":{"ee30a8d1-4607-4822-8023-57c60b4cd7d6":{"url":"https://api.sandbox.cheqpay.mx/lps","description":"Sandbox environment"},"9e31f532-8a84-4880-a741-97cd3481ff79":{"url":"https://prod.cheqpay.mx/lps","description":"Production environment"}},"processedSecurityOptions":[{"schemes":[{"scheme":{"type":"apiKey","in":"header","name":"x-api-key","description":"API key for merchant authentication","scopes":[]},"schema":{"title":"x-api-key","type":"string","description":"API key for merchant authentication","isRequired":true,"typeLabel":"string","deprecated":false},"schemeName":"ApiKeyAuth","name":"x-api-key"}],"title":"ApiKeyAuth"}]},"originalFileLocation":"api-reference/link-product-openapi.json"},"subdomain":"cheqpay","siteName":"Cheqpay","title":"List products - Cheqpay","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-08-27T21:53:20.517Z","originalFileLocation":"api-reference/products/list-products.mdx"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=null;if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"system\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"description\" content=\"List products with pagination, filtering, and sorting. Results are automatically filtered by the authenticated merchant unless a different merchantId is provided in the filter.\">\u003cmeta data-mint-head name=\"application-name\" content=\"Cheqpay\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"https://mintlify.s3.us-west-1.amazonaws.com/cheqpay/logo/logo.avif\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"https://mintlify.s3.us-west-1.amazonaws.com/cheqpay/logo/logo.avif\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"https://mintlify.s3.us-west-1.amazonaws.com/cheqpay/logo/logo.avif\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/png\" href=\"https://mintlify.s3.us-west-1.amazonaws.com/cheqpay/logo/logo.avif\">\u003cmeta data-mint-head property=\"og:title\" content=\"List products - Cheqpay\">\u003cmeta data-mint-head property=\"og:description\" content=\"List products with pagination, filtering, and sorting. Results are automatically filtered by the authenticated merchant unless a different merchantId is provided in the filter.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Cheqpay\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.cheqpay.mx/api-reference/products/list-products\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://cheqpay.mintlify.site/_mintlify/api/og/v2?division=Products\u0026amp;title=List+products\u0026amp;description=List+products+with+pagination%2C+filtering%2C+and+sorting.+Results+are+automatically+filtered+by+the+authenticated+merchant+unless+a+different+merchantId+is+provide\u0026amp;theme=6e0753f2de9f986dbda32f79\u0026amp;signature=5dc25d620a9bb1d4d1bc6a7d736a247342df596b04e0c66b7c8f7421934297f8\">\u003cmeta data-mint-head property=\"og:image:width\" content=\"1200\">\u003cmeta data-mint-head property=\"og:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"twitter:card\" content=\"summary_large_image\">\u003cmeta data-mint-head name=\"twitter:title\" content=\"List products - Cheqpay\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"List products with pagination, filtering, and sorting. Results are automatically filtered by the authenticated merchant unless a different merchantId is provided in the filter.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://cheqpay.mintlify.site/_mintlify/api/og/v2?division=Products\u0026amp;title=List+products\u0026amp;description=List+products+with+pagination%2C+filtering%2C+and+sorting.+Results+are+automatically+filtered+by+the+authenticated+merchant+unless+a+different+merchantId+is+provide\u0026amp;theme=6e0753f2de9f986dbda32f79\u0026amp;signature=5dc25d620a9bb1d4d1bc6a7d736a247342df596b04e0c66b7c8f7421934297f8\">\u003cmeta data-mint-head name=\"twitter:image:width\" content=\"1200\">\u003cmeta data-mint-head name=\"twitter:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"msapplication-config\" content=\"https://mintlify.s3.us-west-1.amazonaws.com/cheqpay/_generated/favicon/browserconfig.xml?v=3\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Cheqpay\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#16A34A\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.cheqpay.mx/api-reference/products/list-products\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/api-reference/products/list-products.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.cheqpay.mx/#organization\",\"name\":\"Cheqpay\",\"url\":\"https://docs.cheqpay.mx\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/cheqpay/WjCfb-k6AR5eUe0H/logo/logo.svg?fit=max\u0026auto=format\u0026n=WjCfb-k6AR5eUe0H\u0026q=85\u0026s=6e22e4768984a8158b3094e120aaf1ff\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.cheqpay.mx#website\",\"name\":\"Cheqpay\",\"url\":\"https://docs.cheqpay.mx\",\"publisher\":{\"@id\":\"https://docs.cheqpay.mx/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.cheqpay.mx/api-reference/products/list-products#webpage\",\"url\":\"https://docs.cheqpay.mx/api-reference/products/list-products\",\"name\":\"List products\",\"description\":\"List products with pagination, filtering, and sorting. Results are automatically filtered by the authenticated merchant unless a different merchantId is provided in the filter.\",\"dateModified\":\"2026-08-27T21:53:20.517Z\",\"isPartOf\":{\"@id\":\"https://docs.cheqpay.mx#website\"},\"breadcrumb\":{\"@id\":\"https://docs.cheqpay.mx/api-reference/products/list-products#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.cheqpay.mx/api-reference/products/list-products#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Link Product API\",\"item\":\"https://docs.cheqpay.mx/api-reference/payment-links/create-payment-link\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Products\",\"item\":\"https://docs.cheqpay.mx/api-reference/products/create-product\"},{\"@type\":\"ListItem\",\"position\":3,\"name\":\"List products\",\"item\":\"https://docs.cheqpay.mx/api-reference/products/list-products\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.cheqpay.mx/api-reference/products/list-products#apireference\",\"headline\":\"List products\",\"name\":\"List products\",\"description\":\"List products with pagination, filtering, and sorting. Results are automatically filtered by the authenticated merchant unless a different merchantId is provided in the filter.\",\"url\":\"https://docs.cheqpay.mx/api-reference/products/list-products\",\"mainEntityOfPage\":{\"@id\":\"https://docs.cheqpay.mx/api-reference/products/list-products#webpage\"},\"dateModified\":\"2026-08-27T21:53:20.517Z\",\"publisher\":{\"@id\":\"https://docs.cheqpay.mx/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.cheqpay.mx#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Cheqpay\",\"creator\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","siteName":"Cheqpay","nav":{"global":{"anchors":[]},"groups":[{"group":"Getting Started","pages":[{"title":"Welcome to Cheqpay","href":"/index"}]},{"group":"Essentials","pages":[{"title":"Authentication","href":"/essentials/authentication"},{"title":"Environments","href":"/essentials/environments"},{"title":"Quickstart","href":"/essentials/quickstart"}]},{"group":"Features","pages":[{"title":"Customers","href":"/features/customers"},{"title":"Payment Methods","href":"/features/payment-methods"},{"title":"Payment Orders","href":"/features/payment-orders"},{"title":"Pending Orders","href":"/features/pending-orders"},{"title":"Card Payments","href":"/features/card-payments"},{"title":"SPEI Transfers","href":"/features/spei-transfers"},{"title":"PayCash Payments","href":"/features/paycash-payments"},{"title":"CIE Cash Net Payments","href":"/features/cie-cash-net-payments"},{"title":"Hosted Payment Page","href":"/features/hosted-payment-page"},{"title":"Integrate via SDK","href":"/features/integrate-via-sdk"},{"title":"3D Secure","href":"/features/3d-secure"},{"title":"Refunds","href":"/features/refunds"},{"title":"Subscriptions","href":"/features/subscriptions"},{"title":"Webhooks","href":"/features/webhooks"}]},{"group":"Testing","pages":[{"title":"Webhook Simulators","href":"/testing/webhook-simulators"}]},{"group":"Guides","pages":[{"title":"Testing Guide","href":"/guides/testing"},{"title":"Error Handling","href":"/guides/error-handling"},{"title":"Best Practices","href":"/guides/best-practices"},{"title":"Going Live","href":"/guides/going-live"}]},{"group":"API Reference","pages":[{"title":"API Reference","href":"/api-reference/introduction"},{"title":"API Endpoints","href":"/api-reference/endpoints"},{"title":"Error Codes","href":"/api-reference/errors"}]},{"group":"Payment Orchestrator API","pages":[{"group":"Customer","pages":[{"title":"Get customer by external ID","deprecated":null,"version":null,"openapi":"/api-reference/orchestrator-openapi.json get /customers/{id}","href":"/api-reference/customer/get-customer-by-external-id"}]},{"group":"Customer V2","pages":[{"title":"List customers with pagination and filtering (v2)","deprecated":null,"version":null,"openapi":"/api-reference/orchestrator-openapi.json get /v2/customers","href":"/api-reference/customer-v2/list-customers-with-pagination-and-filtering-v2"},{"title":"Create a new customer (v2)","deprecated":null,"version":null,"openapi":"/api-reference/orchestrator-openapi.json post /v2/customers","href":"/api-reference/customer-v2/create-a-new-customer-v2"},{"title":"Get customer by ID (v2)","deprecated":null,"version":null,"openapi":"/api-reference/orchestrator-openapi.json get /v2/customers/{id}","href":"/api-reference/customer-v2/get-customer-by-id-v2"},{"title":"Update customer (v2)","deprecated":null,"version":null,"openapi":"/api-reference/orchestrator-openapi.json put /v2/customers/{id}","href":"/api-reference/customer-v2/update-customer-v2"},{"title":"Delete customer (v2)","deprecated":null,"version":null,"openapi":"/api-reference/orchestrator-openapi.json delete /v2/customers/{id}","href":"/api-reference/customer-v2/delete-customer-v2"}]},{"group":"Checkout","pages":[{"title":"Pay with card, spei, or cie cash net","deprecated":null,"version":null,"openapi":"/api-reference/orchestrator-openapi.json post /checkout/pay","href":"/api-reference/checkout/pay-with-card-spei-or-cie-cash-net"},{"title":"Pay with transfer batch","deprecated":null,"version":null,"openapi":"/api-reference/orchestrator-openapi.json post /checkout/pay-batch","href":"/api-reference/checkout/pay-with-transfer-batch"}]},{"group":"Payment Order","pages":[{"title":"List all payment orders","deprecated":null,"version":null,"openapi":"/api-reference/orchestrator-openapi.json get /v2/payment-orders","href":"/api-reference/payment-order/list-all-payment-orders"},{"title":"Create a payment order (v2)","deprecated":null,"version":null,"openapi":"/api-reference/orchestrator-openapi.json post /v2/payment-orders","href":"/api-reference/payment-order/create-a-payment-order-v2"},{"title":"Get payment order by ID or external ID","deprecated":null,"version":null,"openapi":"/api-reference/orchestrator-openapi.json get /v2/payment-orders/{id}","href":"/api-reference/payment-order/get-payment-order-by-id-or-external-id"},{"title":"Soft delete a payment order","deprecated":null,"version":null,"openapi":"/api-reference/orchestrator-openapi.json delete /v2/payment-orders/{id}","href":"/api-reference/payment-order/soft-delete-a-payment-order"},{"title":"Update a pending payment order","deprecated":null,"version":null,"openapi":"/api-reference/orchestrator-openapi.json patch /v2/payment-orders/{id}","href":"/api-reference/payment-order/update-a-pending-payment-order"},{"title":"Charge a pending payment order","deprecated":null,"version":null,"openapi":"/api-reference/orchestrator-openapi.json post /v2/payment-orders/{id}/charge","href":"/api-reference/payment-order/charge-a-pending-payment-order"},{"title":"Refund a Payment of a payment order (v2)","deprecated":null,"version":null,"openapi":"/api-reference/orchestrator-openapi.json post /v2/payment-orders/{id}/refund","href":"/api-reference/payment-order/refund-a-payment-of-a-payment-order-v2"},{"title":"Initiate 3DS payer authentication","deprecated":null,"version":null,"openapi":"/api-reference/orchestrator-openapi.json post /v2/payment-orders/{id}/payer-authentication","href":"/api-reference/payment-order/initiate-3ds-payer-authentication"},{"title":"Validate 3DS payer authentication","deprecated":null,"version":null,"openapi":"/api-reference/orchestrator-openapi.json post /v2/payment-orders/{id}/payer-authentication/validate","href":"/api-reference/payment-order/validate-3ds-payer-authentication"}]},{"group":"Payment Method","pages":[{"title":"Create a payment method","deprecated":null,"version":null,"openapi":"/api-reference/orchestrator-openapi.json post /payment-methods","href":"/api-reference/payment-method/create-a-payment-method"},{"title":"Get a payment method by ID","deprecated":null,"version":null,"openapi":"/api-reference/orchestrator-openapi.json get /payment-methods/{id}","href":"/api-reference/payment-method/get-a-payment-method-by-id"},{"title":"Update a payment method","deprecated":null,"version":null,"openapi":"/api-reference/orchestrator-openapi.json put /payment-methods/{id}","href":"/api-reference/payment-method/update-a-payment-method"},{"title":"Delete a payment method","deprecated":null,"version":null,"openapi":"/api-reference/orchestrator-openapi.json delete /payment-methods/{id}","href":"/api-reference/payment-method/delete-a-payment-method"},{"title":"List payment methods for a customer","deprecated":null,"version":null,"openapi":"/api-reference/orchestrator-openapi.json get /v2/customers/{customerId}/payment-methods","href":"/api-reference/payment-method/list-payment-methods-for-a-customer"}]},{"group":"Subscription Plan","pages":[{"title":"List subscription plans","deprecated":null,"version":null,"openapi":"/api-reference/orchestrator-openapi.json get /v1/plans","href":"/api-reference/subscription-plan/list-subscription-plans"},{"title":"Create a subscription plan","deprecated":null,"version":null,"openapi":"/api-reference/orchestrator-openapi.json post /v1/plans","href":"/api-reference/subscription-plan/create-a-subscription-plan"},{"title":"Get a subscription plan by ID","deprecated":null,"version":null,"openapi":"/api-reference/orchestrator-openapi.json get /v1/plans/{id}","href":"/api-reference/subscription-plan/get-a-subscription-plan-by-id"},{"title":"Archive a subscription plan","deprecated":null,"version":null,"openapi":"/api-reference/orchestrator-openapi.json delete /v1/plans/{id}","href":"/api-reference/subscription-plan/archive-a-subscription-plan"},{"title":"Update a subscription plan","deprecated":null,"version":null,"openapi":"/api-reference/orchestrator-openapi.json patch /v1/plans/{id}","href":"/api-reference/subscription-plan/update-a-subscription-plan"}]},{"group":"Subscription","pages":[{"title":"List subscriptions","deprecated":null,"version":null,"openapi":"/api-reference/orchestrator-openapi.json get /v1/subscriptions","href":"/api-reference/subscription/list-subscriptions"},{"title":"Create a subscription","deprecated":null,"version":null,"openapi":"/api-reference/orchestrator-openapi.json post /v1/subscriptions","href":"/api-reference/subscription/create-a-subscription"},{"title":"Get a subscription by ID","deprecated":null,"version":null,"openapi":"/api-reference/orchestrator-openapi.json get /v1/subscriptions/{id}","href":"/api-reference/subscription/get-a-subscription-by-id"},{"title":"Update a subscription","deprecated":null,"version":null,"openapi":"/api-reference/orchestrator-openapi.json patch /v1/subscriptions/{id}","href":"/api-reference/subscription/update-a-subscription"},{"title":"Change subscription plan","deprecated":null,"version":null,"openapi":"/api-reference/orchestrator-openapi.json patch /v1/subscriptions/{id}/plan","href":"/api-reference/subscription/change-subscription-plan"},{"title":"Cancel a subscription","deprecated":null,"version":null,"openapi":"/api-reference/orchestrator-openapi.json post /v1/subscriptions/{id}/cancel","href":"/api-reference/subscription/cancel-a-subscription"}]},{"group":"Subscription Invoice","pages":[{"title":"List invoices for a subscription","deprecated":null,"version":null,"openapi":"/api-reference/orchestrator-openapi.json get /v1/subscriptions/{id}/invoices","href":"/api-reference/subscription-invoice/list-invoices-for-a-subscription"},{"title":"Get an invoice by ID","deprecated":null,"version":null,"openapi":"/api-reference/orchestrator-openapi.json get /v1/subscription-invoices/{id}","href":"/api-reference/subscription-invoice/get-an-invoice-by-id"},{"title":"Process payment for an invoice","deprecated":null,"version":null,"openapi":"/api-reference/orchestrator-openapi.json post /v1/subscription-invoices/{id}/pay","href":"/api-reference/subscription-invoice/process-payment-for-an-invoice"},{"title":"Void an invoice","deprecated":null,"version":null,"openapi":"/api-reference/orchestrator-openapi.json post /v1/subscription-invoices/{id}/void","href":"/api-reference/subscription-invoice/void-an-invoice"}]}]},{"group":"Link Product API","pages":[{"group":"Payment Links","pages":[{"title":"Create payment link","deprecated":null,"version":null,"openapi":"/api-reference/link-product-openapi.json post /payment-links","href":"/api-reference/payment-links/create-payment-link"},{"title":"List payment links","deprecated":null,"version":null,"openapi":"/api-reference/link-product-openapi.json post /payment-links/list","href":"/api-reference/payment-links/list-payment-links"},{"title":"Get payment link","deprecated":null,"version":null,"openapi":"/api-reference/link-product-openapi.json get /payment-links/{id}","href":"/api-reference/payment-links/get-payment-link"},{"title":"Update payment link","deprecated":null,"version":null,"openapi":"/api-reference/link-product-openapi.json put /payment-links/{id}","href":"/api-reference/payment-links/update-payment-link"}]},{"group":"Products","pages":[{"title":"Create product","deprecated":null,"version":null,"openapi":"/api-reference/link-product-openapi.json post /products","href":"/api-reference/products/create-product"},{"title":"Get product","deprecated":null,"version":null,"openapi":"/api-reference/link-product-openapi.json get /products/{id}","href":"/api-reference/products/get-product"},{"title":"Update product","deprecated":null,"version":null,"openapi":"/api-reference/link-product-openapi.json put /products/{id}","href":"/api-reference/products/update-product"},{"title":"Delete product","description":"Soft delete a product by setting deletedAt timestamp. The product will no longer appear in list or get endpoints.","deprecated":null,"version":null,"openapi":"/api-reference/link-product-openapi.json delete /products/{id}","href":"/api-reference/products/delete-product"},{"title":"List products","deprecated":null,"version":null,"openapi":"/api-reference/link-product-openapi.json post /products/list","href":"/api-reference/products/list-products"},{"title":"Bulk import products","description":"Import multiple products at once. Products with existing IDs will be updated (upsert). Maximum 1000 products per import.","deprecated":null,"version":null,"openapi":"/api-reference/link-product-openapi.json post /products/bulk-import","href":"/api-reference/products/bulk-import-products"}]},{"group":"Invoices","pages":[{"title":"List invoices","deprecated":null,"version":null,"openapi":"/api-reference/link-product-openapi.json get /invoices","href":"/api-reference/invoices/list-invoices"},{"title":"Get invoice","deprecated":null,"version":null,"openapi":"/api-reference/link-product-openapi.json get /invoices/{id}","href":"/api-reference/invoices/get-invoice"},{"title":"Refund invoice","deprecated":null,"version":null,"openapi":"/api-reference/link-product-openapi.json post /invoices/{id}/refund","href":"/api-reference/invoices/refund-invoice"}]}]}]},"basePath":"","title":"List products - Cheqpay","buildId":"dpl_FWZhTb2vab28gFGFH4ojka6qEznQ","deploymentId":"dpl_FWZhTb2vab28gFGFH4ojka6qEznQ","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-CBsVopKK.js","utils-DZAk68jJ.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-D32AYZrP.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-D_A5_cny.js","snippetPresets-xNRfS9th.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","conditional-requirements-CFM0id0Q.js","ApiExamples-BIB25-tq.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-CydJ4w4j.js","shallow-CYPBeQSG.js","getApiPlaygroundDisplay-A5xJVBOu.js","CodeSnippet-BVRTgi3m.js","CodeSnippets-DjD6BSlt.js","Page-Dr40SSJq.js","getPastedJson-D4V4JyrR.js","icon-uhcnG22T.js","MethodPill-CM-ZQdGH.js","DuplicateIcon-B_WnOiNf.js","createIcon-CJsb8utt.js","DynamicMarkdown-D-2HDKEp.js","SectionHeading-KP5xmMgQ.js","axios-vUo_bRtp.js","Markdown-D_k0dg6k.js","clsx-DK3K4Z1S.js","lib-DuNMoZ05.js","lib-B8HbPgcC.js","html-void-elements-mCSPHezU.js","dist-DE3EVdvd.js","katex-YMM-FMeD.js","marked.esm-CZWythHk.js","AssistantPageLink-fN9H9n9g.js"]}