Perform fresh marketplace verification using the canonical services for every supported marketplace. For products provide productIds plus expected, or targets[] for mixed values. For order, return and price-book operations provide their returned order_action/return_action/price_book_sync correlations; product and fulfillment checks may share one request. Maximum 50000 entries per target array, with bounded concurrency. Catalog verification requires catalog:read; fulfillment verification requires orders:read; mixed batches require both. Session callers include organizationId. Missing, unauthorized, unsupported and unconfirmed targets fail explicitly. A return decision can be confirmed while later lifecycle steps remain pending. Labels confirm generated artifacts, not physical printing. Provider acceptance alone does not establish a changed state; tracking omitted by the provider remains unconfirmed. This read never resubmits a marketplace action.
Per-product expected states for a mixed-value batch. Use every successful item's productId and commerceReceipt.expected together. Do not combine with productIds or shared expected. Identical duplicates are deduplicated; conflicting expectations are rejected.
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"OmniCommerce","description":"Developer documentation for OmniCommerce REST APIs, MCP tools, and agent integrations.","colors":{"primary":"#0F766E","light":"#2DD4BF","dark":"#115E59"},"logo":{"light":"https://mintcdn.com/omnicommerce/B2cjFTJ7Zt2npdeV/logo/light.svg?fit=max\u0026auto=format\u0026n=B2cjFTJ7Zt2npdeV\u0026q=85\u0026s=e012509da06089923275e6b0415addf9","dark":"https://mintcdn.com/omnicommerce/B2cjFTJ7Zt2npdeV/logo/dark.svg?fit=max\u0026auto=format\u0026n=B2cjFTJ7Zt2npdeV\u0026q=85\u0026s=547bdf6cb0b483a43238304bc7679fa1","href":"https://omnicommerce.sg"},"favicon":"https://mintcdn.com/omnicommerce/B2cjFTJ7Zt2npdeV/favicon.svg?fit=max\u0026auto=format\u0026n=B2cjFTJ7Zt2npdeV\u0026q=85\u0026s=2951c661b72ccdfa6777f7594193113c","api":{"params":{"expanded":"closed"},"playground":{"display":"interactive"},"examples":{"defaults":"required","languages":["curl","javascript","python"],"prefill":false}},"appearance":{"default":"dark"},"navbar":{"links":[{"href":"https://omnicommerce.sg","label":"App"},{"href":"https://omnicommerce.sg/login","label":"Log In"}],"primary":{"type":"button","label":"API Dashboard","href":"https://omnicommerce.sg/app"}},"footer":{"socials":{"website":"https://omnicommerce.sg"}},"seo":{"metatags":{"og:site_name":"OmniCommerce Docs","twitter:card":"summary_large_image"}},"contextual":{"options":["copy","view","chatgpt","claude","download-spec"],"display":"header"},"styling":{"latex":false},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"omnicommerce","hasAudioNarration":false,"actualSubdomain":"omnicommerce","customDomains":["docs.omnicommerce.ai"],"gitSource":{"type":"github","owner":"rmdort","repo":"omnicommerce","deployBranch":"main","contentDirectory":"docs","isPrivate":true,"mountPath":"","label":""},"chroma":{"latestBuiltDeploymentHistoryId":"6ae1e2c2ba4b20fd94ed6e0a","collectionId":"7be876d4-f3aa-4a95-9171-4f6ca3f65a52","liveDeploymentHistoryId":"6ae1e2c2ba4b20fd94ed6e0a","schemaVersion":"v3"},"entitlements":{"AI_CHAT":{"status":"DISABLED"}},"buildId":"6ae1f4c783326b7b15e9a556","clientVersion":"0.0.3990","searchFilterCounts":[{"language":"default","tag":"API Reference","count":163},{"language":"default","tag":"Endpoints","count":141},{"language":"default","tag":"Documentation","count":44},{"language":"default","tag":"Webhooks","count":31},{"language":"default","tag":"Guides","count":23},{"language":"default","tag":"Products","count":21},{"language":"default","tag":"Orders","count":15},{"language":"default","tag":"Developer Platform","count":14},{"language":"default","tag":"Analytics","count":11},{"language":"default","tag":"Returns","count":9}]},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":false,"enableContextualStarterQuestions":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":"editor-v7-file-tree","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":"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":"pause-universal-search-reconcile","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":"per-site-search-delta","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":"editor-private-page-search","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":"editor-nav-generations","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":"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":"byok-sep-25","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":"vite-origin","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-agent-model-picker","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-updated-9-15","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":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"isAtlas":false,"googleFontsInlined":false},"customCss":[{"filePath":"style.css","content":":root{--docs-radius:6px;--docs-content-max:60rem;--docs-example-width:28rem}#navbar img[src*=logo],header img[src$=\"/logo/dark.svg\"],header img[src$=\"/logo/light.svg\"],header nav-logo img{height:32px!important;max-height:32px!important;width:auto!important}article p:not(.callout-title):not(.callout-body),main p:not(.callout-title):not(.callout-body){font-size:calc(1em - 1pt)}"}],"page":{"pagePath":"api-reference/commerce/verify-commerce-state","slug":"/api-reference/commerce/verify-commerce-state","pageMetadata":{"title":"Verify Commerce State","description":"Perform fresh marketplace verification using the canonical services for every supported marketplace. For products provide productIds plus expected, or targets[{productId,expected}] for mixed values. For order, return and price-book operations provide their returned order_action/return_action/price_book_sync correlations; product and fulfillment checks may share one request. Maximum 50000 entries per target array, with bounded concurrency. Catalog verification requires catalog:read; fulfillment verification requires orders:read; mixed batches require both. Session callers include organizationId. Missing, unauthorized, unsupported and unconfirmed targets fail explicitly. A return decision can be confirmed while later lifecycle steps remain pending. Labels confirm generated artifacts, not physical printing. Provider acceptance alone does not establish a changed state; tracking omitted by the provider remains unconfirmed. This read never resubmits a marketplace action.","deprecated":null,"version":null,"openapi":"/openapi.json post /api/v1/commerce/state/verify","href":"/api-reference/commerce/verify-commerce-state","autogeneratedByOpenApi":true},"description":{"compiledSource":"\"use strict\";\nconst {jsx: _jsx, jsxs: _jsxs} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsxs(_components.p, {\n children: [\"Perform fresh marketplace verification using the canonical services for every supported marketplace. For products provide productIds plus expected, or targets[\", \"] for mixed values. For order, return and price-book operations provide their returned order_action/return_action/price_book_sync correlations; product and fulfillment checks may share one request. Maximum 50000 entries per target array, with bounded concurrency. Catalog verification requires catalog:read; fulfillment verification requires orders:read; mixed batches require both. Session callers include organizationId. Missing, unauthorized, unsupported and unconfirmed targets fail explicitly. A return decision can be confirmed while later lifecycle steps remain pending. Labels confirm generated artifacts, not physical printing. Provider acceptance alone does not establish a changed state; tracking omitted by the provider remains unconfirmed. This read never resubmits a marketplace action.\"]\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":"Verify Commerce State","description":"Perform fresh marketplace verification using the canonical services for every supported marketplace. For products provide productIds plus expected, or targets[{productId,expected}] for mixed values. For order, return and price-book operations provide their returned order_action/return_action/price_book_sync correlations; product and fulfillment checks may share one request. Maximum 50000 entries per target array, with bounded concurrency. Catalog verification requires catalog:read; fulfillment verification requires orders:read; mixed batches require both. Session callers include organizationId. Missing, unauthorized, unsupported and unconfirmed targets fail explicitly. A return decision can be confirmed while later lifecycle steps remain pending. Labels confirm generated artifacts, not physical printing. Provider acceptance alone does not establish a changed state; tracking omitted by the provider remains unconfirmed. This read never resubmits a marketplace action.","deprecated":null,"version":null,"openapi":"/openapi.json post /api/v1/commerce/state/verify","href":"/api-reference/commerce/verify-commerce-state","autogeneratedByOpenApi":true}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":[],"openApiReferenceData":{"operation":{"operationId":"post_v1_commerce_state_verify","summary":"Verify Commerce State","description":"Perform fresh marketplace verification using the canonical services for every supported marketplace. For products provide productIds plus expected, or targets[{productId,expected}] for mixed values. For order, return and price-book operations provide their returned order_action/return_action/price_book_sync correlations; product and fulfillment checks may share one request. Maximum 50000 entries per target array, with bounded concurrency. Catalog verification requires catalog:read; fulfillment verification requires orders:read; mixed batches require both. Session callers include organizationId. Missing, unauthorized, unsupported and unconfirmed targets fail explicitly. A return decision can be confirmed while later lifecycle steps remain pending. Labels confirm generated artifacts, not physical printing. Provider acceptance alone does not establish a changed state; tracking omitted by the provider remains unconfirmed. This read never resubmits a marketplace action.","tags":["commerce"],"security":["9f700cd9-9f84-4ee7-a74e-a79c3e3cc05e"],"requestBody":"0a34dca9-b680-4e24-affd-90e9497590bf","responses":{"200":"e3599608-e924-4cb0-b2d7-abf251bf20cf","400":"3b5d3bfa-bdaf-4b79-a93e-6c82b4c139a0","401":"7349262c-8d8e-409a-8b06-3812b22a8d75","403":"7e7b2393-9678-452f-9512-fbd5eca29342","429":"b974b8aa-868c-4f40-a3c7-9dc47628ff4e","503":"4220c878-aa1f-445d-b530-e4d8b370f728"},"method":"post","type":"path","servers":["ceff5d18-c0eb-4506-beb9-ccc9d08a4606","13d55109-1e31-4edd-9bef-27945ae6855b"],"path":"/api/v1/commerce/state/verify","baseUrlOptions":["https://omnicommerce.sg","http://localhost:3000"],"title":"Verify Commerce State","codeSamples":[],"requestExampleLanguages":["bash","javascript","python"],"requiredOnlyExamples":true,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"correlations":{"description":"Order, return or price-book sync correlations. May accompany product targets.","minItems":1,"maxItems":50000,"type":"array","items":{"type":"object","properties":{"kind":{"type":"string","enum":["order_action","return_action","price_book_sync"],"isRequired":true,"uniqueKey":"correlations.items.[INDEX].kind","typeLabel":"enum\u003cstring>"},"id":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$","isRequired":true,"uniqueKey":"correlations.items.[INDEX].id","typeLabel":"string\u003cuuid>"},"platform":{"type":"string","minLength":1,"uniqueKey":"correlations.items.[INDEX].platform","typeLabel":"string"},"storeId":{"type":"string","minLength":1,"uniqueKey":"correlations.items.[INDEX].storeId","typeLabel":"string"},"productId":{"type":"string","minLength":1,"uniqueKey":"correlations.items.[INDEX].productId","typeLabel":"string"},"productIds":{"maxItems":500,"type":"array","items":{"type":"string","minLength":1,"uniqueKey":"correlations.items.[INDEX].productIds.items.[INDEX]","typeLabel":"string"},"uniqueKey":"correlations.items.[INDEX].productIds","typeLabel":"string[]"},"externalIds":{"maxItems":500,"type":"array","items":{"type":"string","minLength":1,"uniqueKey":"correlations.items.[INDEX].externalIds.items.[INDEX]","typeLabel":"string"},"uniqueKey":"correlations.items.[INDEX].externalIds","typeLabel":"string[]"}},"required":["kind","id"],"uniqueKey":"correlations.items.[INDEX]","typeLabel":"object"},"uniqueKey":"correlations","typeLabel":"object[]"},"productIds":{"description":"Product or variant ids to verify together. Use every distinct productId returned by the completed commerce jobs (max 50000, bounded concurrency).","minItems":1,"maxItems":50000,"type":"array","items":{"type":"string","minLength":1,"uniqueKey":"productIds.items.[INDEX]","typeLabel":"string"},"uniqueKey":"productIds","typeLabel":"string[]"},"expected":{"description":"Expected commerce state after a write (price, quantity, listingStatus, etc).","type":"object","properties":{"price":{"type":"number","uniqueKey":"expected.price","typeLabel":"number"},"salePrice":{"oneOf":[{"type":"number","uniqueKey":"expected.salePrice.oneOf.0","typeLabel":"number"},{"type":"null","uniqueKey":"expected.salePrice.oneOf.1","typeLabel":"null"}],"uniqueKey":"expected.salePrice","typeLabel":"number | null"},"currency":{"type":"string","pattern":"^[A-Za-z]{3}$","uniqueKey":"expected.currency","typeLabel":"string"},"quantity":{"type":"integer","minimum":0,"maximum":9007199254740991,"uniqueKey":"expected.quantity","typeLabel":"integer"},"listingStatus":{"type":"string","enum":["active","draft","unlisted","deleted"],"uniqueKey":"expected.listingStatus","typeLabel":"enum\u003cstring>"},"platforms":{"type":"array","items":{"type":"string","minLength":1,"uniqueKey":"expected.platforms.items.[INDEX]","typeLabel":"string"},"uniqueKey":"expected.platforms","typeLabel":"string[]"}},"uniqueKey":"expected","typeLabel":"object"},"targets":{"description":"Per-product expected states for a mixed-value batch. Use every successful item's productId and commerceReceipt.expected together. Do not combine with productIds or shared expected. Identical duplicates are deduplicated; conflicting expectations are rejected.","minItems":1,"maxItems":50000,"type":"array","items":{"type":"object","properties":{"productId":{"type":"string","minLength":1,"maxLength":255,"isRequired":true,"uniqueKey":"targets.items.[INDEX].productId","typeLabel":"string"},"expected":{"type":"object","properties":{"price":{"type":"number","uniqueKey":"targets.items.[INDEX].expected.price","typeLabel":"number"},"salePrice":{"oneOf":[{"type":"number","uniqueKey":"targets.items.[INDEX].expected.salePrice.oneOf.0","typeLabel":"number"},{"type":"null","uniqueKey":"targets.items.[INDEX].expected.salePrice.oneOf.1","typeLabel":"null"}],"uniqueKey":"targets.items.[INDEX].expected.salePrice","typeLabel":"number | null"},"currency":{"type":"string","pattern":"^[A-Za-z]{3}$","uniqueKey":"targets.items.[INDEX].expected.currency","typeLabel":"string"},"quantity":{"type":"integer","minimum":0,"maximum":9007199254740991,"uniqueKey":"targets.items.[INDEX].expected.quantity","typeLabel":"integer"},"listingStatus":{"type":"string","enum":["active","draft","unlisted","deleted"],"uniqueKey":"targets.items.[INDEX].expected.listingStatus","typeLabel":"enum\u003cstring>"},"platforms":{"type":"array","items":{"type":"string","minLength":1,"uniqueKey":"targets.items.[INDEX].expected.platforms.items.[INDEX]","typeLabel":"string"},"uniqueKey":"targets.items.[INDEX].expected.platforms","typeLabel":"string[]"}},"isRequired":true,"uniqueKey":"targets.items.[INDEX].expected","typeLabel":"object"}},"required":["productId","expected"],"additionalProperties":false,"uniqueKey":"targets.items.[INDEX]","typeLabel":"object"},"uniqueKey":"targets","typeLabel":"object[]"},"action":{"description":"Lifecycle action being verified. Use delete for Omni-only delete checks.","type":"string","enum":["price","inventory","publish","update","delist","delete"],"uniqueKey":"action","typeLabel":"enum\u003cstring>"},"platforms":{"description":"Optional marketplace filter: shopee, lazada, tiktok, shopify, whatsapp, zalora, amazon, ebay.","type":"array","items":{"type":"string","minLength":1,"uniqueKey":"platforms.items.[INDEX]","typeLabel":"string"},"uniqueKey":"platforms","typeLabel":"string[]"},"includeOmni":{"description":"Also assert Omni DB fields (default true).","type":"boolean","uniqueKey":"includeOmni","typeLabel":"boolean"},"organizationId":{"type":"string","minLength":1,"maxLength":120,"uniqueKey":"organizationId","typeLabel":"string"}},"additionalProperties":false,"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"correlations":[{"id":"3c90c3cc-0d44-4b50-8888-8dd25736052a","platform":"\u003cstring>","storeId":"\u003cstring>","productId":"\u003cstring>","productIds":["\u003cstring>"],"externalIds":["\u003cstring>"]}],"productIds":["\u003cstring>"],"expected":{"price":123,"salePrice":123,"currency":"\u003cstring>","quantity":4503599627370495,"platforms":["\u003cstring>"]},"targets":[{"productId":"\u003cstring>","expected":{"price":123,"salePrice":123,"currency":"\u003cstring>","quantity":4503599627370495,"platforms":["\u003cstring>"]}}],"platforms":["\u003cstring>"],"includeOmni":true,"organizationId":"\u003cstring>"}}},"exampleType":"generated"}},"exampleType":"generated"},"responses":{"e3599608-e924-4cb0-b2d7-abf251bf20cf":{"description":"Request completed. Inspect data.success, per-target results and pendingCount for processing progress.","content":{"application/json":{"schema":{"type":"object","required":["ok","apiVersion","operationId","status","data","links","warnings","recommendations"],"properties":{"ok":{"type":"boolean","isRequired":true,"uniqueKey":"ok","typeLabel":"boolean"},"apiVersion":{"type":"string","isRequired":true,"uniqueKey":"apiVersion","typeLabel":"string"},"operationId":{"type":"string","format":"uuid","isRequired":true,"uniqueKey":"operationId","typeLabel":"string\u003cuuid>"},"status":{"type":"string","enum":["completed"],"isRequired":true,"uniqueKey":"status","typeLabel":"enum\u003cstring>"},"data":{"type":"object","properties":{"success":{"type":"boolean","isRequired":true,"uniqueKey":"data.success","typeLabel":"boolean"},"succeededCount":{"type":"integer","minimum":0,"maximum":9007199254740991,"isRequired":true,"uniqueKey":"data.succeededCount","typeLabel":"integer"},"failedCount":{"type":"integer","minimum":0,"maximum":9007199254740991,"isRequired":true,"uniqueKey":"data.failedCount","typeLabel":"integer"},"correlations":{"type":"array","items":{"type":"object","properties":{"kind":{"type":"string","enum":["inventory_job","price_event","price_book_sync","publish_job","delist_batch","store_switch","omni_delete","zalora_import","enrichment_batch","order_action","return_action"],"isRequired":true,"uniqueKey":"data.correlations.items.[INDEX].kind","typeLabel":"enum\u003cstring>"},"id":{"type":"string","minLength":1,"maxLength":200,"isRequired":true,"uniqueKey":"data.correlations.items.[INDEX].id","typeLabel":"string"},"platform":{"type":"string","minLength":1,"uniqueKey":"data.correlations.items.[INDEX].platform","typeLabel":"string"},"storeId":{"type":"string","minLength":1,"uniqueKey":"data.correlations.items.[INDEX].storeId","typeLabel":"string"},"productId":{"type":"string","minLength":1,"uniqueKey":"data.correlations.items.[INDEX].productId","typeLabel":"string"},"productIds":{"maxItems":500,"type":"array","items":{"type":"string","minLength":1,"uniqueKey":"data.correlations.items.[INDEX].productIds.items.[INDEX]","typeLabel":"string"},"uniqueKey":"data.correlations.items.[INDEX].productIds","typeLabel":"string[]"},"externalIds":{"maxItems":500,"type":"array","items":{"type":"string","minLength":1,"uniqueKey":"data.correlations.items.[INDEX].externalIds.items.[INDEX]","typeLabel":"string"},"uniqueKey":"data.correlations.items.[INDEX].externalIds","typeLabel":"string[]"}},"required":["kind","id"],"uniqueKey":"data.correlations.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"data.correlations","typeLabel":"object[]"},"message":{"type":"string","isRequired":true,"uniqueKey":"data.message","typeLabel":"string"},"results":{"type":"array","items":{"type":"object","properties":{"success":{"type":"boolean","isRequired":true,"uniqueKey":"data.results.items.[INDEX].success","typeLabel":"boolean"},"productId":{"type":"string","isRequired":true,"uniqueKey":"data.results.items.[INDEX].productId","typeLabel":"string"},"verification":{"type":"array","items":{"type":"object","properties":{"ok":{"type":"boolean","isRequired":true,"uniqueKey":"data.results.items.[INDEX].verification.items.[INDEX].ok","typeLabel":"boolean"},"target":{"type":"string","isRequired":true,"uniqueKey":"data.results.items.[INDEX].verification.items.[INDEX].target","typeLabel":"string"},"evidence":{"type":"string","isRequired":true,"uniqueKey":"data.results.items.[INDEX].verification.items.[INDEX].evidence","typeLabel":"string"},"action":{"type":"string","uniqueKey":"data.results.items.[INDEX].verification.items.[INDEX].action","typeLabel":"string"},"platform":{"type":"string","uniqueKey":"data.results.items.[INDEX].verification.items.[INDEX].platform","typeLabel":"string"},"storeId":{"type":"string","uniqueKey":"data.results.items.[INDEX].verification.items.[INDEX].storeId","typeLabel":"string"},"productId":{"type":"string","uniqueKey":"data.results.items.[INDEX].verification.items.[INDEX].productId","typeLabel":"string"},"expected":{"type":"string","uniqueKey":"data.results.items.[INDEX].verification.items.[INDEX].expected","typeLabel":"string"},"actual":{"type":"string","uniqueKey":"data.results.items.[INDEX].verification.items.[INDEX].actual","typeLabel":"string"}},"required":["ok","target","evidence"],"uniqueKey":"data.results.items.[INDEX].verification.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"data.results.items.[INDEX].verification","typeLabel":"object[]"},"listings":{"type":"array","items":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"oneOf":[{}],"uniqueKey":"data.results.items.[INDEX].listings.items.[INDEX].additionalProperties","typeLabel":"any"},"uniqueKey":"data.results.items.[INDEX].listings.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"data.results.items.[INDEX].listings","typeLabel":"object[]"},"message":{"type":"string","isRequired":true,"uniqueKey":"data.results.items.[INDEX].message","typeLabel":"string"},"rootProductId":{"type":"string","uniqueKey":"data.results.items.[INDEX].rootProductId","typeLabel":"string"},"omni":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"oneOf":[{}],"uniqueKey":"data.results.items.[INDEX].omni.additionalProperties","typeLabel":"any"},"uniqueKey":"data.results.items.[INDEX].omni","typeLabel":"object"}},"required":["success","productId","verification","listings","message"],"uniqueKey":"data.results.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"data.results","typeLabel":"object[]"},"jobs":{"type":"array","items":{"type":"object","properties":{"kind":{"type":"string","enum":["order_action","return_action","price_book_sync"],"isRequired":true,"uniqueKey":"data.jobs.items.[INDEX].kind","typeLabel":"enum\u003cstring>"},"id":{"type":"string","isRequired":true,"uniqueKey":"data.jobs.items.[INDEX].id","typeLabel":"string"},"success":{"type":"boolean","isRequired":true,"uniqueKey":"data.jobs.items.[INDEX].success","typeLabel":"boolean"},"evidence":{"type":"string","isRequired":true,"uniqueKey":"data.jobs.items.[INDEX].evidence","typeLabel":"string"},"orderId":{"type":"string","uniqueKey":"data.jobs.items.[INDEX].orderId","typeLabel":"string"},"returnId":{"type":"string","uniqueKey":"data.jobs.items.[INDEX].returnId","typeLabel":"string"},"productIds":{"type":"array","items":{"type":"string","uniqueKey":"data.jobs.items.[INDEX].productIds.items.[INDEX]","typeLabel":"string"},"uniqueKey":"data.jobs.items.[INDEX].productIds","typeLabel":"string[]"},"results":{"type":"array","items":{"type":"object","properties":{"productId":{"type":"string","isRequired":true,"uniqueKey":"data.jobs.items.[INDEX].results.items.[INDEX].productId","typeLabel":"string"},"targetId":{"type":"string","isRequired":true,"uniqueKey":"data.jobs.items.[INDEX].results.items.[INDEX].targetId","typeLabel":"string"},"success":{"type":"boolean","isRequired":true,"uniqueKey":"data.jobs.items.[INDEX].results.items.[INDEX].success","typeLabel":"boolean"},"evidence":{"type":"string","isRequired":true,"uniqueKey":"data.jobs.items.[INDEX].results.items.[INDEX].evidence","typeLabel":"string"},"platform":{"type":"string","uniqueKey":"data.jobs.items.[INDEX].results.items.[INDEX].platform","typeLabel":"string"},"storeId":{"type":"string","uniqueKey":"data.jobs.items.[INDEX].results.items.[INDEX].storeId","typeLabel":"string"},"checks":{"type":"array","items":{"type":"object","properties":{"country":{"oneOf":[{"type":"string","isRequired":true,"uniqueKey":"data.jobs.items.[INDEX].results.items.[INDEX].checks.items.[INDEX].country.oneOf.0","typeLabel":"string"},{"type":"null","isRequired":true,"uniqueKey":"data.jobs.items.[INDEX].results.items.[INDEX].checks.items.[INDEX].country.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"data.jobs.items.[INDEX].results.items.[INDEX].checks.items.[INDEX].country","typeLabel":"string | null"},"currency":{"oneOf":[{"type":"string","isRequired":true,"uniqueKey":"data.jobs.items.[INDEX].results.items.[INDEX].checks.items.[INDEX].currency.oneOf.0","typeLabel":"string"},{"type":"null","isRequired":true,"uniqueKey":"data.jobs.items.[INDEX].results.items.[INDEX].checks.items.[INDEX].currency.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"data.jobs.items.[INDEX].results.items.[INDEX].checks.items.[INDEX].currency","typeLabel":"string | null"},"expectedPrice":{"oneOf":[{"type":"number","isRequired":true,"uniqueKey":"data.jobs.items.[INDEX].results.items.[INDEX].checks.items.[INDEX].expectedPrice.oneOf.0","typeLabel":"number"},{"type":"null","isRequired":true,"uniqueKey":"data.jobs.items.[INDEX].results.items.[INDEX].checks.items.[INDEX].expectedPrice.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"data.jobs.items.[INDEX].results.items.[INDEX].checks.items.[INDEX].expectedPrice","typeLabel":"number | null"},"actualPrice":{"oneOf":[{"type":"number","isRequired":true,"uniqueKey":"data.jobs.items.[INDEX].results.items.[INDEX].checks.items.[INDEX].actualPrice.oneOf.0","typeLabel":"number"},{"type":"null","isRequired":true,"uniqueKey":"data.jobs.items.[INDEX].results.items.[INDEX].checks.items.[INDEX].actualPrice.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"data.jobs.items.[INDEX].results.items.[INDEX].checks.items.[INDEX].actualPrice","typeLabel":"number | null"},"success":{"type":"boolean","isRequired":true,"uniqueKey":"data.jobs.items.[INDEX].results.items.[INDEX].checks.items.[INDEX].success","typeLabel":"boolean"}},"required":["country","currency","expectedPrice","actualPrice","success"],"uniqueKey":"data.jobs.items.[INDEX].results.items.[INDEX].checks.items.[INDEX]","typeLabel":"object"},"uniqueKey":"data.jobs.items.[INDEX].results.items.[INDEX].checks","typeLabel":"object[]"}},"required":["productId","targetId","success","evidence"],"uniqueKey":"data.jobs.items.[INDEX].results.items.[INDEX]","typeLabel":"object"},"uniqueKey":"data.jobs.items.[INDEX].results","typeLabel":"object[]"},"action":{"type":"string","uniqueKey":"data.jobs.items.[INDEX].action","typeLabel":"string"},"platform":{"type":"string","uniqueKey":"data.jobs.items.[INDEX].platform","typeLabel":"string"},"status":{"type":"string","uniqueKey":"data.jobs.items.[INDEX].status","typeLabel":"string"},"statusBefore":{"oneOf":[{"type":"string","uniqueKey":"data.jobs.items.[INDEX].statusBefore.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"data.jobs.items.[INDEX].statusBefore.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.jobs.items.[INDEX].statusBefore","typeLabel":"string | null"},"statusAfter":{"oneOf":[{"type":"string","uniqueKey":"data.jobs.items.[INDEX].statusAfter.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"data.jobs.items.[INDEX].statusAfter.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.jobs.items.[INDEX].statusAfter","typeLabel":"string | null"},"labels":{"type":"array","items":{"type":"object","properties":{"url":{"type":"string","format":"uri","isRequired":true,"uniqueKey":"data.jobs.items.[INDEX].labels.items.[INDEX].url","typeLabel":"string\u003curi>"},"name":{"oneOf":[{"type":"string","isRequired":true,"uniqueKey":"data.jobs.items.[INDEX].labels.items.[INDEX].name.oneOf.0","typeLabel":"string"},{"type":"null","isRequired":true,"uniqueKey":"data.jobs.items.[INDEX].labels.items.[INDEX].name.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"data.jobs.items.[INDEX].labels.items.[INDEX].name","typeLabel":"string | null"},"mimeType":{"oneOf":[{"type":"string","isRequired":true,"uniqueKey":"data.jobs.items.[INDEX].labels.items.[INDEX].mimeType.oneOf.0","typeLabel":"string"},{"type":"null","isRequired":true,"uniqueKey":"data.jobs.items.[INDEX].labels.items.[INDEX].mimeType.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"data.jobs.items.[INDEX].labels.items.[INDEX].mimeType","typeLabel":"string | null"}},"required":["url","name","mimeType"],"uniqueKey":"data.jobs.items.[INDEX].labels.items.[INDEX]","typeLabel":"object"},"uniqueKey":"data.jobs.items.[INDEX].labels","typeLabel":"object[]"}},"required":["kind","id","success","evidence"],"uniqueKey":"data.jobs.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"data.jobs","typeLabel":"object[]"},"productIds":{"type":"array","items":{"type":"string","uniqueKey":"data.productIds.items.[INDEX]","typeLabel":"string"},"uniqueKey":"data.productIds","typeLabel":"string[]"},"orderIds":{"type":"array","items":{"type":"string","uniqueKey":"data.orderIds.items.[INDEX]","typeLabel":"string"},"uniqueKey":"data.orderIds","typeLabel":"string[]"},"returnIds":{"type":"array","items":{"type":"string","uniqueKey":"data.returnIds.items.[INDEX]","typeLabel":"string"},"uniqueKey":"data.returnIds","typeLabel":"string[]"}},"required":["success","succeededCount","failedCount","correlations","message","results","jobs"],"isRequired":true,"uniqueKey":"data","typeLabel":"object"},"links":{"type":"object","additionalProperties":{"type":"string","uniqueKey":"links.additionalProperties","typeLabel":"string"},"isRequired":true,"uniqueKey":"links","typeLabel":"object"},"warnings":{"type":"array","items":{"type":"string","uniqueKey":"warnings.items.[INDEX]","typeLabel":"string"},"isRequired":true,"uniqueKey":"warnings","typeLabel":"string[]"},"recommendations":{"type":"array","items":{"type":"string","uniqueKey":"recommendations.items.[INDEX]","typeLabel":"string"},"isRequired":true,"uniqueKey":"recommendations","typeLabel":"string[]"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"ok":true,"apiVersion":"\u003cstring>","operationId":"3c90c3cc-0d44-4b50-8888-8dd25736052a","status":"completed","data":{"success":true,"succeededCount":4503599627370495,"failedCount":4503599627370495,"correlations":[{"kind":"inventory_job","id":"\u003cstring>","platform":"\u003cstring>","storeId":"\u003cstring>","productId":"\u003cstring>","productIds":["\u003cstring>"],"externalIds":["\u003cstring>"]}],"message":"\u003cstring>","results":[{"success":true,"productId":"\u003cstring>","verification":[{"ok":true,"target":"\u003cstring>","evidence":"\u003cstring>","action":"\u003cstring>","platform":"\u003cstring>","storeId":"\u003cstring>","productId":"\u003cstring>","expected":"\u003cstring>","actual":"\u003cstring>"}],"listings":[{}],"message":"\u003cstring>","rootProductId":"\u003cstring>","omni":{}}],"jobs":[{"kind":"order_action","id":"\u003cstring>","success":true,"evidence":"\u003cstring>","orderId":"\u003cstring>","returnId":"\u003cstring>","productIds":["\u003cstring>"],"results":[{"productId":"\u003cstring>","targetId":"\u003cstring>","success":true,"evidence":"\u003cstring>","platform":"\u003cstring>","storeId":"\u003cstring>","checks":[{"country":"\u003cstring>","currency":"\u003cstring>","expectedPrice":123,"actualPrice":123,"success":true}]}],"action":"\u003cstring>","platform":"\u003cstring>","status":"\u003cstring>","statusBefore":"\u003cstring>","statusAfter":"\u003cstring>","labels":[{"url":"\u003cstring>","name":"\u003cstring>","mimeType":"\u003cstring>"}]}],"productIds":["\u003cstring>"],"orderIds":["\u003cstring>"],"returnIds":["\u003cstring>"]},"links":{},"warnings":["\u003cstring>"],"recommendations":["\u003cstring>"]}}},"exampleType":"generated"}},"exampleType":"generated"},"3b5d3bfa-bdaf-4b79-a93e-6c82b4c139a0":{"description":"Invalid request, conflicting operations, singular arguments or a batch exceeding the endpoint limit.","content":{"_mintlify/placeholder":{"schema":{"type":"object","description":""}}}},"7349262c-8d8e-409a-8b06-3812b22a8d75":{"description":"Missing or invalid credentials.","content":{"_mintlify/placeholder":{"schema":{"type":"object","description":""}}}},"7e7b2393-9678-452f-9512-fbd5eca29342":{"description":"Missing scope, organization mismatch, or a target outside the caller's assigned stores and markets.","content":{"_mintlify/placeholder":{"schema":{"type":"object","description":""}}}},"b974b8aa-868c-4f40-a3c7-9dc47628ff4e":{"description":"Rate limit exceeded.","content":{"_mintlify/placeholder":{"schema":{"type":"object","description":""}}}},"4220c878-aa1f-445d-b530-e4d8b370f728":{"description":"Service unavailable. Retry a submission with the same requestId and unchanged operations.","content":{"_mintlify/placeholder":{"schema":{"type":"object","description":""}}}}},"security":{"9f700cd9-9f84-4ee7-a74e-a79c3e3cc05e":{"bearerAuth":{"type":"http","scheme":"bearer","bearerFormat":"API Key","description":"Bearer API key for server-to-server access. Session auth is also supported in first-party UI flows.","scopes":[],"schemeName":"bearerAuth"}}},"servers":{"ceff5d18-c0eb-4506-beb9-ccc9d08a4606":{"url":"https://omnicommerce.sg","description":"Production"},"13d55109-1e31-4edd-9bef-27945ae6855b":{"url":"http://localhost:3000","description":"Local development"}},"processedSecurityOptions":[{"schemes":[{"scheme":{"type":"http","scheme":"bearer","bearerFormat":"API Key","description":"Bearer API key for server-to-server access. Session auth is also supported in first-party UI flows.","scopes":[],"schemeName":"bearerAuth"},"schema":{"title":"Bearer Auth","type":"string","isRequired":true,"description":"Bearer API key for server-to-server access. Session auth is also supported in first-party UI flows.","format":"bearer","typeLabel":"string\u003cbearer>","deprecated":false},"schemeName":"bearerAuth","name":"Authorization"}],"title":"bearerAuth"}]},"originalFileLocation":"openapi.json"},"subdomain":"omnicommerce","siteName":"OmniCommerce","title":"Verify Commerce State - OmniCommerce","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-10-28T13:12:50.097Z","originalFileLocation":"api-reference/commerce/verify-commerce-state.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=\"dark\"}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=\"Perform fresh marketplace verification using the canonical services for every supported marketplace. For products provide productIds plus expected, or targets[{productId,expected}] for mixed values. For order, return and price-book operations provide their returned order_action/return_action/price_book_sync correlations; product and fulfillment checks may share one request. Maximum 50000 entries per target array, with bounded concurrency. Catalog verification requires catalog:read; fulfillment verification requires orders:read; mixed batches require both. Session callers include organizationId. Missing, unauthorized, unsupported and unconfirmed targets fail explicitly. A return decision can be confirmed while later lifecycle steps remain pending. Labels confirm generated artifacts, not physical printing. Provider acceptance alone does not establish a changed state; tracking omitted by the provider remains unconfirmed. This read never resubmits a marketplace action.\">\u003cmeta data-mint-head name=\"application-name\" content=\"OmniCommerce\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/omnicommerce/20sPCJ3GohzNbY_P/_generated/favicon/android-chrome-192x192.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"/mintlify-assets/_mintlify/favicons/omnicommerce/20sPCJ3GohzNbY_P/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/omnicommerce/20sPCJ3GohzNbY_P/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/omnicommerce/20sPCJ3GohzNbY_P/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/omnicommerce/20sPCJ3GohzNbY_P/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/omnicommerce/20sPCJ3GohzNbY_P/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/omnicommerce/20sPCJ3GohzNbY_P/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/omnicommerce/20sPCJ3GohzNbY_P/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/omnicommerce/20sPCJ3GohzNbY_P/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Verify Commerce State - OmniCommerce\">\u003cmeta data-mint-head property=\"og:description\" content=\"Perform fresh marketplace verification using the canonical services for every supported marketplace. For products provide productIds plus expected, or targets[{productId,expected}] for mixed values. For order, return and price-book operations provide their returned order_action/return_action/price_book_sync correlations; product and fulfillment checks may share one request. Maximum 50000 entries per target array, with bounded concurrency. Catalog verification requires catalog:read; fulfillment verification requires orders:read; mixed batches require both. Session callers include organizationId. Missing, unauthorized, unsupported and unconfirmed targets fail explicitly. A return decision can be confirmed while later lifecycle steps remain pending. Labels confirm generated artifacts, not physical printing. Provider acceptance alone does not establish a changed state; tracking omitted by the provider remains unconfirmed. This read never resubmits a marketplace action.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"OmniCommerce Docs\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.omnicommerce.ai/api-reference/commerce/verify-commerce-state\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://omnicommerce.mintlify.app/_mintlify/api/og/v2?division=Commerce\u0026amp;title=Verify+Commerce+State\u0026amp;description=Perform+fresh+marketplace+verification+using+the+canonical+services+for+every+supported+marketplace.+For+products+provide+productIds+plus+expected%2C+or+targets%5B%7B\u0026amp;theme=1a59a306fe3109e355163fa6\u0026amp;signature=063e802c06a67de4444e31eec7891c0f972410599e9942a4e7b585f5f7b6995c\">\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=\"Verify Commerce State - OmniCommerce\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Perform fresh marketplace verification using the canonical services for every supported marketplace. For products provide productIds plus expected, or targets[{productId,expected}] for mixed values. For order, return and price-book operations provide their returned order_action/return_action/price_book_sync correlations; product and fulfillment checks may share one request. Maximum 50000 entries per target array, with bounded concurrency. Catalog verification requires catalog:read; fulfillment verification requires orders:read; mixed batches require both. Session callers include organizationId. Missing, unauthorized, unsupported and unconfirmed targets fail explicitly. A return decision can be confirmed while later lifecycle steps remain pending. Labels confirm generated artifacts, not physical printing. Provider acceptance alone does not establish a changed state; tracking omitted by the provider remains unconfirmed. This read never resubmits a marketplace action.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://omnicommerce.mintlify.app/_mintlify/api/og/v2?division=Commerce\u0026amp;title=Verify+Commerce+State\u0026amp;description=Perform+fresh+marketplace+verification+using+the+canonical+services+for+every+supported+marketplace.+For+products+provide+productIds+plus+expected%2C+or+targets%5B%7B\u0026amp;theme=1a59a306fe3109e355163fa6\u0026amp;signature=063e802c06a67de4444e31eec7891c0f972410599e9942a4e7b585f5f7b6995c\">\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=\"/mintlify-assets/_mintlify/favicons/omnicommerce/20sPCJ3GohzNbY_P/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"OmniCommerce\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#0F766E\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.omnicommerce.ai/api-reference/commerce/verify-commerce-state\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/api-reference/commerce/verify-commerce-state.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.omnicommerce.ai/#organization\",\"name\":\"OmniCommerce\",\"url\":\"https://docs.omnicommerce.ai\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/omnicommerce/B2cjFTJ7Zt2npdeV/logo/light.svg?fit=max\u0026auto=format\u0026n=B2cjFTJ7Zt2npdeV\u0026q=85\u0026s=e012509da06089923275e6b0415addf9\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.omnicommerce.ai#website\",\"name\":\"OmniCommerce\",\"url\":\"https://docs.omnicommerce.ai\",\"publisher\":{\"@id\":\"https://docs.omnicommerce.ai/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.omnicommerce.ai/api-reference/commerce/verify-commerce-state#webpage\",\"url\":\"https://docs.omnicommerce.ai/api-reference/commerce/verify-commerce-state\",\"name\":\"Verify Commerce State\",\"description\":\"Perform fresh marketplace verification using the canonical services for every supported marketplace. For products provide productIds plus expected, or targets[{productId,expected}] for mixed values. For order, return and price-book operations provide their returned order_action/return_action/price_book_sync correlations; product and fulfillment checks may share one request. Maximum 50000 entries per target array, with bounded concurrency. Catalog verification requires catalog:read; fulfillment verification requires orders:read; mixed batches require both. Session callers include organizationId. Missing, unauthorized, unsupported and unconfirmed targets fail explicitly. A return decision can be confirmed while later lifecycle steps remain pending. Labels confirm generated artifacts, not physical printing. Provider acceptance alone does not establish a changed state; tracking omitted by the provider remains unconfirmed. This read never resubmits a marketplace action.\",\"dateModified\":\"2026-10-28T13:12:50.097Z\",\"isPartOf\":{\"@id\":\"https://docs.omnicommerce.ai#website\"},\"breadcrumb\":{\"@id\":\"https://docs.omnicommerce.ai/api-reference/commerce/verify-commerce-state#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.omnicommerce.ai/api-reference/commerce/verify-commerce-state#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Endpoints\",\"item\":\"https://docs.omnicommerce.ai/api-reference/agentic-checkout/discover-a-published-merchant-agent\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Commerce\",\"item\":\"https://docs.omnicommerce.ai/api-reference/commerce/await-commerce-jobs\"},{\"@type\":\"ListItem\",\"position\":3,\"name\":\"Verify Commerce State\",\"item\":\"https://docs.omnicommerce.ai/api-reference/commerce/verify-commerce-state\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.omnicommerce.ai/api-reference/commerce/verify-commerce-state#apireference\",\"headline\":\"Verify Commerce State\",\"name\":\"Verify Commerce State\",\"description\":\"Perform fresh marketplace verification using the canonical services for every supported marketplace. For products provide productIds plus expected, or targets[{productId,expected}] for mixed values. For order, return and price-book operations provide their returned order_action/return_action/price_book_sync correlations; product and fulfillment checks may share one request. Maximum 50000 entries per target array, with bounded concurrency. Catalog verification requires catalog:read; fulfillment verification requires orders:read; mixed batches require both. Session callers include organizationId. Missing, unauthorized, unsupported and unconfirmed targets fail explicitly. A return decision can be confirmed while later lifecycle steps remain pending. Labels confirm generated artifacts, not physical printing. Provider acceptance alone does not establish a changed state; tracking omitted by the provider remains unconfirmed. This read never resubmits a marketplace action.\",\"url\":\"https://docs.omnicommerce.ai/api-reference/commerce/verify-commerce-state\",\"mainEntityOfPage\":{\"@id\":\"https://docs.omnicommerce.ai/api-reference/commerce/verify-commerce-state#webpage\"},\"dateModified\":\"2026-10-28T13:12:50.097Z\",\"publisher\":{\"@id\":\"https://docs.omnicommerce.ai/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.omnicommerce.ai#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"OmniCommerce\",\"creator\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","siteName":"OmniCommerce","nav":{"global":null,"tabs":[{"tab":"Documentation","pages":[{"title":"Documentation","href":""}]},{"tab":"API Reference","groups":[{"group":"Overview","pages":[{"title":"API Reference","href":"/api-reference"}]},{"group":"Endpoints","pages":[{"group":"Agentic Checkout","pages":[{"title":"Discover a published merchant agent","deprecated":null,"version":null,"openapi":"/openapi.json get /api/embed/{deploymentId}/.well-known/agent-card.json","href":"/api-reference/agentic-checkout/discover-a-published-merchant-agent"},{"title":"Call a merchant agent using A2A","deprecated":null,"version":null,"openapi":"/openapi.json post /api/embed/{deploymentId}/a2a","href":"/api-reference/agentic-checkout/call-a-merchant-agent-using-a2a"},{"title":"Manage customer-owned purchase offers","deprecated":null,"version":null,"openapi":"/openapi.json post /api/embed/{deploymentId}/checkout-sessions/{operation}","href":"/api-reference/agentic-checkout/manage-customer-owned-purchase-offers"},{"title":"Create Agentic Checkout Session","deprecated":null,"version":null,"openapi":"/openapi.json post /api/v1/checkout-sessions","href":"/api-reference/agentic-checkout/create-agentic-checkout-session"},{"title":"Get Agentic Checkout Session","deprecated":null,"version":null,"openapi":"/openapi.json get /api/v1/checkout-sessions/{sessionId}","href":"/api-reference/agentic-checkout/get-agentic-checkout-session"},{"title":"Replace Agentic Checkout Session Fields","deprecated":null,"version":null,"openapi":"/openapi.json put /api/v1/checkout-sessions/{sessionId}","href":"/api-reference/agentic-checkout/replace-agentic-checkout-session-fields"},{"title":"Update Agentic Checkout Session","deprecated":null,"version":null,"openapi":"/openapi.json patch /api/v1/checkout-sessions/{sessionId}","href":"/api-reference/agentic-checkout/update-agentic-checkout-session"},{"title":"Cancel Agentic Checkout Session","deprecated":null,"version":null,"openapi":"/openapi.json post /api/v1/checkout-sessions/{sessionId}/cancel","href":"/api-reference/agentic-checkout/cancel-agentic-checkout-session"},{"title":"Complete Agentic Checkout Session","deprecated":null,"version":null,"openapi":"/openapi.json post /api/v1/checkout-sessions/{sessionId}/complete","href":"/api-reference/agentic-checkout/complete-agentic-checkout-session"}]},{"group":"Agents","pages":[{"title":"Invoke the Omni agent","deprecated":null,"version":null,"openapi":"/openapi.json post /api/v1/agents/general/invoke","href":"/api-reference/agents/invoke-the-omni-agent"},{"title":"Start an Omni agent run","deprecated":null,"version":null,"openapi":"/openapi.json post /api/v1/agents/general/runs","href":"/api-reference/agents/start-an-omni-agent-run"},{"title":"Get an Omni agent run","deprecated":null,"version":null,"openapi":"/openapi.json get /api/v1/agents/general/runs/{runId}","href":"/api-reference/agents/get-an-omni-agent-run"}]},{"group":"Analytics","pages":[{"title":"Get Ads Analytics","deprecated":null,"version":null,"openapi":"/openapi.json get /api/v1/analytics/ads","href":"/api-reference/analytics/get-ads-analytics"},{"title":"Get AI Traffic Analytics","deprecated":null,"version":null,"openapi":"/openapi.json get /api/v1/analytics/ai-traffic","href":"/api-reference/analytics/get-ai-traffic-analytics"},{"title":"Get Video and LIVE Analytics","deprecated":null,"version":null,"openapi":"/openapi.json get /api/v1/analytics/content","href":"/api-reference/analytics/get-video-and-live-analytics"},{"title":"Get Order Analytics","deprecated":null,"version":null,"openapi":"/openapi.json get /api/v1/analytics/orders","href":"/api-reference/analytics/get-order-analytics"},{"title":"Get Growth Overview","deprecated":null,"version":null,"openapi":"/openapi.json get /api/v1/analytics/overview","href":"/api-reference/analytics/get-growth-overview"},{"title":"Get Pricing Analytics","deprecated":null,"version":null,"openapi":"/openapi.json get /api/v1/analytics/pricing","href":"/api-reference/analytics/get-pricing-analytics"},{"title":"Get Product Analytics","deprecated":null,"version":null,"openapi":"/openapi.json get /api/v1/analytics/products","href":"/api-reference/analytics/get-product-analytics"},{"title":"Get Profit Analytics","deprecated":null,"version":null,"openapi":"/openapi.json get /api/v1/analytics/profit","href":"/api-reference/analytics/get-profit-analytics"},{"title":"Get Business Report","deprecated":null,"version":null,"openapi":"/openapi.json get /api/v1/analytics/reports","href":"/api-reference/analytics/get-business-report"},{"title":"Get Store Analytics","deprecated":null,"version":null,"openapi":"/openapi.json get /api/v1/analytics/stores","href":"/api-reference/analytics/get-store-analytics"},{"title":"Get Traffic Analytics","deprecated":null,"version":null,"openapi":"/openapi.json get /api/v1/analytics/traffic","href":"/api-reference/analytics/get-traffic-analytics"}]},{"group":"AOPs","pages":[{"title":"Get AOP configuration","deprecated":null,"version":null,"openapi":"/openapi.json get /api/v1/aop/{aopId}/config","href":"/api-reference/aops/get-aop-configuration"},{"title":"Overwrite AOP configuration","deprecated":null,"version":null,"openapi":"/openapi.json put /api/v1/aop/{aopId}/config","href":"/api-reference/aops/overwrite-aop-configuration"},{"title":"Execute an AOP","deprecated":null,"version":null,"openapi":"/openapi.json post /api/v1/aop/{aopId}/execute","href":"/api-reference/aops/execute-an-aop"},{"title":"Create AOP","deprecated":null,"version":null,"openapi":"/openapi.json post /api/v1/aop/create","href":"/api-reference/aops/create-aop"},{"title":"Retry a failed AOP execution","deprecated":null,"version":null,"openapi":"/openapi.json post /api/v1/aop/retry","href":"/api-reference/aops/retry-a-failed-aop-execution"},{"title":"Get Thread Status","deprecated":null,"version":null,"openapi":"/openapi.json get /api/v1/threads/{thread_id}/status","href":"/api-reference/aops/get-thread-status"}]},{"group":"Branding","pages":[{"title":"List Brand Kits","deprecated":null,"version":null,"openapi":"/openapi.json get /api/v1/brand-kits","href":"/api-reference/branding/list-brand-kits"},{"title":"Create Brand Kit","deprecated":null,"version":null,"openapi":"/openapi.json post /api/v1/brand-kits","href":"/api-reference/branding/create-brand-kit"},{"title":"Get Brand Kit","deprecated":null,"version":null,"openapi":"/openapi.json get /api/v1/brand-kits/{brandKitId}","href":"/api-reference/branding/get-brand-kit"},{"title":"Delete Brand Kit","deprecated":null,"version":null,"openapi":"/openapi.json delete /api/v1/brand-kits/{brandKitId}","href":"/api-reference/branding/delete-brand-kit"},{"title":"Update Brand Kit","deprecated":null,"version":null,"openapi":"/openapi.json patch /api/v1/brand-kits/{brandKitId}","href":"/api-reference/branding/update-brand-kit"}]},{"group":"Developer Platform","pages":[{"title":"Import BrandsGateway Products","deprecated":null,"version":null,"openapi":"/openapi.json post /api/v1/brandsgateway/import","href":"/api-reference/developer-platform/import-brandsgateway-products"},{"title":"Evaluate SKU Readiness","deprecated":null,"version":null,"openapi":"/openapi.json post /api/v1/evaluate","href":"/api-reference/developer-platform/evaluate-sku-readiness"},{"title":"Generate Ghost Mannequin Image","deprecated":null,"version":null,"openapi":"/openapi.json post /api/v1/images/ghost-mannequin","href":"/api-reference/developer-platform/generate-ghost-mannequin-image"},{"title":"Get Developer Job Status","deprecated":null,"version":null,"openapi":"/openapi.json get /api/v1/jobs/{jobId}","href":"/api-reference/developer-platform/get-developer-job-status"},{"title":"Cancel Developer Job","deprecated":null,"version":null,"openapi":"/openapi.json post /api/v1/jobs/{jobId}/cancel","href":"/api-reference/developer-platform/cancel-developer-job"},{"title":"Recommend Marketplace Product Categories","deprecated":null,"version":null,"openapi":"/openapi.json post /api/v1/manage-product-category/recommend","href":"/api-reference/developer-platform/recommend-marketplace-product-categories"},{"title":"List Connected Marketplaces","deprecated":null,"version":null,"openapi":"/openapi.json get /api/v1/marketplaces/connected","href":"/api-reference/developer-platform/list-connected-marketplaces"},{"title":"Run AI Shelf Share Monitor","deprecated":null,"version":null,"openapi":"/openapi.json post /api/v1/monitor","href":"/api-reference/developer-platform/run-ai-shelf-share-monitor"},{"title":"Sync Product Commercial Fields","deprecated":null,"version":null,"openapi":"/openapi.json post /api/v1/sync","href":"/api-reference/developer-platform/sync-product-commercial-fields"},{"title":"List Webhook Events","deprecated":null,"version":null,"openapi":"/openapi.json get /api/v1/webhook-events","href":"/api-reference/developer-platform/list-webhook-events"},{"title":"List Developer Webhooks","deprecated":null,"version":null,"openapi":"/openapi.json get /api/v1/webhooks","href":"/api-reference/developer-platform/list-developer-webhooks"},{"title":"Create Developer Webhook","deprecated":null,"version":null,"openapi":"/openapi.json post /api/v1/webhooks","href":"/api-reference/developer-platform/create-developer-webhook"},{"title":"Get Selected Zalora Import Status","deprecated":null,"version":null,"openapi":"/openapi.json get /api/v1/zalora/import","href":"/api-reference/developer-platform/get-selected-zalora-import-status"},{"title":"Import Selected Zalora Products","deprecated":null,"version":null,"openapi":"/openapi.json post /api/v1/zalora/import","href":"/api-reference/developer-platform/import-selected-zalora-products"}]},{"group":"Campaigns","pages":[{"title":"List Campaigns","deprecated":null,"version":null,"openapi":"/openapi.json get /api/v1/campaigns","href":"/api-reference/campaigns/list-campaigns"},{"title":"Create Campaign","deprecated":null,"version":null,"openapi":"/openapi.json post /api/v1/campaigns","href":"/api-reference/campaigns/create-campaign"},{"title":"Get Campaign","deprecated":null,"version":null,"openapi":"/openapi.json get /api/v1/campaigns/{campaignId}","href":"/api-reference/campaigns/get-campaign"},{"title":"Update Campaign","deprecated":null,"version":null,"openapi":"/openapi.json put /api/v1/campaigns/{campaignId}","href":"/api-reference/campaigns/update-campaign"},{"title":"Act on Campaign","deprecated":null,"version":null,"openapi":"/openapi.json post /api/v1/campaigns/{campaignId}/actions","href":"/api-reference/campaigns/act-on-campaign"},{"title":"Archive Campaigns","deprecated":null,"version":null,"openapi":"/openapi.json post /api/v1/campaigns/archive","href":"/api-reference/campaigns/archive-campaigns"},{"title":"Delete Campaigns","deprecated":null,"version":null,"openapi":"/openapi.json post /api/v1/campaigns/delete","href":"/api-reference/campaigns/delete-campaigns"},{"title":"Get Campaign Options","deprecated":null,"version":null,"openapi":"/openapi.json get /api/v1/campaigns/options","href":"/api-reference/campaigns/get-campaign-options"}]},{"group":"Products","pages":[{"title":"Export Catalog Items","deprecated":null,"version":null,"openapi":"/openapi.json get /api/v1/catalog/items","href":"/api-reference/products/export-catalog-items"},{"title":"List Products","deprecated":null,"version":null,"openapi":"/openapi.json get /api/v1/products","href":"/api-reference/products/list-products"},{"title":"Create Product","deprecated":null,"version":null,"openapi":"/openapi.json post /api/v1/products","href":"/api-reference/products/create-product"},{"title":"Get Product","deprecated":null,"version":null,"openapi":"/openapi.json get /api/v1/products/{productId}","href":"/api-reference/products/get-product"},{"title":"Delete Product","deprecated":null,"version":null,"openapi":"/openapi.json delete /api/v1/products/{productId}","href":"/api-reference/products/delete-product"},{"title":"Update Product","deprecated":null,"version":null,"openapi":"/openapi.json patch /api/v1/products/{productId}","href":"/api-reference/products/update-product"},{"title":"Update Product Cost","deprecated":null,"version":null,"openapi":"/openapi.json patch /api/v1/products/{productId}/cost","href":"/api-reference/products/update-product-cost"},{"title":"Delist Product","deprecated":null,"version":null,"openapi":"/openapi.json post /api/v1/products/{productId}/delist","href":"/api-reference/products/delist-product"},{"title":"Upload Product Image","deprecated":null,"version":null,"openapi":"/openapi.json post /api/v1/products/{productId}/images","href":"/api-reference/products/upload-product-image"},{"title":"Update Product Inventory","deprecated":null,"version":null,"openapi":"/openapi.json patch /api/v1/products/{productId}/inventory","href":"/api-reference/products/update-product-inventory"},{"title":"Get Product Listings","deprecated":null,"version":null,"openapi":"/openapi.json get /api/v1/products/{productId}/listings","href":"/api-reference/products/get-product-listings"},{"title":"Update Product Price","deprecated":null,"version":null,"openapi":"/openapi.json patch /api/v1/products/{productId}/price","href":"/api-reference/products/update-product-price"},{"title":"Publish Product","deprecated":null,"version":null,"openapi":"/openapi.json post /api/v1/products/{productId}/publish","href":"/api-reference/products/publish-product"},{"title":"Bulk Import Products from JSON or CSV","deprecated":null,"version":null,"openapi":"/openapi.json post /api/v1/products/bulk-import","href":"/api-reference/products/bulk-import-products-from-json-or-csv"},{"title":"Get Import Retry Progress","deprecated":null,"version":null,"openapi":"/openapi.json get /api/v1/products/bulk-import/retries/{retryJobId}","href":"/api-reference/products/get-import-retry-progress"},{"title":"Retry Failed Import or Review Jobs","deprecated":null,"version":null,"openapi":"/openapi.json post /api/v1/products/bulk-import/retry","href":"/api-reference/products/retry-failed-import-or-review-jobs"},{"title":"Compare Product Market Prices","deprecated":null,"version":null,"openapi":"/openapi.json post /api/v1/products/compare-prices","href":"/api-reference/products/compare-product-market-prices"},{"title":"Get Product Price Comparison","deprecated":null,"version":null,"openapi":"/openapi.json get /api/v1/products/compare-prices/jobs/{jobId}","href":"/api-reference/products/get-product-price-comparison"},{"title":"Batch Update Product Cost","deprecated":null,"version":null,"openapi":"/openapi.json post /api/v1/products/cost","href":"/api-reference/products/batch-update-product-cost"},{"title":"Count Products","deprecated":null,"version":null,"openapi":"/openapi.json get /api/v1/products/count","href":"/api-reference/products/count-products"},{"title":"Queue Product Enrichment","deprecated":null,"version":null,"openapi":"/openapi.json post /api/v1/products/enrich","href":"/api-reference/products/queue-product-enrichment"}]},{"group":"Commerce","pages":[{"title":"Await Commerce Jobs","description":"Wait for a mixed batch of returned commerce correlations: inventory_job, price_event, price_book_sync, publish_job, delist_batch, store_switch, omni_delete, zalora_import, enrichment_batch, order_action and return_action. Maximum 50000 entries; IDs are trimmed and duplicates collapse by kind/id in first-requested order. timeoutMs=0 reads once; bounded waits allow up to 120000ms. Catalog jobs require catalog:read; order/return jobs require orders:read; mixed batches require both. Session callers include organizationId. Every job retains its target identity, status, errors and available label artifacts. Missing or inaccessible fulfillment jobs fail explicitly. needs_review is an uncertain outcome, never automatic success or authorization to resubmit. data.success describes completion; use state verification before claiming a marketplace effect. Scheduled future actions are verified after execution, not when scheduled.","deprecated":null,"version":null,"openapi":"/openapi.json post /api/v1/commerce/jobs/await","href":"/api-reference/commerce/await-commerce-jobs"},{"title":"Verify Commerce State","deprecated":null,"version":null,"openapi":"/openapi.json post /api/v1/commerce/state/verify","href":"/api-reference/commerce/verify-commerce-state"}]},{"group":"Public Agent","pages":[{"title":"Compare Public Products","description":"Compare 2 to 10 public products side-by-side across price, ACO readiness, marketplace coverage, and inventory.","deprecated":null,"version":null,"openapi":"/openapi.json get /api/v1/compare","href":"/api-reference/public-agent/compare-public-products"},{"title":"List Public Merchants","deprecated":null,"version":null,"openapi":"/openapi.json get /api/v1/directory","href":"/api-reference/public-agent/list-public-merchants"},{"title":"Get Merchant LLM Feed","deprecated":null,"version":null,"openapi":"/openapi.json get /api/v1/feed/{domain}/llms.txt","href":"/api-reference/public-agent/get-merchant-llm-feed"},{"title":"Get Public Merchant Manifest","deprecated":null,"version":null,"openapi":"/openapi.json get /api/v1/merchants/{merchantId}/manifest","href":"/api-reference/public-agent/get-public-merchant-manifest"},{"title":"List Public Merchant Products","deprecated":null,"version":null,"openapi":"/openapi.json get /api/v1/merchants/{merchantId}/products","href":"/api-reference/public-agent/list-public-merchant-products"},{"title":"Search Within Public Merchant Catalog","deprecated":null,"version":null,"openapi":"/openapi.json get /api/v1/merchants/{merchantId}/search","href":"/api-reference/public-agent/search-within-public-merchant-catalog"},{"title":"Search Public Merchant Products","deprecated":null,"version":null,"openapi":"/openapi.json get /api/v1/search","href":"/api-reference/public-agent/search-public-merchant-products"},{"title":"Search Public Merchant Products","deprecated":null,"version":null,"openapi":"/openapi.json post /api/v1/search","href":"/api-reference/public-agent/search-public-merchant-products-1"}]},{"group":"Knowledge Base","pages":[{"title":"Upload Document","deprecated":null,"version":null,"openapi":"/openapi.json post /api/v1/documents","href":"/api-reference/documents/upload-document"},{"title":"Get Document","deprecated":null,"version":null,"openapi":"/openapi.json get /api/v1/documents/{documentId}","href":"/api-reference/documents/get-document"}]},{"group":"Inventory","pages":[{"title":"List Inventory Groups","deprecated":null,"version":null,"openapi":"/openapi.json get /api/v1/inventory","href":"/api-reference/inventory/list-inventory-groups"}]},{"group":"Looks","pages":[{"title":"List Looks","deprecated":null,"version":null,"openapi":"/openapi.json get /api/v1/looks","href":"/api-reference/looks/list-looks"},{"title":"Create Look","deprecated":null,"version":null,"openapi":"/openapi.json post /api/v1/looks","href":"/api-reference/looks/create-look"},{"title":"Get Look","deprecated":null,"version":null,"openapi":"/openapi.json get /api/v1/looks/{lookId}","href":"/api-reference/looks/get-look"}]},{"group":"OAuth","pages":[{"title":"Revoke Access Token","deprecated":null,"version":null,"openapi":"/openapi.json post /api/v1/oauth/revoke","href":"/api-reference/oauth/revoke-access-token"},{"title":"Get Access Token","deprecated":null,"version":null,"openapi":"/openapi.json post /api/v1/oauth/token","href":"/api-reference/oauth/get-access-token"}]},{"group":"Orders","pages":[{"title":"List Orders","deprecated":null,"version":null,"openapi":"/openapi.json get /api/v1/orders","href":"/api-reference/orders/list-orders"},{"title":"Create Order","deprecated":null,"version":null,"openapi":"/openapi.json post /api/v1/orders","href":"/api-reference/orders/create-order"},{"title":"Get Order","deprecated":null,"version":null,"openapi":"/openapi.json get /api/v1/orders/{orderId}","href":"/api-reference/orders/get-order"},{"title":"Update Order","deprecated":null,"version":null,"openapi":"/openapi.json patch /api/v1/orders/{orderId}","href":"/api-reference/orders/update-order"},{"title":"Get Order Action Options","deprecated":null,"version":null,"openapi":"/openapi.json get /api/v1/orders/{orderId}/action-options","href":"/api-reference/orders/get-order-action-options"},{"title":"List Order Actions","deprecated":null,"version":null,"openapi":"/openapi.json get /api/v1/orders/{orderId}/actions","href":"/api-reference/orders/list-order-actions"},{"title":"Queue Order Action","deprecated":null,"version":null,"openapi":"/openapi.json post /api/v1/orders/{orderId}/actions","href":"/api-reference/orders/queue-order-action"},{"title":"Check Order Action Options","deprecated":null,"version":null,"openapi":"/openapi.json get /api/v1/orders/actions","href":"/api-reference/orders/check-order-action-options"},{"title":"Process Order Actions","deprecated":null,"version":null,"openapi":"/openapi.json post /api/v1/orders/actions","href":"/api-reference/orders/process-order-actions"},{"title":"Get Order Action Jobs","deprecated":null,"version":null,"openapi":"/openapi.json get /api/v1/orders/actions/jobs","href":"/api-reference/orders/get-order-action-jobs"},{"title":"Create Picking List","deprecated":null,"version":null,"openapi":"/openapi.json post /api/v1/orders/picking-list","href":"/api-reference/orders/create-picking-list"}]},{"group":"Organizations","pages":[{"title":"Create Organization","deprecated":null,"version":null,"openapi":"/openapi.json post /api/v1/organizations","href":"/api-reference/organizations/create-organization"}]},{"group":"Price Books","pages":[{"title":"List Price Book Rules","deprecated":null,"version":null,"openapi":"/openapi.json get /api/v1/price-books","href":"/api-reference/price-books/list-price-book-rules"},{"title":"Create Price Book Rule","deprecated":null,"version":null,"openapi":"/openapi.json post /api/v1/price-books","href":"/api-reference/price-books/create-price-book-rule"},{"title":"Get Price Book Rule","deprecated":null,"version":null,"openapi":"/openapi.json get /api/v1/price-books/{ruleId}","href":"/api-reference/price-books/get-price-book-rule"},{"title":"Delete Price Book Rule","deprecated":null,"version":null,"openapi":"/openapi.json delete /api/v1/price-books/{ruleId}","href":"/api-reference/price-books/delete-price-book-rule"},{"title":"Update Price Book Rule","deprecated":null,"version":null,"openapi":"/openapi.json patch /api/v1/price-books/{ruleId}","href":"/api-reference/price-books/update-price-book-rule"},{"title":"Preview Channel List Price","deprecated":null,"version":null,"openapi":"/openapi.json post /api/v1/price-books/preview","href":"/api-reference/price-books/preview-channel-list-price"}]},{"group":"Promotions","pages":[{"title":"List Promotions","deprecated":null,"version":null,"openapi":"/openapi.json get /api/v1/promotions","href":"/api-reference/promotions/list-promotions"},{"title":"Create Promotion","deprecated":null,"version":null,"openapi":"/openapi.json post /api/v1/promotions","href":"/api-reference/promotions/create-promotion"},{"title":"Get Promotion","deprecated":null,"version":null,"openapi":"/openapi.json get /api/v1/promotions/{promotionId}","href":"/api-reference/promotions/get-promotion"},{"title":"Delete Promotion","deprecated":null,"version":null,"openapi":"/openapi.json delete /api/v1/promotions/{promotionId}","href":"/api-reference/promotions/delete-promotion"},{"title":"Update Promotion","deprecated":null,"version":null,"openapi":"/openapi.json patch /api/v1/promotions/{promotionId}","href":"/api-reference/promotions/update-promotion"},{"title":"List Promotion Assignments","deprecated":null,"version":null,"openapi":"/openapi.json get /api/v1/promotions/{promotionId}/products","href":"/api-reference/promotions/list-promotion-assignments"},{"title":"Assign Products to Promotion","deprecated":null,"version":null,"openapi":"/openapi.json post /api/v1/promotions/{promotionId}/products","href":"/api-reference/promotions/assign-products-to-promotion"},{"title":"Unassign Products from Promotion","deprecated":null,"version":null,"openapi":"/openapi.json delete /api/v1/promotions/{promotionId}/products","href":"/api-reference/promotions/unassign-products-from-promotion"},{"title":"Retry Marketplace Delivery","deprecated":null,"version":null,"openapi":"/openapi.json post /api/v1/promotions/{promotionId}/retry","href":"/api-reference/promotions/retry-marketplace-delivery"}]},{"group":"Returns","pages":[{"title":"List Returns","deprecated":null,"version":null,"openapi":"/openapi.json get /api/v1/returns","href":"/api-reference/returns/list-returns"},{"title":"Get Return","deprecated":null,"version":null,"openapi":"/openapi.json get /api/v1/returns/{returnId}","href":"/api-reference/returns/get-return"},{"title":"Check Return Actions","deprecated":null,"version":null,"openapi":"/openapi.json get /api/v1/returns/actions","href":"/api-reference/returns/check-return-actions"},{"title":"Process Returns","deprecated":null,"version":null,"openapi":"/openapi.json post /api/v1/returns/actions","href":"/api-reference/returns/process-returns"},{"title":"Get Return Action Jobs","deprecated":null,"version":null,"openapi":"/openapi.json get /api/v1/returns/actions/jobs","href":"/api-reference/returns/get-return-action-jobs"},{"title":"Get Order Returns","deprecated":null,"version":null,"openapi":"/openapi.json get /api/v1/returns/orders","href":"/api-reference/returns/get-order-returns"}]},{"group":"Reviews","pages":[{"title":"List Reviews","deprecated":null,"version":null,"openapi":"/openapi.json get /api/v1/reviews","href":"/api-reference/reviews/list-reviews"},{"title":"Get Review","deprecated":null,"version":null,"openapi":"/openapi.json get /api/v1/reviews/{reviewId}","href":"/api-reference/reviews/get-review"},{"title":"Reply to Review","deprecated":null,"version":null,"openapi":"/openapi.json post /api/v1/reviews/{reviewId}/reply","href":"/api-reference/reviews/reply-to-review"}]},{"group":"Settlements","pages":[{"title":"List Settlements","deprecated":null,"version":null,"openapi":"/openapi.json get /api/v1/settlements","href":"/api-reference/settlements/list-settlements"},{"title":"Apply Settlements","deprecated":null,"version":null,"openapi":"/openapi.json post /api/v1/settlements","href":"/api-reference/settlements/apply-settlements"},{"title":"Get Settlement","deprecated":null,"version":null,"openapi":"/openapi.json get /api/v1/settlements/{settlementId}","href":"/api-reference/settlements/get-settlement"}]},{"group":"UCP","pages":[{"title":"Create UCP Checkout Session","deprecated":null,"version":null,"openapi":"/openapi.json post /ucp/v1/checkout-sessions","href":"/api-reference/ucp/create-ucp-checkout-session"},{"title":"Get UCP Checkout Session","deprecated":null,"version":null,"openapi":"/openapi.json get /ucp/v1/checkout-sessions/{sessionId}","href":"/api-reference/ucp/get-ucp-checkout-session"},{"title":"Replace UCP Checkout Session Fields","deprecated":null,"version":null,"openapi":"/openapi.json put /ucp/v1/checkout-sessions/{sessionId}","href":"/api-reference/ucp/replace-ucp-checkout-session-fields"},{"title":"Update UCP Checkout Session","deprecated":null,"version":null,"openapi":"/openapi.json patch /ucp/v1/checkout-sessions/{sessionId}","href":"/api-reference/ucp/update-ucp-checkout-session"},{"title":"Cancel UCP Checkout Session","deprecated":null,"version":null,"openapi":"/openapi.json post /ucp/v1/checkout-sessions/{sessionId}/cancel","href":"/api-reference/ucp/cancel-ucp-checkout-session"},{"title":"Complete UCP Checkout Session","deprecated":null,"version":null,"openapi":"/openapi.json post /ucp/v1/checkout-sessions/{sessionId}/complete","href":"/api-reference/ucp/complete-ucp-checkout-session"},{"title":"Get UCP Order","deprecated":null,"version":null,"openapi":"/openapi.json get /ucp/v1/orders/{orderId}","href":"/api-reference/ucp/get-ucp-order"}]},{"group":"product webhooks","pages":[]},{"group":"enrichment webhooks","pages":[]},{"group":"look webhooks","pages":[]},{"group":"review webhooks","pages":[]},{"group":"order webhooks","pages":[]},{"group":"settlement webhooks","pages":[]},{"group":"return webhooks","pages":[]},{"group":"account statement webhooks","pages":[]}]},{"group":"Webhooks","pages":[{"group":"Product","pages":[{"title":"Product created","openapi":"openapi.json webhook productCreated","href":"/webhooks/reference/product-created"},{"title":"Product updated","openapi":"openapi.json webhook productUpdated","href":"/webhooks/reference/product-updated"},{"title":"Product deleted","openapi":"openapi.json webhook productDeleted","href":"/webhooks/reference/product-deleted"},{"title":"Product delisted","openapi":"openapi.json webhook productDelisted","href":"/webhooks/reference/product-delisted"},{"title":"Product price changed","openapi":"openapi.json webhook productPriceChanged","href":"/webhooks/reference/product-price-changed"},{"title":"Product inventory changed","openapi":"openapi.json webhook productInventoryChanged","href":"/webhooks/reference/product-inventory-changed"}]},{"group":"Orders","pages":[{"title":"Order created","openapi":"openapi.json webhook orderCreated","href":"/webhooks/reference/order-created"},{"title":"Order updated","openapi":"openapi.json webhook orderUpdated","href":"/webhooks/reference/order-updated"},{"title":"Order status changed","openapi":"openapi.json webhook orderStatusChanged","href":"/webhooks/reference/order-status-changed"},{"title":"Order deleted","openapi":"openapi.json webhook orderDeleted","href":"/webhooks/reference/order-deleted"}]},{"group":"Looks","pages":[{"title":"Look created","openapi":"openapi.json webhook lookCreated","href":"/webhooks/reference/look-created"},{"title":"Look deleted","openapi":"openapi.json webhook lookDeleted","href":"/webhooks/reference/look-deleted"}]},{"group":"Review","pages":[{"title":"Review created","openapi":"openapi.json webhook reviewCreated","href":"/webhooks/reference/review-created"},{"title":"Review updated","openapi":"openapi.json webhook reviewUpdated","href":"/webhooks/reference/review-updated"},{"title":"Review status changed","openapi":"openapi.json webhook reviewStatusChanged","href":"/webhooks/reference/review-status-changed"}]},{"group":"Settlements","pages":[{"title":"Settlement created","openapi":"openapi.json webhook settlementCreated","href":"/webhooks/reference/settlement-created"},{"title":"Settlement updated","openapi":"openapi.json webhook settlementUpdated","href":"/webhooks/reference/settlement-updated"},{"title":"Settlement status changed","openapi":"openapi.json webhook settlementStatusChanged","href":"/webhooks/reference/settlement-status-changed"}]},{"group":"Returns","pages":[{"title":"Return created","openapi":"openapi.json webhook returnCreated","href":"/webhooks/reference/return-created"},{"title":"Return updated","openapi":"openapi.json webhook returnUpdated","href":"/webhooks/reference/return-updated"},{"title":"Return status changed","openapi":"openapi.json webhook returnStatusChanged","href":"/webhooks/reference/return-status-changed"}]}]}]},{"tab":"Changelog","pages":[{"title":"Changelog","href":"/changelog"}]}]},"title":"Verify Commerce State - OmniCommerce","buildId":"dpl_2oYXwqkEXirXBPk8wV1FtM5USFWi","deploymentId":"dpl_2oYXwqkEXirXBPk8wV1FtM5USFWi","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-WRhTSUDL.js","utils-ChMov4Kr.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-_REmC2bI.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-Bp6nVRCu.js","snippetPresets-DZadmXoU.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","ApiExamples-CY2WdoTl.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-DwYG-Q4l.js","shallow-BXQIGwv4.js","getApiPlaygroundDisplay-CK5nK5B9.js","CodeSnippet-TH4a2aGW.js","CodeSnippets-DwsQiOFS.js","Page-R3M_BF4L.js","getPastedJson-DD7kUzi_.js","icon-holE3QoJ.js","MethodPill-DUW0T8us.js","DuplicateIcon-CI_p4be-.js","createIcon-BdbRvavb.js","DynamicMarkdown-DN96a4Ur.js","SectionHeading-SCu36A9d.js","axios-vUo_bRtp.js","Markdown-CCeGv-zI.js","clsx-BGBGWFTt.js","lib--scc4DXi.js","lib-B8HbPgcC.js","html-void-elements-mCSPHezU.js","dist-Cv_O2fky.js","katex-YMM-FMeD.js","marked.esm-CZWythHk.js","AssistantPageLink-2C5OB2eV.js"]}