Merchant code the request is scoped to. Required on every dispute-webhook request, even when your secret key maps to a single merchant; case-insensitive.
Example:
"code provided to you from Tabby side"
Response
Success. Array of dispute webhooks; an empty array when none are registered.
The signing header, if one was registered. value is masked.
Show child attributes
Was this page helpful?
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Tabby","colors":{"primary":"#41A854","light":"#6CFF93","dark":"#41A854"},"logo":{"light":"https://mintcdn.com/tabby-26277sa/VGR1VunycMFYW0gO/logo/tabby-badge.svg?fit=max\u0026auto=format\u0026n=VGR1VunycMFYW0gO\u0026q=85\u0026s=0fd2a3090f99185f666929e20a7504a4","dark":"https://mintcdn.com/tabby-26277sa/VGR1VunycMFYW0gO/logo/tabby-badge.svg?fit=max\u0026auto=format\u0026n=VGR1VunycMFYW0gO\u0026q=85\u0026s=0fd2a3090f99185f666929e20a7504a4"},"favicon":"https://mintcdn.com/tabby-26277sa/t5b0diXp4aP0BKke/favicon-new.png?fit=max\u0026auto=format\u0026n=t5b0diXp4aP0BKke\u0026q=85\u0026s=35c48485cefd869270047b5cef780d80","api":{"playground":{"display":"interactive"},"examples":{"defaults":"all","languages":["curl","python","javascript","php","go","java","ruby"],"prefill":true}},"appearance":{"default":"light","strict":false},"navbar":{"primary":{"type":"button","label":"Register","href":"https://merchant.tabby.ai"}},"footer":{"socials":{"facebook":"https://www.facebook.com/tabbypay-100185885064531","instagram":"https://instagram.com/tabbypay","linkedin":"https://www.linkedin.com/company/tabbypay","x":"https://twitter.com/paywithtabby?lang=en"}},"styling":{"codeblocks":"dark","latex":false},"contextual":{"options":["copy","view","chatgpt","claude","mcp"],"display":"header"},"navigation":{"languages":[{"language":"en","default":true,"href":"introduction/what-is-tabby"},{"language":"ar","href":"ar/marketing/toolkit"}]}},"deployment":{"deploymentMetadataValue":{"subdomain":"tabby-26277sa","hasAudioNarration":false,"actualSubdomain":"tabby-26277sa","customDomains":["docs.tabby.sa"],"gitSource":{"type":"github","owner":"dmitriifrolovtabby","repo":"docs","deployBranch":"main","contentDirectory":"","isPrivate":true,"mountPath":"","label":""},"chroma":{"collectionId":"2c5c00e8-b849-4c0c-91d4-6378d68ba5ec","liveDeploymentHistoryId":"6ae8e0012939aada88167075","schemaVersion":"v3","latestBuiltDeploymentHistoryId":"6ae8e0012939aada88167075"},"feedback":{"thumbs":true},"entitlements":{"AI_CHAT":{"status":"DISABLED"}},"buildId":"6ae8e0012939aada88167075","clientVersion":"0.0.4076","searchFilterCounts":[{"language":"en","tag":"Documentation","count":36},{"language":"en","tag":"API Playground","count":28},{"language":"en","tag":"E-commerce Platforms","count":15},{"language":"en","tag":"Online Custom Integration","count":12},{"language":"en","tag":"Webhooks","count":7},{"language":"en","tag":"Disputes","count":6},{"language":"en","tag":"Payments","count":6},{"language":"en","tag":"Dispute Webhooks","count":5},{"language":"en","tag":"Introduction","count":5},{"language":"en","tag":"Shopify","count":3},{"language":"ar","tag":"مجموعة أدوات التسويق","count":1}]},"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":"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":"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":[{"filePath":"styles.css","content":"@font-face{font-family:'Tabby Sans Display';src:url(/fonts/TabbySansDisplay-Bold.woff2) format('woff2');font-weight:100 900;font-style:normal;font-display:swap}@font-face{font-family:'Tabby Sans Text';src:url(/fonts/TabbySansText-Regular.woff2) format('woff2');font-weight:100 400;font-style:normal;font-display:swap}@font-face{font-family:'Tabby Sans Text';src:url(/fonts/TabbySansText-Medium.woff2) format('woff2');font-weight:500 600;font-style:normal;font-display:swap}@font-face{font-family:'Tabby Sans Text';src:url(/fonts/TabbySansText-Bold.woff2) format('woff2');font-weight:700 900;font-style:normal;font-display:swap}body,.font-sans{font-family:'Tabby Sans Text', ui-sans-serif, system-ui, -apple-system, sans-serif!important}h1,h2,h3,h4{font-family:'Tabby Sans Display', 'Tabby Sans Text', sans-serif;letter-spacing:normal!important}img.product-shot,video.product-shot{display:block;margin:1.5rem auto;border-radius:1rem;border:1px solid rgb(10 10 10 / 0.10);box-shadow:0 10px 25px -5px rgb(0 0 0 / 0.12), 0 4px 10px -6px rgb(0 0 0 / 0.10)}.dark img.product-shot,.dark video.product-shot{border-color:rgb(255 255 255 / 0.15);box-shadow:0 10px 25px -5px rgb(0 0 0 / 0.45)}img.snippet-shot{display:block;margin:1.5rem auto}img.framed-shot{display:block;width:min(520px, 100%);margin:1.5rem auto;border-radius:12px}li img.framed-shot{width:min(520px, calc(100% - 38px))}div.product-shot-figure{margin:1.5rem auto;text-align:center}div.product-shot-figure img.product-shot{margin:1.5rem auto 0}p.product-shot-caption{margin-top:0.75rem;font-size:0.875rem;color:rgb(107 114 128)}html[lang=\"ar\"] #content,html[lang=\"ar\"] .mdx-content{direction:rtl}html[lang=\"ar\"] #header{direction:rtl;text-align:right}html[lang=\"ar\"] #content :is(ul,ol)>li{padding-left:6px;padding-right:32px}html[lang=\"ar\"] #content :is(ul,ol)>li::before{left:auto;right:8px}html[lang=\"ar\"] #content svg.lucide-arrow-up-right,html[lang=\"ar\"] #content svg.lucide-arrow-right,html[lang=\"ar\"] #content svg.lucide-chevron-right{transform:scaleX(-1)}html[lang=\"ar\"] #content .absolute:has(>svg.lucide-arrow-up-right){right:auto;left:1.25rem}html[lang=\"ar\"] #content a svg.rotate-0.overflow-visible{transform:scaleX(-1)}html[lang=\"ar\"] #content blockquote{border-left-width:0}#content-area .mdx-content,#content-container .mdx-content{max-width:80ch}@media (min-width: 1280px){.max-w-8xl,div:has(>#content-container){max-width:100rem!important}}button[data-component-part=\"code-block-footer-button\"]{color:#6cff93!important;font-weight:600}button[data-component-part=\"code-block-footer-button\"]:hover{text-decoration:underline}.messaging-table table th:first-child,.messaging-table table td:first-child{width:1%;min-width:0;white-space:nowrap}:root:not(.dark) span[data-badge=\"true\"][data-color=\"gray\"]{background-color:#F5F4F2!important;color:#1A1919!important}:root:not(.dark) span[data-badge=\"true\"][data-color=\"blue\"]{background-color:#DFECF7!important;color:#3380C0!important}:root:not(.dark) span[data-badge=\"true\"][data-color=\"green\"]{background-color:#DAF0DF!important;color:#238E3B!important}:root:not(.dark) span[data-badge=\"true\"][data-color=\"yellow\"]{background-color:#FCEDB8!important;color:#D66A1E!important}:root:not(.dark) span[data-badge=\"true\"][data-color=\"orange\"]{background-color:#FFE6CC!important;color:#D66A1E!important}:root:not(.dark) span[data-badge=\"true\"][data-color=\"red\"]{background-color:#FFE1DE!important;color:#D44C3B!important}:root:not(.dark) span[data-badge=\"true\"][data-color=\"purple\"]{background-color:#F5DEFA!important;color:#A55AB8!important}:root:not(.dark) .callout[data-callout-type=\"note\"],:root:not(.dark) .callout[data-callout-type=\"info\"]{background-color:#DFECF7!important;border-color:#C4DCEF!important}:root:not(.dark) .callout[data-callout-type=\"note\"] [data-component-part=\"callout-content\"],:root:not(.dark) .callout[data-callout-type=\"note\"] [data-component-part=\"callout-icon\"],:root:not(.dark) .callout[data-callout-type=\"info\"] [data-component-part=\"callout-content\"],:root:not(.dark) .callout[data-callout-type=\"info\"] [data-component-part=\"callout-icon\"]{color:#3380C0!important}:root:not(.dark) .callout[data-callout-type=\"check\"],:root:not(.dark) .callout[data-callout-type=\"tip\"]{background-color:#DAF0DF!important;border-color:#BFE4C9!important}:root:not(.dark) .callout[data-callout-type=\"check\"] [data-component-part=\"callout-content\"],:root:not(.dark) .callout[data-callout-type=\"check\"] [data-component-part=\"callout-icon\"],:root:not(.dark) .callout[data-callout-type=\"tip\"] [data-component-part=\"callout-content\"],:root:not(.dark) .callout[data-callout-type=\"tip\"] [data-component-part=\"callout-icon\"]{color:#238E3B!important}:root:not(.dark) .callout[data-callout-type=\"danger\"]{background-color:#FFE1DE!important;border-color:#FFC7C1!important}:root:not(.dark) .callout[data-callout-type=\"danger\"] [data-component-part=\"callout-content\"],:root:not(.dark) .callout[data-callout-type=\"danger\"] [data-component-part=\"callout-icon\"]{color:#D44C3B!important}:root:not(.dark) .callout[data-callout-type=\"warning\"]{background-color:#FCEDB8!important;border-color:#F5DE8E!important}:root:not(.dark) .callout[data-callout-type=\"warning\"] [data-component-part=\"callout-content\"],:root:not(.dark) .callout[data-callout-type=\"warning\"] [data-component-part=\"callout-icon\"]{color:#D66A1E!important}.dark span[data-badge=\"true\"][data-color=\"gray\"]{background-color:rgb(245 244 242 / 0.12)!important;color:#E8E6E3!important}.dark span[data-badge=\"true\"][data-color=\"blue\"]{background-color:rgb(51 128 192 / 0.22)!important;color:#DFECF7!important}.dark span[data-badge=\"true\"][data-color=\"green\"]{background-color:rgb(35 142 59 / 0.22)!important;color:#DAF0DF!important}.dark span[data-badge=\"true\"][data-color=\"yellow\"]{background-color:rgb(214 106 30 / 0.22)!important;color:#FCEDB8!important}.dark span[data-badge=\"true\"][data-color=\"orange\"]{background-color:rgb(214 106 30 / 0.22)!important;color:#FFE6CC!important}.dark span[data-badge=\"true\"][data-color=\"red\"]{background-color:rgb(212 76 59 / 0.22)!important;color:#FFE1DE!important}.dark span[data-badge=\"true\"][data-color=\"purple\"]{background-color:rgb(165 90 184 / 0.22)!important;color:#F5DEFA!important}.dark .callout[data-callout-type=\"note\"],.dark .callout[data-callout-type=\"info\"]{background-color:rgb(51 128 192 / 0.18)!important;border-color:rgb(51 128 192 / 0.45)!important}.dark .callout[data-callout-type=\"note\"] [data-component-part=\"callout-content\"],.dark .callout[data-callout-type=\"note\"] [data-component-part=\"callout-icon\"],.dark .callout[data-callout-type=\"info\"] [data-component-part=\"callout-content\"],.dark .callout[data-callout-type=\"info\"] [data-component-part=\"callout-icon\"]{color:#DFECF7!important}.dark .callout[data-callout-type=\"check\"],.dark .callout[data-callout-type=\"tip\"]{background-color:rgb(35 142 59 / 0.18)!important;border-color:rgb(35 142 59 / 0.45)!important}.dark .callout[data-callout-type=\"check\"] [data-component-part=\"callout-content\"],.dark .callout[data-callout-type=\"check\"] [data-component-part=\"callout-icon\"],.dark .callout[data-callout-type=\"tip\"] [data-component-part=\"callout-content\"],.dark .callout[data-callout-type=\"tip\"] [data-component-part=\"callout-icon\"]{color:#DAF0DF!important}.dark .callout[data-callout-type=\"danger\"]{background-color:rgb(212 76 59 / 0.18)!important;border-color:rgb(212 76 59 / 0.45)!important}.dark .callout[data-callout-type=\"danger\"] [data-component-part=\"callout-content\"],.dark .callout[data-callout-type=\"danger\"] [data-component-part=\"callout-icon\"]{color:#FFE1DE!important}.dark .callout[data-callout-type=\"warning\"]{background-color:rgb(214 106 30 / 0.18)!important;border-color:rgb(214 106 30 / 0.45)!important}.dark .callout[data-callout-type=\"warning\"] [data-component-part=\"callout-content\"],.dark .callout[data-callout-type=\"warning\"] [data-component-part=\"callout-icon\"]{color:#FCEDB8!important}.callout [data-component-part=\"callout-icon\"] svg{color:inherit!important}#content a.cta-button{display:inline-flex;align-items:center;gap:0.5rem;padding:0.75rem 1.5rem;border-radius:9999px;background-color:#41A854;color:#FFFFFF!important;font-weight:600;font-size:1rem;line-height:1.25;text-decoration:none!important;transition:background-color 0.15s ease, transform 0.15s ease}#content a.cta-button::after{content:\"↗\";font-size:1.05em;line-height:1}#content a.cta-button:hover{background-color:#2F8B41;transform:translateY(-1px)}.dark #content a.cta-button{background-color:#6CFF93;color:#0A0A0A!important}.dark #content a.cta-button:hover{background-color:#8CFFAB}html[lang=\"ar\"] #content a.cta-button::after{content:\"↖\"}[id^=\"body-\"] [data-component-part=\"field-meta-post\"]{background-color:#FCEDB8!important;color:#D66A1E!important}.dark [id^=\"body-\"] [data-component-part=\"field-meta-post\"]{background-color:rgba(252, 237, 184, 0.12)!important;color:#FCEDB8!important}"},{"filePath":"swagger/swagger-ui.css","href":"/_mintlify/custom/tabby-26277sa/d667d337050182ff/swagger/swagger-ui.css"}],"page":{"pagePath":"api-reference/dispute-webhooks/retrieve-all-dispute-webhooks","slug":"/api-reference/dispute-webhooks/retrieve-all-dispute-webhooks","pageMetadata":{"openapi":"get /api/v1/dispute-webhooks","title":"Retrieve all dispute webhooks","description":"Retrieves all dispute webhooks registered for the merchant. Returns an empty array when none are registered.","href":"/api-reference/dispute-webhooks/retrieve-all-dispute-webhooks"},"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: \"Retrieves all dispute webhooks registered for the merchant. Returns an empty array when none are registered.\"\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":{"codeStyling":"dark","config":{},"pageMetadata":{"openapi":"get /api/v1/dispute-webhooks","title":"Retrieve all dispute webhooks","description":"Retrieves all dispute webhooks registered for the merchant. Returns an empty array when none are registered.","href":"/api-reference/dispute-webhooks/retrieve-all-dispute-webhooks"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":["/_mintlify/custom/tabby-26277sa/9f2b5ecdf0f199ba/eslint.config.js","/_mintlify/custom/tabby-26277sa/b26a86079cee90e6/next.config.js","/_mintlify/custom/tabby-26277sa/b8a8460aa1a4fa11/swagger/swagger-ui-bundle.js","/_mintlify/custom/tabby-26277sa/19a31c3b1620a182/swagger/swagger-ui-standalone-preset.js","/_mintlify/custom/tabby-26277sa/316fd6bc989c58f1/swagger/swagger-ui.js"],"openApiReferenceData":{"operation":{"tags":["Dispute webhooks"],"summary":"Retrieve all dispute webhooks","description":"Retrieves all dispute webhooks registered for the merchant. Returns an empty array when none are registered.","operationId":"getDisputeWebhooks","security":["064fb699-19ab-47ef-804b-103fa8ca7194"],"parameters":["a95b143d-9b91-4df0-b070-2d152bc6b868"],"responses":{"200":"a198d3c1-4301-466f-9606-fb741faa2abb","400":"d533c50f-52ed-4da0-8664-4c050d7eaa4d","401":"9270cc15-00df-4e08-92c4-0e017176e1cf","403":"43f74299-e44a-4994-984a-65d4110e7b2a","500":"6a8f0400-4ef9-49a1-b545-f9a8863312ab"},"method":"get","type":"path","servers":["79887fef-14f6-4a88-8eae-b1e55bd163f7","913cd608-ead8-4428-b886-826d8bc556e9"],"path":"/api/v1/dispute-webhooks","baseUrlOptions":["https://api.tabby.ai/","https://api.tabby.sa/"],"title":"Retrieve all dispute webhooks","codeSamples":[],"requestExampleLanguages":["bash","python","javascript","php","go","java","ruby"],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated","prefillPlaygroundWithExample":true,"prefillPlaygroundExamples":[]},"dependencies":{"parameters":{"a95b143d-9b91-4df0-b070-2d152bc6b868":{"in":"header","name":"X-Merchant-Code","required":true,"schema":{"type":"string","example":"code provided to you from Tabby side","isRequired":true,"description":"Merchant code the request is scoped to. Required on every dispute-webhook request, even when your secret key maps to a single merchant; case-insensitive.","uniqueKey":"","typeLabel":"string"},"description":"Merchant code the request is scoped to. Required on every dispute-webhook request, even when your secret key maps to a single merchant; case-insensitive."}},"responses":{"a198d3c1-4301-466f-9606-fb741faa2abb":{"description":"Success. Array of dispute webhooks; an empty array when none are registered.","content":{"application/json":{"schema":{"type":"array","description":"All dispute webhooks of the merchant. Empty array when none are registered.","items":{"type":"object","properties":{"id":{"type":"string","readOnly":true,"example":"f5eb7c26-b163-4fad-b75f-66024824116e","description":"Unique dispute webhook ID, assigned by Tabby.","isRequired":true,"uniqueKey":"items.[INDEX].id","typeLabel":"string"},"url":{"type":"string","format":"uri","example":"https://example.com/tabby/dispute-webhook","description":"Endpoint for dispute notifications, as stored (normalised).","isRequired":true,"uniqueKey":"items.[INDEX].url","typeLabel":"string\u003curi>"},"header":{"oneOf":[{"type":"object","description":"The signing header, if one was registered. `value` is masked.","properties":{"title":{"type":"string","example":"X-Auth-Key","uniqueKey":"items.[INDEX].header.oneOf.0.title","typeLabel":"string"},"value":{"type":"string","example":"****cret","description":"Masked — `****` followed by the last 4 characters of the stored value; `****` alone when the value has 8 characters or fewer.","uniqueKey":"items.[INDEX].header.oneOf.0.value","typeLabel":"string"}},"uniqueKey":"items.[INDEX].header.oneOf.0","typeLabel":"object"},{"type":"null","description":"The signing header, if one was registered. `value` is masked.","properties":{"title":{"type":"string","example":"X-Auth-Key"},"value":{"type":"string","example":"****cret","description":"Masked — `****` followed by the last 4 characters of the stored value; `****` alone when the value has 8 characters or fewer."}},"uniqueKey":"items.[INDEX].header.oneOf.1","typeLabel":"null"}],"uniqueKey":"items.[INDEX].header","typeLabel":"object | null"}},"required":["id","url"],"uniqueKey":"items.[INDEX]","typeLabel":"object"},"uniqueKey":"","typeLabel":"object[]"},"examples":{"Example":{"title":"Example","value":[{"id":"f5eb7c26-b163-4fad-b75f-66024824116e","url":"https://example.com/tabby/dispute-webhook","header":{"title":"X-Auth-Key","value":"****cret"}}]}},"exampleType":"generated"}},"exampleType":"generated"},"d533c50f-52ed-4da0-8664-4c050d7eaa4d":{"description":"One of the required fields is missing or request is not formatted correctly.","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"string","example":"error","uniqueKey":"status","typeLabel":"string"},"errorType":{"type":"string","example":"bad_data","uniqueKey":"errorType","typeLabel":"string"},"error":{"type":"string","example":"bad_request","uniqueKey":"error","typeLabel":"string"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"status":"error","errorType":"bad_data","error":"bad_request"}}},"exampleType":"generated"}},"exampleType":"generated"},"9270cc15-00df-4e08-92c4-0e017176e1cf":{"description":"The request cannot be authorized.","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"string","example":"error","uniqueKey":"status","typeLabel":"string"},"errorType":{"type":"string","example":"not_authorized","uniqueKey":"errorType","typeLabel":"string"},"error":{"type":"string","example":"invalid secret key","uniqueKey":"error","typeLabel":"string"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"status":"error","errorType":"not_authorized","error":"invalid secret key"}}},"exampleType":"generated"}},"exampleType":"generated"},"43f74299-e44a-4994-984a-65d4110e7b2a":{"description":"Disputes have no test mode — the request was authorized with a test secret key.","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"string","example":"error","uniqueKey":"status","typeLabel":"string"},"errorType":{"type":"string","example":"no_permission","uniqueKey":"errorType","typeLabel":"string"},"error":{"type":"string","example":"disputes have no test mode","uniqueKey":"error","typeLabel":"string"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"status":"error","errorType":"no_permission","error":"disputes have no test mode"}}},"exampleType":"generated"}},"exampleType":"generated"},"6a8f0400-4ef9-49a1-b545-f9a8863312ab":{"description":"Something bad happened. We're notified.","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"string","example":"error","uniqueKey":"status","typeLabel":"string"},"errorType":{"type":"string","example":"internal","uniqueKey":"errorType","typeLabel":"string"},"error":{"type":"string","example":"internal","uniqueKey":"error","typeLabel":"string"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"status":"error","errorType":"internal","error":"internal"}}},"exampleType":"generated"}},"exampleType":"generated"}},"security":{"064fb699-19ab-47ef-804b-103fa8ca7194":{"bearerAuth":{"type":"http","scheme":"bearer","description":"Bearer authentication header of the form `Bearer \u003csecret_key>`, where `\u003csecret_key>` is your `secret_key`.\n","scopes":["secret_key"],"schemeName":"bearerAuth"}}},"servers":{"79887fef-14f6-4a88-8eae-b1e55bd163f7":{"url":"https://api.tabby.ai/","description":"Production (UAE)"},"913cd608-ead8-4428-b886-826d8bc556e9":{"url":"https://api.tabby.sa/","description":"Production (KSA)"}},"processedSecurityOptions":[{"schemes":[{"scheme":{"type":"http","scheme":"bearer","description":"Bearer authentication header of the form `Bearer \u003csecret_key>`, where `\u003csecret_key>` is your `secret_key`.\n","scopes":["secret_key"],"schemeName":"bearerAuth"},"schema":{"title":"Bearer Auth","type":"string","isRequired":true,"description":"Bearer authentication header of the form `Bearer \u003csecret_key>`, where `\u003csecret_key>` is your `secret_key`.\n","format":"bearer","typeLabel":"string\u003cbearer>","deprecated":false},"schemeName":"bearerAuth","name":"Authorization"}],"title":"bearerAuth"}]},"originalFileLocation":"openapi.yaml"},"subdomain":"tabby-26277sa","siteName":"Tabby","title":"Retrieve all dispute webhooks - Tabby","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{"en":{"href":"/api-reference/dispute-webhooks/retrieve-all-dispute-webhooks","matchLevel":0},"ar":{"href":"/ar/marketing/toolkit","matchLevel":4}}},"lastModified":"2026-09-23T14:39:42.131Z","originalFileLocation":"api-reference/dispute-webhooks/retrieve-all-dispute-webhooks.mdx","locale":"en"},"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=\"light\"}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=\"Retrieves all dispute webhooks registered for the merchant. Returns an empty array when none are registered.\">\u003cmeta data-mint-head name=\"application-name\" content=\"Tabby\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/tabby-26277sa/w0O5YG5GGUzj-5B0/_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/tabby-26277sa/w0O5YG5GGUzj-5B0/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/tabby-26277sa/w0O5YG5GGUzj-5B0/_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/tabby-26277sa/w0O5YG5GGUzj-5B0/_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/tabby-26277sa/w0O5YG5GGUzj-5B0/_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/tabby-26277sa/w0O5YG5GGUzj-5B0/_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/tabby-26277sa/w0O5YG5GGUzj-5B0/_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/tabby-26277sa/w0O5YG5GGUzj-5B0/_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/tabby-26277sa/w0O5YG5GGUzj-5B0/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Retrieve all dispute webhooks - Tabby\">\u003cmeta data-mint-head property=\"og:description\" content=\"Retrieves all dispute webhooks registered for the merchant. Returns an empty array when none are registered.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Tabby\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.tabby.sa/api-reference/dispute-webhooks/retrieve-all-dispute-webhooks\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://tabby-26277sa.mintlify.site/_mintlify/api/og/v2?division=Dispute+Webhooks\u0026amp;title=Retrieve+all+dispute+webhooks\u0026amp;description=Retrieves+all+dispute+webhooks+registered+for+the+merchant.+Returns+an+empty+array+when+none+are+registered.\u0026amp;theme=4e6fe71b00c6800bb4092db9\u0026amp;signature=ae355160e087a5a97ee3619c0e76b584cd852a5509a900c226c965c78251bc83\">\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=\"Retrieve all dispute webhooks - Tabby\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Retrieves all dispute webhooks registered for the merchant. Returns an empty array when none are registered.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://tabby-26277sa.mintlify.site/_mintlify/api/og/v2?division=Dispute+Webhooks\u0026amp;title=Retrieve+all+dispute+webhooks\u0026amp;description=Retrieves+all+dispute+webhooks+registered+for+the+merchant.+Returns+an+empty+array+when+none+are+registered.\u0026amp;theme=4e6fe71b00c6800bb4092db9\u0026amp;signature=ae355160e087a5a97ee3619c0e76b584cd852a5509a900c226c965c78251bc83\">\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/tabby-26277sa/w0O5YG5GGUzj-5B0/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Tabby\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#41A854\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.tabby.sa/api-reference/dispute-webhooks/retrieve-all-dispute-webhooks\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/api-reference/dispute-webhooks/retrieve-all-dispute-webhooks.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.tabby.sa/#organization\",\"name\":\"Tabby\",\"url\":\"https://docs.tabby.sa\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/tabby-26277sa/VGR1VunycMFYW0gO/logo/tabby-badge.svg?fit=max\u0026auto=format\u0026n=VGR1VunycMFYW0gO\u0026q=85\u0026s=0fd2a3090f99185f666929e20a7504a4\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.tabby.sa#website\",\"name\":\"Tabby\",\"url\":\"https://docs.tabby.sa\",\"publisher\":{\"@id\":\"https://docs.tabby.sa/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.tabby.sa/api-reference/dispute-webhooks/retrieve-all-dispute-webhooks#webpage\",\"url\":\"https://docs.tabby.sa/api-reference/dispute-webhooks/retrieve-all-dispute-webhooks\",\"name\":\"Retrieve all dispute webhooks\",\"description\":\"Retrieves all dispute webhooks registered for the merchant. Returns an empty array when none are registered.\",\"dateModified\":\"2026-09-23T14:39:42.131Z\",\"isPartOf\":{\"@id\":\"https://docs.tabby.sa#website\"},\"breadcrumb\":{\"@id\":\"https://docs.tabby.sa/api-reference/dispute-webhooks/retrieve-all-dispute-webhooks#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.tabby.sa/api-reference/dispute-webhooks/retrieve-all-dispute-webhooks#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Dispute Webhooks\",\"item\":\"https://docs.tabby.sa/api-reference/dispute-webhooks/register-a-dispute-webhook\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Retrieve all dispute webhooks\",\"item\":\"https://docs.tabby.sa/api-reference/dispute-webhooks/retrieve-all-dispute-webhooks\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.tabby.sa/api-reference/dispute-webhooks/retrieve-all-dispute-webhooks#apireference\",\"headline\":\"Retrieve all dispute webhooks\",\"name\":\"Retrieve all dispute webhooks\",\"description\":\"Retrieves all dispute webhooks registered for the merchant. Returns an empty array when none are registered.\",\"url\":\"https://docs.tabby.sa/api-reference/dispute-webhooks/retrieve-all-dispute-webhooks\",\"mainEntityOfPage\":{\"@id\":\"https://docs.tabby.sa/api-reference/dispute-webhooks/retrieve-all-dispute-webhooks#webpage\"},\"dateModified\":\"2026-09-23T14:39:42.131Z\",\"publisher\":{\"@id\":\"https://docs.tabby.sa/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.tabby.sa#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Tabby\",\"creator\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","siteName":"Tabby","nav":{"global":null,"languages":[{"language":"en","default":true,"tabs":[{"tab":"Documentation","pages":[{"title":"Documentation","href":"/introduction/what-is-tabby"}]},{"tab":"API Playground","groups":[{"group":"API Playground","pages":[{"title":"API Reference Documentation","href":"/api-reference/overview"},{"title":"API Error Codes","sidebarTitle":"Error codes","href":"/api-reference/response-codes"}]},{"group":"Checkout","pages":[{"openapi":"post /api/v2/checkout","title":"Create a session","href":"/api-reference/checkout/create-a-session"},{"title":"Session creation payload model","href":"/api-reference/checkout/session-payload-model"}]},{"group":"Payments","pages":[{"openapi":"get /api/v2/payments/{id}","title":"Retrieve a payment","href":"/api-reference/payments/retrieve-a-payment"},{"openapi":"put /api/v2/payments/{id}","title":"Update a payment","href":"/api-reference/payments/update-a-payment"},{"openapi":"post /api/v2/payments/{id}/captures","title":"Capture a payment","href":"/api-reference/payments/capture-a-payment"},{"openapi":"post /api/v2/payments/{id}/refunds","title":"Refund a payment","href":"/api-reference/payments/refund-a-payment"},{"openapi":"post /api/v2/payments/{id}/close","title":"Close a payment","href":"/api-reference/payments/close-a-payment"},{"openapi":"get /api/v2/payments","title":"List of all payments","href":"/api-reference/payments/list-of-all-payments"}]},{"group":"Webhooks","pages":[{"openapi":"post /api/v1/webhooks","title":"Register a webhook","href":"/api-reference/webhooks/register-a-webhook"},{"openapi":"get /api/v1/webhooks","title":"Retrieve all webhooks","href":"/api-reference/webhooks/retrieve-all-webhooks"},{"openapi":"get /api/v1/webhooks/{id}","title":"Retrieve a webhook","href":"/api-reference/webhooks/retrieve-a-webhook"},{"openapi":"put /api/v1/webhooks/{id}","title":"Update a webhook","href":"/api-reference/webhooks/update-a-webhook"},{"openapi":"delete /api/v1/webhooks/{id}","title":"Remove a webhook","href":"/api-reference/webhooks/remove-a-webhook"}]},{"group":"Dispute Webhooks","pages":[{"openapi":"post /api/v1/dispute-webhooks","title":"Register a dispute webhook","description":"Registers a dispute webhook for the merchant identified by the secret key and the\n`X-Merchant-Code` header. Disputes have no test mode: authorize with a production\nsecret key (`sk_...`) — a request signed with a test key (`sk_test_...`) is rejected\nwith `403`. Each `merchant_code` can have up to 4 dispute webhooks; the limit is\nseparate from payment webhooks. The `url` is normalised before it is stored\n(lower-case scheme and host, default port and trailing slash removed) and must be\nunique per merchant. `header.value` is a secret: it is accepted in full and returned\nmasked in every response, including this one — `****` followed by the last 4 characters\nfor values longer than 8 characters, `****` alone for shorter values.\n","href":"/api-reference/dispute-webhooks/register-a-dispute-webhook"},{"openapi":"get /api/v1/dispute-webhooks","title":"Retrieve all dispute webhooks","href":"/api-reference/dispute-webhooks/retrieve-all-dispute-webhooks"},{"openapi":"get /api/v1/dispute-webhooks/{id}","title":"Retrieve a dispute webhook","description":"Retrieves the specified dispute webhook. `header.value` is returned masked.","href":"/api-reference/dispute-webhooks/retrieve-a-dispute-webhook"},{"openapi":"put /api/v1/dispute-webhooks/{id}","title":"Update a dispute webhook","href":"/api-reference/dispute-webhooks/update-a-dispute-webhook"},{"openapi":"delete /api/v1/dispute-webhooks/{id}","title":"Remove a dispute webhook","href":"/api-reference/dispute-webhooks/remove-a-dispute-webhook"}]},{"group":"Disputes","pages":[{"openapi":"get /api/v1/disputes","title":"Get disputes list","href":"/api-reference/disputes/get-disputes-list"},{"openapi":"get /api/v1/disputes/{disputeId}","title":"Get dispute by id","href":"/api-reference/disputes/get-dispute-by-id"},{"openapi":"post /api/v1/disputes/{disputeId}/provide-evidence","title":"Provide evidence for a dispute","href":"/api-reference/disputes/provide-evidence"},{"openapi":"post /api/v1/disputes/approve","title":"Approve disputes","href":"/api-reference/disputes/approve-disputes"},{"openapi":"post /api/v1/disputes/challenge","title":"Challenge disputes","href":"/api-reference/disputes/challenge-disputes"},{"openapi":"post /api/v1/disputes/attachments/upload","title":"Upload attachment","href":"/api-reference/disputes/upload-attachment"}]}]},{"tab":"Marketing Toolkit","pages":[{"title":"Marketing Toolkit","href":"/marketing/toolkit"}]}]},{"language":"ar","pages":[{"title":"ar","href":"/ar/marketing/toolkit"}]}]},"basePath":"","title":"Retrieve all dispute webhooks - Tabby","buildId":"dpl_8LJbrAiZvr1K98WQNZXCyY5AvT34","deploymentId":"dpl_8LJbrAiZvr1K98WQNZXCyY5AvT34","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-i2a3QZ8E.js","utils-ChLwp8m0.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-DRktVTDc.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-CA2pEs4T.js","snippetPresets-ClQ6XrKD.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","ApiExamples-Ct_Lv36y.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-Cn2PYw9e.js","shallow-rkyymjXQ.js","getApiPlaygroundDisplay-BB9vkXtE.js","CodeSnippet-Bm5RU7m1.js","CodeSnippets-BgU9Deuz.js","Page-BUDYNlhG.js","getPastedJson-BD-6NNum.js","icon-8Z6tud2e.js","MethodPill-Tuzr4g3V.js","DuplicateIcon-0ceWFYhN.js","createIcon-FBXow_ST.js","DynamicMarkdown-CD8713Yy.js","SectionHeading-7zgzQbH-.js","axios-vUo_bRtp.js","Markdown-D7Ofw1oz.js","clsx-eKJ4rcii.js","lib-DuNMoZ05.js","lib-B8HbPgcC.js","html-void-elements-mCSPHezU.js","dist-CwjSCXIK.js","katex-YMM-FMeD.js","marked.esm-CZWythHk.js","AssistantPageLink-9EK5IAXV.js"]}