Files a dispute against a cleared card transaction. Card, cardholder, and currency are derived from the transaction. Status changes arrive as CARD_DISPUTE_STATUS_UPDATED.
Selects the subproject the request operates on; only accepted with a parent project credential.
Idempotency-Key
string
required
Unique key for safely retrying this request. Up to 255 characters; we recommend a UUIDv4. The first request executes and its response is cached; subsequent requests with the same key replay the cached response (24h retention).
File a dispute against a cleared card transaction.
transactionId
string<uuid>
required
The card transaction being disputed
reason
enum<string>
required
Why the cardholder is disputing the transaction
Available options:
FRAUD_EMV_LIABILITY_SHIFT_COUNTERFEIT,
FRAUD_EMV_LIABILITY_SHIFT_NON_COUNTERFEIT,
FRAUD_OTHER_CARD_PRESENT,
FRAUD_OTHER_CARD_ABSENT,
FRAUD_VISA_MONITORING_PROGRAM,
AUTHORIZATION_CARD_RECOVERY_BULLETIN,
AUTHORIZATION_DECLINED,
AUTHORIZATION_NO_AUTH_LATE_PRESENTMENT,
PROCESSING_ERROR_INCORRECT_TRANSACTION_CODE,
PROCESSING_ERROR_INCORRECT_CURRENCY,
PROCESSING_ERROR_INCORRECT_ACCOUNT_NUMBER,
PROCESSING_ERROR_INCORRECT_AMOUNT,
PROCESSING_ERROR_DUPLICATE_PROCESSING,
PROCESSING_ERROR_INVALID_DATA,
CONSUMER_MERCHANDISE_NOT_RECEIVED,
CONSUMER_CANCELLED_RECURRING,
CONSUMER_NOT_AS_DESCRIBED,
CONSUMER_COUNTERFEIT_MERCHANDISE,
CONSUMER_MISREPRESENTATION,
CONSUMER_CREDIT_NOT_PROCESSED,
CONSUMER_CANCELLED_MERCHANDISE,
CONSUMER_ORIGINAL_CREDIT_NOT_ACCEPTED,
CONSUMER_NON_RECEIPT_CASH_ATM
Example:
"FRAUD_EMV_LIABILITY_SHIFT_COUNTERFEIT"
amount
number
Cardholder amount under dispute in the billing currency, including FX and ATM fees. Defaults to the full cleared cardholder amount, and may not exceed it.
Examples:
100.5
1234.99
contactEmail
string<email>
Address that receives the dispute outcome. Defaults to the cardholder email on file.
Response
Card dispute resource
id
string<uuid>
required
Unique dispute identifier
transactionId
string<uuid>
required
The card transaction being disputed
cardId
string<uuid>
required
Card used for the disputed transaction
status
enum<string>
required
Current dispute status
Available options:
RECEIVED,
REVIEWING,
SUBMITTED,
WON,
LOST,
REFUNDED,
DECLINED,
CANCELED
Example:
"RECEIVED"
reason
enum<string>
required
Why the cardholder is disputing the transaction
Available options:
FRAUD_EMV_LIABILITY_SHIFT_COUNTERFEIT,
FRAUD_EMV_LIABILITY_SHIFT_NON_COUNTERFEIT,
FRAUD_OTHER_CARD_PRESENT,
FRAUD_OTHER_CARD_ABSENT,
FRAUD_VISA_MONITORING_PROGRAM,
AUTHORIZATION_CARD_RECOVERY_BULLETIN,
AUTHORIZATION_DECLINED,
AUTHORIZATION_NO_AUTH_LATE_PRESENTMENT,
PROCESSING_ERROR_INCORRECT_TRANSACTION_CODE,
PROCESSING_ERROR_INCORRECT_CURRENCY,
PROCESSING_ERROR_INCORRECT_ACCOUNT_NUMBER,
PROCESSING_ERROR_INCORRECT_AMOUNT,
PROCESSING_ERROR_DUPLICATE_PROCESSING,
PROCESSING_ERROR_INVALID_DATA,
CONSUMER_MERCHANDISE_NOT_RECEIVED,
CONSUMER_CANCELLED_RECURRING,
CONSUMER_NOT_AS_DESCRIBED,
CONSUMER_COUNTERFEIT_MERCHANDISE,
CONSUMER_MISREPRESENTATION,
CONSUMER_CREDIT_NOT_PROCESSED,
CONSUMER_CANCELLED_MERCHANDISE,
CONSUMER_ORIGINAL_CREDIT_NOT_ACCEPTED,
CONSUMER_NON_RECEIPT_CASH_ATM
Example:
"FRAUD_EMV_LIABILITY_SHIFT_COUNTERFEIT"
category
enum<string>
required
The grouping the reason belongs to
Available options:
FRAUD,
AUTHORIZATION,
PROCESSING_ERROR,
CONSUMER
Example:
"FRAUD"
amount
object
required
The cardholder amount under dispute, including FX and ATM fees. May be less than the transaction total.
Show child attributes
refundedAmount
CardDisputeRefundedAmount · object | null
required
Amount credited to the cardholder when the dispute reaches REFUNDED. Includes the network refund plus a prorated FX markup and ATM variable fee. Does not include the per-withdrawal ATM fixed fee, which stays charged. Null until REFUNDED. May be less than the disputed amount. The same credit is recorded as a DISPUTE_REFUND event on the disputed card transaction and delivered in CARD_TRANSACTION_UPDATED; apply balance changes from that event, not from this field.
Show child attributes
cardholder
object
required
Cardholder identity on the case
Show child attributes
resolvedAt
string<date-time> | null
required
When the dispute reached a final status, or null while open
createdAt
string<date-time>
required
ISO 8601 timestamp of creation
updatedAt
string<date-time>
required
ISO 8601 timestamp of last update
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Reap API","description":"Modular fintech infrastructure. Cards, wallets, compliance, and payments via a single API.","colors":{"primary":"#71F7EC","light":"#8FFAF1","dark":"#5BCAC1"},"logo":"https://mintcdn.com/reap-e846d803/qWb4Fwzl8MZcgNPH/images/logo.svg?fit=max\u0026auto=format\u0026n=qWb4Fwzl8MZcgNPH\u0026q=85\u0026s=3b6f4b8d92a46cdc1cbc12bbdab8f23f","favicon":"https://mintcdn.com/reap-e846d803/qWb4Fwzl8MZcgNPH/images/favicon.svg?fit=max\u0026auto=format\u0026n=qWb4Fwzl8MZcgNPH\u0026q=85\u0026s=b5150aaaf3b337b38c7514bf68cb2f30","api":{"playground":{"display":"interactive"},"examples":{"languages":["bash","javascript","python"]}},"appearance":{"default":"dark","strict":true},"background":{"color":{"light":"#FFFFFF","dark":"#0C0E0D"}},"footer":{},"fonts":{"family":"Satoshi","weight":500,"source":"fonts/satoshi-variable.woff2","format":"woff2"},"icons":{"library":"tabler"},"contextual":{"options":["copy","view","cursor","claude"],"display":"header"},"styling":{"latex":false},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"reap-e846d803","hasAudioNarration":false,"actualSubdomain":"reap-e846d803","customDomains":["docs.reap.global"],"gitSource":{"type":"github","owner":"reaphq","repo":"reap-api","deployBranch":"main","contentDirectory":"docs","isPrivate":true,"mountPath":"","label":""},"entitlements":{"AI_CHAT":{"status":"ENABLED"},"WEB_MCP":{"status":"ENABLED"},"NARRATION":{"status":"ENABLED"}},"buildId":"6afefba3c788418988bb697a","clientVersion":"0.0.4271","searchFilterCounts":[{"language":"default","tag":"API Reference","count":142},{"language":"default","tag":"Documentation","count":72},{"language":"default","tag":"Cards","count":35},{"language":"default","tag":"Webhooks","count":29},{"language":"default","tag":"Event Types","count":19},{"language":"default","tag":"Notifications","count":18},{"language":"default","tag":"Agentic","count":18},{"language":"default","tag":"Transactions","count":13},{"language":"default","tag":"Companies","count":13},{"language":"default","tag":"Simulation","count":13}]},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":false,"enableAskAiSearchBar":true},"basePath":"","hasChatPermissions":true,"hasWebMcpPermissions":true,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-rbac-roles","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":"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":"site-roles","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"full-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-dual-write","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"approve-review-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-metadata","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"sso-setup-deadline-banner","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-serve","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"live-agents","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"starter-pricing","enabled":true,"variant":{"name":"treatment","enabled":true,"payload":{"type":"string","value":"treatment"},"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"wildcard-email-auth","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[{"filePath":"style.css","content":":root{--method-get-bg: rgba(0, 202, 127, 0.12);--method-get-fg: #00945c;--method-post-bg: rgba(255, 198, 128, 0.18);--method-post-fg: #9e6e13;--method-put-bg: rgba(79, 70, 229, 0.12);--method-put-fg: #4338ca;--method-patch-bg: rgba(79, 70, 229, 0.12);--method-patch-fg: #4338ca;--method-delete-bg: rgba(248, 113, 113, 0.18);--method-delete-fg: #b91c1c;--method-rare-bg: rgba(99, 112, 106, 0.14);--method-rare-fg: #4b5752;--method-hook-bg: rgba(113, 247, 236, 0.16);--method-hook-fg: #0d9488}html.dark,.dark{--method-get-bg: rgba(138, 255, 191, 0.14);--method-get-fg: #afffd1;--method-post-bg: rgba(254, 210, 163, 0.14);--method-post-fg: #fee0c4;--method-put-bg: rgba(129, 140, 248, 0.14);--method-put-fg: #a5b4fc;--method-patch-bg: rgba(129, 140, 248, 0.14);--method-patch-fg: #a5b4fc;--method-delete-bg: rgba(248, 113, 113, 0.14);--method-delete-fg: #fca5a5;--method-rare-bg: rgba(175, 188, 182, 0.16);--method-rare-fg: #cbd7d2;--method-hook-bg: rgba(113, 247, 236, 0.12);--method-hook-fg: #99f6e4}.method-nav-pill [class*=\"bg-green-\"],.method-nav-pill [class*=\"bg-emerald-\"],.method-pill[class*=\"bg-green-\"],.method-pill[class*=\"bg-emerald-\"]{background-color:var(--method-get-bg)!important;color:var(--method-get-fg)!important}.method-nav-pill [class*=\"bg-blue-\"],.method-pill[class*=\"bg-blue-\"]{background-color:var(--method-post-bg)!important;color:var(--method-post-fg)!important}.method-nav-pill [class*=\"bg-yellow-\"],.method-nav-pill [class*=\"bg-amber-\"],.method-pill[class*=\"bg-yellow-\"],.method-pill[class*=\"bg-amber-\"]{background-color:var(--method-put-bg)!important;color:var(--method-put-fg)!important}.method-nav-pill [class*=\"bg-violet-\"],.method-nav-pill [class*=\"bg-purple-\"],.method-pill[class*=\"bg-violet-\"],.method-pill[class*=\"bg-purple-\"]{background-color:var(--method-patch-bg)!important;color:var(--method-patch-fg)!important}.method-nav-pill [class*=\"bg-red-\"],.method-pill[class*=\"bg-red-\"]{background-color:var(--method-delete-bg)!important;color:var(--method-delete-fg)!important}.method-nav-pill [class*=\"bg-gray-\"],.method-nav-pill [class*=\"bg-slate-\"],.method-pill[class*=\"bg-gray-\"],.method-pill[class*=\"bg-slate-\"]{background-color:var(--method-rare-bg)!important;color:var(--method-rare-fg)!important}.method-nav-pill [class*=\"#2AB673\"i],.method-pill[class*=\"#2AB673\"i],.method-pill [class*=\"#2AB673\"i]{background-color:var(--method-get-bg)!important;color:var(--method-get-fg)!important;text-shadow:none!important}.method-nav-pill [class*=\"#C28C30\"i],.method-pill[class*=\"#C28C30\"i],.method-pill [class*=\"#C28C30\"i]{background-color:var(--method-put-bg)!important;color:var(--method-put-fg)!important;text-shadow:none!important}.method-nav-pill [class*=\"#DA622B\"i],.method-pill[class*=\"#DA622B\"i],.method-pill [class*=\"#DA622B\"i]{background-color:var(--method-patch-bg)!important;color:var(--method-patch-fg)!important;text-shadow:none!important}.method-nav-pill [class*=\"#CB3A32\"i],.method-pill[class*=\"#CB3A32\"i],.method-pill [class*=\"#CB3A32\"i]{background-color:var(--method-delete-bg)!important;color:var(--method-delete-fg)!important;text-shadow:none!important}.method-nav-pill [data-method],.method-pill[data-method],.method-pill [data-method]{background-color:var(--method-rare-bg)!important;color:var(--method-rare-fg)!important;text-shadow:none!important}.method-nav-pill [data-method=\"GET\"],.method-pill[data-method=\"GET\"],.method-pill [data-method=\"GET\"]{background-color:var(--method-get-bg)!important;color:var(--method-get-fg)!important;text-shadow:none!important}.method-nav-pill [data-method=\"POST\"],.method-pill[data-method=\"POST\"],.method-pill [data-method=\"POST\"]{background-color:var(--method-post-bg)!important;color:var(--method-post-fg)!important;text-shadow:none!important}.method-nav-pill [data-method=\"PUT\"],.method-pill[data-method=\"PUT\"],.method-pill [data-method=\"PUT\"]{background-color:var(--method-put-bg)!important;color:var(--method-put-fg)!important;text-shadow:none!important}.method-nav-pill [data-method=\"PATCH\"],.method-pill[data-method=\"PATCH\"],.method-pill [data-method=\"PATCH\"]{background-color:var(--method-patch-bg)!important;color:var(--method-patch-fg)!important;text-shadow:none!important}.method-nav-pill [data-method=\"DELETE\"],.method-pill[data-method=\"DELETE\"],.method-pill [data-method=\"DELETE\"]{background-color:var(--method-delete-bg)!important;color:var(--method-delete-fg)!important;text-shadow:none!important}.method-nav-pill [data-method=\"HEAD\"],.method-pill[data-method=\"HEAD\"],.method-pill [data-method=\"HEAD\"],.method-nav-pill [data-method=\"OPTIONS\"],.method-pill[data-method=\"OPTIONS\"],.method-pill [data-method=\"OPTIONS\"],.method-nav-pill [data-method=\"TRACE\"],.method-pill[data-method=\"TRACE\"],.method-pill [data-method=\"TRACE\"],.method-nav-pill [data-method=\"CONNECT\"],.method-pill[data-method=\"CONNECT\"],.method-pill [data-method=\"CONNECT\"]{background-color:var(--method-rare-bg)!important;color:var(--method-rare-fg)!important;text-shadow:none!important}.method-nav-pill [data-method=\"HOOK\"],.method-pill[data-method=\"HOOK\"],.method-pill [data-method=\"HOOK\"]{background-color:var(--method-hook-bg)!important;color:var(--method-hook-fg)!important;text-shadow:none!important}:root{--scrollbar-thumb: rgba(15, 23, 42, 0.18);--scrollbar-thumb-hover: rgba(15, 23, 42, 0.32)}html.dark,.dark{--scrollbar-thumb: rgba(255, 255, 255, 0.12);--scrollbar-thumb-hover: rgba(255, 255, 255, 0.24)}@supports (scrollbar-width: thin){#sidebar-content{scrollbar-width:thin;scrollbar-color:var(--scrollbar-thumb) transparent}}@supports selector(::-webkit-scrollbar){#sidebar-content::-webkit-scrollbar{width:6px;height:6px}#sidebar-content::-webkit-scrollbar-track,#sidebar-content::-webkit-scrollbar-corner{background:transparent}#sidebar-content::-webkit-scrollbar-thumb{background-color:var(--scrollbar-thumb);border-radius:9999px;border:1px solid transparent;background-clip:padding-box;min-height:24px}#sidebar-content::-webkit-scrollbar-button{display:none;width:0;height:0}}@media (hover: hover){#sidebar-content::-webkit-scrollbar-thumb:hover{background-color:var(--scrollbar-thumb-hover)}}@media print{#sidebar-content{scrollbar-width:auto;scrollbar-color:auto}}html.dark #content-area,html.dark #content,.dark #content-area,.dark #content{--tw-prose-body: rgb(var(--gray-300));color:rgb(var(--gray-300))}div:has(>[data-component-part=\"update-label\"]) a[href^=\"#\"]{display:none}[data-component-part=\"update-label\"]{cursor:default}[data-component-part=\"update-content\"] [data-as=\"p\"],[data-component-part=\"update-content\"] p,[data-component-part=\"update-content\"] li{font-size:16px}[data-component-part=\"update-content\"] li a{font-size:16px}"}]}
{"page":{"pagePath":"api-reference/disputes/file-dispute","slug":"/api-reference/disputes/file-dispute","pageMetadata":{"title":"File dispute","description":"Files a dispute against a cleared card transaction. Card, cardholder, and currency are derived from the transaction. Status changes arrive as `CARD_DISPUTE_STATUS_UPDATED`.","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /disputes/","href":"/api-reference/disputes/file-dispute","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 code: \"code\",\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsxs(_components.p, {\n children: [\"Files a dispute against a cleared card transaction. Card, cardholder, and currency are derived from the transaction. Status changes arrive as \", _jsx(_components.code, {\n children: \"CARD_DISPUTE_STATUS_UPDATED\"\n }), \".\"]\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{jsx:_jsx,jsxs:_jsxs}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){const _components={a:`a`,..._provideComponents(),...props.components},{Badge}=_components;if(!Badge)_missingMdxReference(`Badge`,true);return _jsxs(`div`,{className:`not-prose mint-text-sm mint-text-gray-500 dark:mint-text-gray-400`,children:[`Required scope: `,_jsx(_components.a,{href:`/api-reference/scopes`,children:_jsx(Badge,{color:`blue`,stroke:true,size:`sm`,children:`DISPUTES_WRITE`})})]})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent};function _missingMdxReference(id,component){throw new Error(`Expected `+(component?`component`:`object`)+\" `\"+id+\"` to be defined: you likely forgot to import, pass, or provide it.\")}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"File dispute","description":"Files a dispute against a cleared card transaction. Card, cardholder, and currency are derived from the transaction. Status changes arrive as `CARD_DISPUTE_STATUS_UPDATED`.","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /disputes/","href":"/api-reference/disputes/file-dispute","autogeneratedByOpenApi":true}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":["/_mintlify/custom/reap-e846d803/bc4b7e82ee9b6e77/method-pills.js"],"dynamicCss":".mint-text-sm {\n font-size: 0.875rem;\n line-height: 1.25rem\n}\n.mint-text-gray-500 {\n --tw-text-opacity: 1;\n color: rgb(107 114 128 / var(--tw-text-opacity, 1))\n}\n.dark\\:mint-text-gray-400:is(.dark *) {\n --tw-text-opacity: 1;\n color: rgb(156 163 175 / var(--tw-text-opacity, 1))\n}","openApiReferenceData":{"operation":{"tags":["Disputes"],"description":"Files a dispute against a cleared card transaction. Card, cardholder, and currency are derived from the transaction. Status changes arrive as `CARD_DISPUTE_STATUS_UPDATED`.","operationId":"file_disputes","summary":"File dispute","x-required-scope":"DISPUTES_WRITE","parameters":["1eeb01af-2a29-4066-a3dd-80fe43ae954a","28f7ae58-34c4-43a3-a6b0-59cd5d154917","4a8a9470-a2b8-4d0d-b7f8-314ca0bb7166"],"requestBody":"563d2fdb-a945-424b-ad99-30d3c84a8f91","responses":{"200":"3dd4916a-da84-4290-a5a6-e40640bac5bc","400":"169a771b-df6c-4f69-839b-b8f390d7489d","404":"0117fc17-74f9-4100-9c4f-c8f8e44e9e40","409":"48814b37-f664-4f3f-8a58-01bb1eb45f22","422":"7b65282b-ab92-437d-91fc-8effb0448fd2"},"x-mint":{"content":"\u003cdiv className=\"not-prose text-sm text-gray-500 dark:text-gray-400\">Required scope: \u003ca href=\"/api-reference/scopes\">\u003cBadge color=\"blue\" stroke size=\"sm\">DISPUTES_WRITE\u003c/Badge>\u003c/a>\u003c/div>"},"method":"post","type":"path","servers":["e6ddacc3-d691-4034-aceb-742020b96b43","358f9c74-88d8-4adb-b418-6395954dded8","30aefb40-d5ed-468d-850f-c86237d38bab","e6f4cde8-cc99-4f7e-bad4-2d5c6c350c71","2c586304-99ba-4319-ade3-f41b116de250","facce34c-70c2-43d3-ac58-5de3a201a4b5"],"security":["b543e64b-6203-43be-a5df-717454936d41"],"path":"/disputes/","baseUrlOptions":["https://sg.sandbox.api.reap.global","https://sg.prod.api.reap.global","https://mx.sandbox.api.reap.global","https://mx.prod.api.reap.global","https://sandbox.api.reap.global","https://prod.api.reap.global"],"title":"File dispute","codeSamples":[],"requestExampleLanguages":["bash","javascript","python"],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{"1eeb01af-2a29-4066-a3dd-80fe43ae954a":{"name":"Reap-Version","in":"header","required":true,"schema":{"type":"string","enum":["2025-02-14"],"description":"API version (YYYY-MM-DD)","example":"2025-02-14","isRequired":true,"uniqueKey":"","typeLabel":"enum\u003cstring>"}},"28f7ae58-34c4-43a3-a6b0-59cd5d154917":{"name":"Reap-Subproject-Id","in":"header","required":false,"schema":{"description":"Selects the subproject the request operates on; only accepted with a parent project credential.","type":"string","format":"uuid","isRequired":false,"uniqueKey":"","typeLabel":"string\u003cuuid>"}},"4a8a9470-a2b8-4d0d-b7f8-314ca0bb7166":{"name":"Idempotency-Key","in":"header","required":true,"schema":{"type":"string","minLength":1,"maxLength":255,"description":"Unique key for safely retrying this request. Up to 255 characters; we recommend a UUIDv4. The first request executes and its response is cached; subsequent requests with the same key replay the cached response (24h retention).","isRequired":true,"uniqueKey":"","typeLabel":"string"}}},"requestBody":{"description":"File a dispute against a cleared card transaction.","required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"transactionId":{"type":"string","format":"uuid","description":"The card transaction being disputed","isRequired":true,"uniqueKey":"transactionId","typeLabel":"string\u003cuuid>"},"reason":{"type":"string","enum":["FRAUD_EMV_LIABILITY_SHIFT_COUNTERFEIT","FRAUD_EMV_LIABILITY_SHIFT_NON_COUNTERFEIT","FRAUD_OTHER_CARD_PRESENT","FRAUD_OTHER_CARD_ABSENT","FRAUD_VISA_MONITORING_PROGRAM","AUTHORIZATION_CARD_RECOVERY_BULLETIN","AUTHORIZATION_DECLINED","AUTHORIZATION_NO_AUTH_LATE_PRESENTMENT","PROCESSING_ERROR_INCORRECT_TRANSACTION_CODE","PROCESSING_ERROR_INCORRECT_CURRENCY","PROCESSING_ERROR_INCORRECT_ACCOUNT_NUMBER","PROCESSING_ERROR_INCORRECT_AMOUNT","PROCESSING_ERROR_DUPLICATE_PROCESSING","PROCESSING_ERROR_INVALID_DATA","CONSUMER_MERCHANDISE_NOT_RECEIVED","CONSUMER_CANCELLED_RECURRING","CONSUMER_NOT_AS_DESCRIBED","CONSUMER_COUNTERFEIT_MERCHANDISE","CONSUMER_MISREPRESENTATION","CONSUMER_CREDIT_NOT_PROCESSED","CONSUMER_CANCELLED_MERCHANDISE","CONSUMER_ORIGINAL_CREDIT_NOT_ACCEPTED","CONSUMER_NON_RECEIPT_CASH_ATM"],"description":"Why the cardholder is disputing the transaction","example":"FRAUD_EMV_LIABILITY_SHIFT_COUNTERFEIT","isRequired":true,"uniqueKey":"reason","typeLabel":"enum\u003cstring>"},"amount":{"description":"Cardholder amount under dispute in the billing currency, including FX and ATM fees. Defaults to the full cleared cardholder amount, and may not exceed it.","type":"number","exclusiveMinimum":0,"examples":[100.5,1234.99],"uniqueKey":"amount","typeLabel":"number"},"contactEmail":{"description":"Address that receives the dispute outcome. Defaults to the cardholder email on file.","type":"string","format":"email","uniqueKey":"contactEmail","typeLabel":"string\u003cemail>"}},"required":["transactionId","reason"],"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"transactionId":"3c90c3cc-0d44-4b50-8888-8dd25736052a","reason":"FRAUD_EMV_LIABILITY_SHIFT_COUNTERFEIT","amount":100.5,"contactEmail":"jsmith@example.com"}}},"exampleType":"generated"},"application/x-www-form-urlencoded":{"schema":{"type":"object","properties":{"transactionId":{"type":"string","format":"uuid","description":"The card transaction being disputed","isRequired":true,"uniqueKey":"transactionId","typeLabel":"string\u003cuuid>"},"reason":{"type":"string","enum":["FRAUD_EMV_LIABILITY_SHIFT_COUNTERFEIT","FRAUD_EMV_LIABILITY_SHIFT_NON_COUNTERFEIT","FRAUD_OTHER_CARD_PRESENT","FRAUD_OTHER_CARD_ABSENT","FRAUD_VISA_MONITORING_PROGRAM","AUTHORIZATION_CARD_RECOVERY_BULLETIN","AUTHORIZATION_DECLINED","AUTHORIZATION_NO_AUTH_LATE_PRESENTMENT","PROCESSING_ERROR_INCORRECT_TRANSACTION_CODE","PROCESSING_ERROR_INCORRECT_CURRENCY","PROCESSING_ERROR_INCORRECT_ACCOUNT_NUMBER","PROCESSING_ERROR_INCORRECT_AMOUNT","PROCESSING_ERROR_DUPLICATE_PROCESSING","PROCESSING_ERROR_INVALID_DATA","CONSUMER_MERCHANDISE_NOT_RECEIVED","CONSUMER_CANCELLED_RECURRING","CONSUMER_NOT_AS_DESCRIBED","CONSUMER_COUNTERFEIT_MERCHANDISE","CONSUMER_MISREPRESENTATION","CONSUMER_CREDIT_NOT_PROCESSED","CONSUMER_CANCELLED_MERCHANDISE","CONSUMER_ORIGINAL_CREDIT_NOT_ACCEPTED","CONSUMER_NON_RECEIPT_CASH_ATM"],"description":"Why the cardholder is disputing the transaction","example":"FRAUD_EMV_LIABILITY_SHIFT_COUNTERFEIT","isRequired":true,"uniqueKey":"reason","typeLabel":"enum\u003cstring>"},"amount":{"description":"Cardholder amount under dispute in the billing currency, including FX and ATM fees. Defaults to the full cleared cardholder amount, and may not exceed it.","type":"number","exclusiveMinimum":0,"examples":[100.5,1234.99],"uniqueKey":"amount","typeLabel":"number"},"contactEmail":{"description":"Address that receives the dispute outcome. Defaults to the cardholder email on file.","type":"string","format":"email","uniqueKey":"contactEmail","typeLabel":"string\u003cemail>"}},"required":["transactionId","reason"],"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"transactionId":"3c90c3cc-0d44-4b50-8888-8dd25736052a","reason":"FRAUD_EMV_LIABILITY_SHIFT_COUNTERFEIT","amount":100.5,"contactEmail":"jsmith@example.com"}}},"exampleType":"generated"},"multipart/form-data":{"schema":{"type":"object","properties":{"transactionId":{"type":"string","format":"uuid","description":"The card transaction being disputed","isRequired":true,"uniqueKey":"transactionId","typeLabel":"string\u003cuuid>"},"reason":{"type":"string","enum":["FRAUD_EMV_LIABILITY_SHIFT_COUNTERFEIT","FRAUD_EMV_LIABILITY_SHIFT_NON_COUNTERFEIT","FRAUD_OTHER_CARD_PRESENT","FRAUD_OTHER_CARD_ABSENT","FRAUD_VISA_MONITORING_PROGRAM","AUTHORIZATION_CARD_RECOVERY_BULLETIN","AUTHORIZATION_DECLINED","AUTHORIZATION_NO_AUTH_LATE_PRESENTMENT","PROCESSING_ERROR_INCORRECT_TRANSACTION_CODE","PROCESSING_ERROR_INCORRECT_CURRENCY","PROCESSING_ERROR_INCORRECT_ACCOUNT_NUMBER","PROCESSING_ERROR_INCORRECT_AMOUNT","PROCESSING_ERROR_DUPLICATE_PROCESSING","PROCESSING_ERROR_INVALID_DATA","CONSUMER_MERCHANDISE_NOT_RECEIVED","CONSUMER_CANCELLED_RECURRING","CONSUMER_NOT_AS_DESCRIBED","CONSUMER_COUNTERFEIT_MERCHANDISE","CONSUMER_MISREPRESENTATION","CONSUMER_CREDIT_NOT_PROCESSED","CONSUMER_CANCELLED_MERCHANDISE","CONSUMER_ORIGINAL_CREDIT_NOT_ACCEPTED","CONSUMER_NON_RECEIPT_CASH_ATM"],"description":"Why the cardholder is disputing the transaction","example":"FRAUD_EMV_LIABILITY_SHIFT_COUNTERFEIT","isRequired":true,"uniqueKey":"reason","typeLabel":"enum\u003cstring>"},"amount":{"description":"Cardholder amount under dispute in the billing currency, including FX and ATM fees. Defaults to the full cleared cardholder amount, and may not exceed it.","type":"number","exclusiveMinimum":0,"examples":[100.5,1234.99],"uniqueKey":"amount","typeLabel":"number"},"contactEmail":{"description":"Address that receives the dispute outcome. Defaults to the cardholder email on file.","type":"string","format":"email","uniqueKey":"contactEmail","typeLabel":"string\u003cemail>"}},"required":["transactionId","reason"],"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"transactionId":"3c90c3cc-0d44-4b50-8888-8dd25736052a","reason":"FRAUD_EMV_LIABILITY_SHIFT_COUNTERFEIT","amount":100.5,"contactEmail":"jsmith@example.com"}}},"exampleType":"generated"}},"exampleType":"generated"},"responses":{"3dd4916a-da84-4290-a5a6-e40640bac5bc":{"description":"Card dispute resource","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","format":"uuid","description":"Unique dispute identifier","isRequired":true,"uniqueKey":"id","typeLabel":"string\u003cuuid>"},"transactionId":{"type":"string","format":"uuid","description":"The card transaction being disputed","isRequired":true,"uniqueKey":"transactionId","typeLabel":"string\u003cuuid>"},"cardId":{"type":"string","format":"uuid","description":"Card used for the disputed transaction","isRequired":true,"uniqueKey":"cardId","typeLabel":"string\u003cuuid>"},"status":{"type":"string","enum":["RECEIVED","REVIEWING","SUBMITTED","WON","LOST","REFUNDED","DECLINED","CANCELED"],"description":"Current dispute status","example":"RECEIVED","isRequired":true,"uniqueKey":"status","typeLabel":"enum\u003cstring>"},"reason":{"type":"string","enum":["FRAUD_EMV_LIABILITY_SHIFT_COUNTERFEIT","FRAUD_EMV_LIABILITY_SHIFT_NON_COUNTERFEIT","FRAUD_OTHER_CARD_PRESENT","FRAUD_OTHER_CARD_ABSENT","FRAUD_VISA_MONITORING_PROGRAM","AUTHORIZATION_CARD_RECOVERY_BULLETIN","AUTHORIZATION_DECLINED","AUTHORIZATION_NO_AUTH_LATE_PRESENTMENT","PROCESSING_ERROR_INCORRECT_TRANSACTION_CODE","PROCESSING_ERROR_INCORRECT_CURRENCY","PROCESSING_ERROR_INCORRECT_ACCOUNT_NUMBER","PROCESSING_ERROR_INCORRECT_AMOUNT","PROCESSING_ERROR_DUPLICATE_PROCESSING","PROCESSING_ERROR_INVALID_DATA","CONSUMER_MERCHANDISE_NOT_RECEIVED","CONSUMER_CANCELLED_RECURRING","CONSUMER_NOT_AS_DESCRIBED","CONSUMER_COUNTERFEIT_MERCHANDISE","CONSUMER_MISREPRESENTATION","CONSUMER_CREDIT_NOT_PROCESSED","CONSUMER_CANCELLED_MERCHANDISE","CONSUMER_ORIGINAL_CREDIT_NOT_ACCEPTED","CONSUMER_NON_RECEIPT_CASH_ATM"],"description":"Why the cardholder is disputing the transaction","example":"FRAUD_EMV_LIABILITY_SHIFT_COUNTERFEIT","isRequired":true,"uniqueKey":"reason","typeLabel":"enum\u003cstring>"},"category":{"type":"string","enum":["FRAUD","AUTHORIZATION","PROCESSING_ERROR","CONSUMER"],"description":"The grouping the reason belongs to","example":"FRAUD","isRequired":true,"uniqueKey":"category","typeLabel":"enum\u003cstring>"},"amount":{"type":"object","properties":{"value":{"type":"number","exclusiveMinimum":0,"examples":[100.5,1234.99],"description":"Disputed amount","isRequired":true,"uniqueKey":"amount.value","typeLabel":"number"},"currency":{"description":"Currency of the disputed amount","type":"string","pattern":"^[A-Z]{3}$","isRequired":true,"uniqueKey":"amount.currency","typeLabel":"string"}},"required":["value","currency"],"description":"The cardholder amount under dispute, including FX and ATM fees. May be less than the transaction total.","isRequired":true,"uniqueKey":"amount","typeLabel":"object"},"refundedAmount":{"oneOf":[{"type":"object","title":"CardDisputeRefundedAmount","description":"Amount credited to the cardholder when the dispute reaches REFUNDED. Includes the network refund plus a prorated FX markup and ATM variable fee. Does not include the per-withdrawal ATM fixed fee, which stays charged. Null until REFUNDED. May be less than the disputed amount. The same credit is recorded as a DISPUTE_REFUND event on the disputed card transaction and delivered in CARD_TRANSACTION_UPDATED; apply balance changes from that event, not from this field.","required":["value","currency"],"properties":{"value":{"type":"number","exclusiveMinimum":0,"examples":[100.5,1234.99],"description":"Amount credited to the cardholder","isRequired":true,"uniqueKey":"refundedAmount.oneOf.0.value","typeLabel":"number"},"currency":{"description":"Currency of the refunded amount","type":"string","pattern":"^[A-Z]{3}$","isRequired":true,"uniqueKey":"refundedAmount.oneOf.0.currency","typeLabel":"string"}},"isRequired":true,"uniqueKey":"refundedAmount.oneOf.0","typeLabel":"CardDisputeRefundedAmount · object"},{"type":"null","isRequired":true,"uniqueKey":"refundedAmount.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"refundedAmount","typeLabel":"CardDisputeRefundedAmount · object | null"},"cardholder":{"type":"object","properties":{"name":{"type":"string","description":"Cardholder name on the case","isRequired":true,"uniqueKey":"cardholder.name","typeLabel":"string"},"email":{"type":"string","format":"email","description":"Cardholder email on the case","isRequired":true,"uniqueKey":"cardholder.email","typeLabel":"string\u003cemail>"},"contactEmail":{"type":"string","format":"email","description":"Address that receives the dispute outcome","isRequired":true,"uniqueKey":"cardholder.contactEmail","typeLabel":"string\u003cemail>"}},"required":["name","email","contactEmail"],"description":"Cardholder identity on the case","isRequired":true,"uniqueKey":"cardholder","typeLabel":"object"},"resolvedAt":{"oneOf":[{"type":"string","description":"When the dispute reached a final status, or null while open","format":"date-time","isRequired":true,"uniqueKey":"resolvedAt.oneOf.0","typeLabel":"string\u003cdate-time>"},{"type":"null","description":"When the dispute reached a final status, or null while open","isRequired":true,"uniqueKey":"resolvedAt.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"resolvedAt","typeLabel":"string\u003cdate-time> | null"},"createdAt":{"type":"string","format":"date-time","description":"ISO 8601 timestamp of creation","isRequired":true,"uniqueKey":"createdAt","typeLabel":"string\u003cdate-time>"},"updatedAt":{"type":"string","format":"date-time","description":"ISO 8601 timestamp of last update","isRequired":true,"uniqueKey":"updatedAt","typeLabel":"string\u003cdate-time>"}},"required":["id","transactionId","cardId","status","reason","category","amount","refundedAmount","cardholder","resolvedAt","createdAt","updatedAt"],"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"id":"3c90c3cc-0d44-4b50-8888-8dd25736052a","transactionId":"3c90c3cc-0d44-4b50-8888-8dd25736052a","cardId":"3c90c3cc-0d44-4b50-8888-8dd25736052a","status":"RECEIVED","reason":"FRAUD_EMV_LIABILITY_SHIFT_COUNTERFEIT","category":"FRAUD","amount":{"value":100.5,"currency":"\u003cstring>"},"refundedAmount":{"value":100.5,"currency":"\u003cstring>"},"cardholder":{"name":"\u003cstring>","email":"jsmith@example.com","contactEmail":"jsmith@example.com"},"resolvedAt":"2023-11-07T05:31:56Z","createdAt":"2023-11-07T05:31:56Z","updatedAt":"2023-11-07T05:31:56Z"}}},"exampleType":"generated"}},"exampleType":"generated"},"169a771b-df6c-4f69-839b-b8f390d7489d":{"description":"Dispute filing is not available for this transaction. It was created by an older sandbox simulation; please try again with a new transaction","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","const":"CARD_DISPUTE_NOT_SUPPORTED_FOR_SIMULATED_TRANSACTION","isRequired":true,"uniqueKey":"error.code","typeLabel":"string"},"message":{"type":"string","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"},"detail":{"oneOf":[{"type":"object","additionalProperties":{"oneOf":[{}],"uniqueKey":"error.detail.oneOf.0.additionalProperties","typeLabel":"any"},"isRequired":true,"uniqueKey":"error.detail.oneOf.0","typeLabel":"object"},{"type":"null","isRequired":true,"uniqueKey":"error.detail.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"error.detail","typeLabel":"object | null"}},"required":["code","message","detail"],"isRequired":true,"uniqueKey":"error","typeLabel":"object"}},"required":["error"],"title":"CardDisputeNotSupportedForSimulatedTransactionError","uniqueKey":"","typeLabel":"CardDisputeNotSupportedForSimulatedTransactionError · object"},"examples":{"Example":{"title":"Example","value":{"error":{"code":"CARD_DISPUTE_NOT_SUPPORTED_FOR_SIMULATED_TRANSACTION","message":"\u003cstring>","detail":{}}}}},"exampleType":"generated"}},"exampleType":"generated"},"0117fc17-74f9-4100-9c4f-c8f8e44e9e40":{"description":"Card transaction not found","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","const":"CARD_DISPUTE_TRANSACTION_NOT_FOUND","isRequired":true,"uniqueKey":"error.code","typeLabel":"string"},"message":{"type":"string","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"},"detail":{"oneOf":[{"type":"object","additionalProperties":{"oneOf":[{}],"uniqueKey":"error.detail.oneOf.0.additionalProperties","typeLabel":"any"},"isRequired":true,"uniqueKey":"error.detail.oneOf.0","typeLabel":"object"},{"type":"null","isRequired":true,"uniqueKey":"error.detail.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"error.detail","typeLabel":"object | null"}},"required":["code","message","detail"],"isRequired":true,"uniqueKey":"error","typeLabel":"object"}},"required":["error"],"title":"CardDisputeTransactionNotFoundError","uniqueKey":"","typeLabel":"CardDisputeTransactionNotFoundError · object"},"examples":{"Example":{"title":"Example","value":{"error":{"code":"CARD_DISPUTE_TRANSACTION_NOT_FOUND","message":"\u003cstring>","detail":{}}}}},"exampleType":"generated"}},"exampleType":"generated"},"48814b37-f664-4f3f-8a58-01bb1eb45f22":{"description":"An active card dispute already exists for this transaction","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","const":"CARD_DISPUTE_ALREADY_EXISTS","isRequired":true,"uniqueKey":"error.code","typeLabel":"string"},"message":{"type":"string","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"},"detail":{"oneOf":[{"type":"object","additionalProperties":{"oneOf":[{}],"uniqueKey":"error.detail.oneOf.0.additionalProperties","typeLabel":"any"},"isRequired":true,"uniqueKey":"error.detail.oneOf.0","typeLabel":"object"},{"type":"null","isRequired":true,"uniqueKey":"error.detail.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"error.detail","typeLabel":"object | null"}},"required":["code","message","detail"],"isRequired":true,"uniqueKey":"error","typeLabel":"object"}},"required":["error"],"title":"CardDisputeAlreadyExistsError","uniqueKey":"","typeLabel":"CardDisputeAlreadyExistsError · object"},"examples":{"Example":{"title":"Example","value":{"error":{"code":"CARD_DISPUTE_ALREADY_EXISTS","message":"\u003cstring>","detail":{}}}}},"exampleType":"generated"}},"exampleType":"generated"},"7b65282b-ab92-437d-91fc-8effb0448fd2":{"description":"Response for status 422","content":{"application/json":{"schema":{"oneOf":[{"type":"object","title":"CardDisputeTransactionNotClearedError","description":"Transaction is not cleared and cannot be disputed","required":["error"],"properties":{"error":{"type":"object","properties":{"code":{"type":"string","const":"CARD_DISPUTE_TRANSACTION_NOT_CLEARED","isRequired":true,"uniqueKey":"oneOf.0.error.code","typeLabel":"string"},"message":{"type":"string","isRequired":true,"uniqueKey":"oneOf.0.error.message","typeLabel":"string"},"detail":{"oneOf":[{"type":"object","additionalProperties":{"oneOf":[{}],"uniqueKey":"oneOf.0.error.detail.oneOf.0.additionalProperties","typeLabel":"any"},"isRequired":true,"uniqueKey":"oneOf.0.error.detail.oneOf.0","typeLabel":"object"},{"type":"null","isRequired":true,"uniqueKey":"oneOf.0.error.detail.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"oneOf.0.error.detail","typeLabel":"object | null"}},"required":["code","message","detail"],"isRequired":true,"uniqueKey":"oneOf.0.error","typeLabel":"object"}},"uniqueKey":"oneOf.0","typeLabel":"CardDisputeTransactionNotClearedError · object"},{"type":"object","title":"CardDisputeFilingWindowExpiredError","description":"Dispute filing window has expired","required":["error"],"properties":{"error":{"type":"object","properties":{"code":{"type":"string","const":"CARD_DISPUTE_FILING_WINDOW_EXPIRED","isRequired":true,"uniqueKey":"oneOf.1.error.code","typeLabel":"string"},"message":{"type":"string","isRequired":true,"uniqueKey":"oneOf.1.error.message","typeLabel":"string"},"detail":{"oneOf":[{"type":"object","additionalProperties":{"oneOf":[{}],"uniqueKey":"oneOf.1.error.detail.oneOf.0.additionalProperties","typeLabel":"any"},"isRequired":true,"uniqueKey":"oneOf.1.error.detail.oneOf.0","typeLabel":"object"},{"type":"null","isRequired":true,"uniqueKey":"oneOf.1.error.detail.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"oneOf.1.error.detail","typeLabel":"object | null"}},"required":["code","message","detail"],"isRequired":true,"uniqueKey":"oneOf.1.error","typeLabel":"object"}},"uniqueKey":"oneOf.1","typeLabel":"CardDisputeFilingWindowExpiredError · object"},{"type":"object","title":"CardDisputeAmountInvalidError","description":"Dispute amount must be positive and at most the transaction amount","required":["error"],"properties":{"error":{"type":"object","properties":{"code":{"type":"string","const":"CARD_DISPUTE_AMOUNT_INVALID","isRequired":true,"uniqueKey":"oneOf.2.error.code","typeLabel":"string"},"message":{"type":"string","isRequired":true,"uniqueKey":"oneOf.2.error.message","typeLabel":"string"},"detail":{"oneOf":[{"type":"object","additionalProperties":{"oneOf":[{}],"uniqueKey":"oneOf.2.error.detail.oneOf.0.additionalProperties","typeLabel":"any"},"isRequired":true,"uniqueKey":"oneOf.2.error.detail.oneOf.0","typeLabel":"object"},{"type":"null","isRequired":true,"uniqueKey":"oneOf.2.error.detail.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"oneOf.2.error.detail","typeLabel":"object | null"}},"required":["code","message","detail"],"isRequired":true,"uniqueKey":"oneOf.2.error","typeLabel":"object"}},"uniqueKey":"oneOf.2","typeLabel":"CardDisputeAmountInvalidError · object"}],"uniqueKey":"","typeLabel":"CardDisputeTransactionNotClearedError · object | CardDisputeFilingWindowExpiredError · object | CardDisputeAmountInvalidError · object"},"examples":{"Example":{"title":"Example","value":{"error":{"code":"CARD_DISPUTE_TRANSACTION_NOT_CLEARED","message":"\u003cstring>","detail":{}}}}},"exampleType":"generated"}},"exampleType":"generated"}},"security":{"b543e64b-6203-43be-a5df-717454936d41":{"bearerAuth":{"type":"http","scheme":"bearer","description":"API key as Bearer token","scopes":[],"schemeName":"bearerAuth"}}},"servers":{"e6ddacc3-d691-4034-aceb-742020b96b43":{"url":"https://sg.sandbox.api.reap.global","description":"Singapore sandbox"},"358f9c74-88d8-4adb-b418-6395954dded8":{"url":"https://sg.prod.api.reap.global","description":"Singapore production"},"30aefb40-d5ed-468d-850f-c86237d38bab":{"url":"https://mx.sandbox.api.reap.global","description":"Mexico sandbox"},"e6f4cde8-cc99-4f7e-bad4-2d5c6c350c71":{"url":"https://mx.prod.api.reap.global","description":"Mexico production"},"2c586304-99ba-4319-ade3-f41b116de250":{"url":"https://sandbox.api.reap.global","description":"Singapore sandbox (alias)"},"facce34c-70c2-43d3-ac58-5de3a201a4b5":{"url":"https://prod.api.reap.global","description":"Singapore production (alias)"}},"processedSecurityOptions":[{"schemes":[{"scheme":{"type":"http","scheme":"bearer","description":"API key as Bearer token","scopes":[],"schemeName":"bearerAuth"},"schema":{"title":"Bearer Auth","type":"string","isRequired":true,"description":"API key as Bearer token","format":"bearer","typeLabel":"string\u003cbearer>","deprecated":false},"schemeName":"bearerAuth","name":"Authorization"}],"title":"bearerAuth"}]},"originalFileLocation":"api-reference/openapi.json"},"subdomain":"reap-e846d803","siteName":"Reap API","title":"File dispute - Reap API","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-11-18T09:41:00.554Z","originalFileLocation":"api-reference/disputes/file-dispute.mdx"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=\"dark\";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=\"Files a dispute against a cleared card transaction. Card, cardholder, and currency are derived from the transaction. Status changes arrive as CARD_DISPUTE_STATUS_UPDATED.\">\u003cmeta data-mint-head name=\"application-name\" content=\"Reap API\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/reap-e846d803/pZr3r14v7CymLz6W/_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/reap-e846d803/pZr3r14v7CymLz6W/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/reap-e846d803/pZr3r14v7CymLz6W/_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/reap-e846d803/pZr3r14v7CymLz6W/_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/reap-e846d803/pZr3r14v7CymLz6W/_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/reap-e846d803/pZr3r14v7CymLz6W/_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/reap-e846d803/pZr3r14v7CymLz6W/_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/reap-e846d803/pZr3r14v7CymLz6W/_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/reap-e846d803/pZr3r14v7CymLz6W/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"File dispute - Reap API\">\u003cmeta data-mint-head property=\"og:description\" content=\"Files a dispute against a cleared card transaction. Card, cardholder, and currency are derived from the transaction. Status changes arrive as CARD_DISPUTE_STATUS_UPDATED.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Reap API\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.reap.global/api-reference/disputes/file-dispute\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://reap-e846d803.mintlify.site/_mintlify/api/og/v2?division=Disputes\u0026amp;title=File+dispute\u0026amp;description=Files+a+dispute+against+a+cleared+card+transaction.+Card%2C+cardholder%2C+and+currency+are+derived+from+the+transaction.+Status+changes+arrive+as+%60CARD_DISPUTE_STAT\u0026amp;theme=0653a246ece6a02c222d7cb8\u0026amp;signature=152fe4d498f297d07c0ef460f020e9ec8e96c5ff2a9b8ee5b8227b112880ac57\">\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=\"File dispute - Reap API\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Files a dispute against a cleared card transaction. Card, cardholder, and currency are derived from the transaction. Status changes arrive as CARD_DISPUTE_STATUS_UPDATED.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://reap-e846d803.mintlify.site/_mintlify/api/og/v2?division=Disputes\u0026amp;title=File+dispute\u0026amp;description=Files+a+dispute+against+a+cleared+card+transaction.+Card%2C+cardholder%2C+and+currency+are+derived+from+the+transaction.+Status+changes+arrive+as+%60CARD_DISPUTE_STAT\u0026amp;theme=0653a246ece6a02c222d7cb8\u0026amp;signature=152fe4d498f297d07c0ef460f020e9ec8e96c5ff2a9b8ee5b8227b112880ac57\">\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/reap-e846d803/pZr3r14v7CymLz6W/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Reap API\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#71F7EC\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.reap.global/api-reference/disputes/file-dispute\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/api-reference/disputes/file-dispute.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.reap.global/#organization\",\"name\":\"Reap API\",\"url\":\"https://docs.reap.global\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/reap-e846d803/qWb4Fwzl8MZcgNPH/images/logo.svg?fit=max\u0026auto=format\u0026n=qWb4Fwzl8MZcgNPH\u0026q=85\u0026s=3b6f4b8d92a46cdc1cbc12bbdab8f23f\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.reap.global#website\",\"name\":\"Reap API\",\"url\":\"https://docs.reap.global\",\"publisher\":{\"@id\":\"https://docs.reap.global/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.reap.global/api-reference/disputes/file-dispute#webpage\",\"url\":\"https://docs.reap.global/api-reference/disputes/file-dispute\",\"name\":\"File dispute\",\"description\":\"Files a dispute against a cleared card transaction. Card, cardholder, and currency are derived from the transaction. Status changes arrive as CARD_DISPUTE_STATUS_UPDATED.\",\"dateModified\":\"2026-11-18T09:41:00.554Z\",\"isPartOf\":{\"@id\":\"https://docs.reap.global#website\"},\"breadcrumb\":{\"@id\":\"https://docs.reap.global/api-reference/disputes/file-dispute#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.reap.global/api-reference/disputes/file-dispute#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Disputes\",\"item\":\"https://docs.reap.global/api-reference/disputes/list-disputes\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"File dispute\",\"item\":\"https://docs.reap.global/api-reference/disputes/file-dispute\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.reap.global/api-reference/disputes/file-dispute#apireference\",\"headline\":\"File dispute\",\"name\":\"File dispute\",\"description\":\"Files a dispute against a cleared card transaction. Card, cardholder, and currency are derived from the transaction. Status changes arrive as CARD_DISPUTE_STATUS_UPDATED.\",\"url\":\"https://docs.reap.global/api-reference/disputes/file-dispute\",\"mainEntityOfPage\":{\"@id\":\"https://docs.reap.global/api-reference/disputes/file-dispute#webpage\"},\"dateModified\":\"2026-11-18T09:41:00.554Z\",\"publisher\":{\"@id\":\"https://docs.reap.global/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.reap.global#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Reap API\",\"publisher\":{\"@type\":\"Organization\",\"name\":\"Reap API\"},\"provider\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","agentPointerHref":"/api-reference/disputes/file-dispute.md","siteName":"Reap API","nav":{"global":null,"tabs":[{"tab":"Documentation","icon":"book-2","pages":[{"title":"Documentation","href":""}]},{"tab":"API Reference","icon":"terminal-2","groups":[{"group":"Setup","pages":[{"title":"Overview","href":"/api-reference/overview"},{"title":"Authentication","href":"/api-reference/authentication"},{"title":"Scopes","href":"/api-reference/scopes"},{"title":"Versioning \u0026 Compatibility","href":"/api-reference/versioning"},{"title":"Errors","href":"/api-reference/errors"},{"title":"Rate Limiting","href":"/api-reference/rate-limiting"},{"title":"Idempotency","href":"/api-reference/idempotency"}]},{"group":"Users","pages":[{"title":"List users","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /users/","href":"/api-reference/users/list-users"},{"title":"Create user","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /users/","href":"/api-reference/users/create-user"},{"title":"Get user","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /users/{id}","href":"/api-reference/users/get-user"},{"title":"Delete user","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json delete /users/{id}","href":"/api-reference/users/delete-user"},{"title":"Update user phone","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json put /users/{id}/phone","href":"/api-reference/users/update-user-phone"},{"title":"Update user email","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json put /users/{id}/email","href":"/api-reference/users/update-user-email"},{"title":"Advance the user application","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /users/{id}/application","href":"/api-reference/users/advance-the-user-application"},{"title":"Upload application documents","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /users/{id}/application/documents","href":"/api-reference/users/upload-application-documents"}]},{"group":"Companies","pages":[{"title":"List companies","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /companies/","href":"/api-reference/companies/list-companies"},{"title":"Create company","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /companies/","href":"/api-reference/companies/create-company"},{"title":"Get company","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /companies/{id}","href":"/api-reference/companies/get-company"},{"title":"List company applications","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /companies/{id}/applications/","href":"/api-reference/companies/list-company-applications"},{"title":"Advance company application","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /companies/{id}/applications/","href":"/api-reference/companies/advance-company-application"},{"title":"Upload application documents","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /companies/{id}/applications/documents","href":"/api-reference/companies/upload-application-documents"},{"title":"Submit company application","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /companies/{id}/applications/submit","href":"/api-reference/companies/submit-company-application"},{"title":"Get company application","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /companies/{id}/applications/{applicationId}","href":"/api-reference/companies/get-company-application"},{"title":"List related persons","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /companies/{id}/related-persons/","href":"/api-reference/companies/list-related-persons"},{"title":"Get related person","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /companies/{id}/related-persons/{personId}","href":"/api-reference/companies/get-related-person"},{"title":"Upload related person documents","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /companies/{id}/related-persons/{personId}/documents","href":"/api-reference/companies/upload-related-person-documents"},{"title":"List related person applications","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /companies/{id}/related-person-applications/","href":"/api-reference/companies/list-related-person-applications"},{"title":"Get related person application","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /companies/{id}/related-person-applications/{applicationId}","href":"/api-reference/companies/get-related-person-application"}]},{"group":"Accounts","pages":[{"title":"List accounts","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /accounts/","href":"/api-reference/accounts/list-accounts"},{"title":"Create account","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /accounts/","href":"/api-reference/accounts/create-account"},{"title":"Generate signer message","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /accounts/auth-message","href":"/api-reference/accounts/generate-signer-message"},{"title":"Get account","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /accounts/{id}","href":"/api-reference/accounts/get-account"},{"title":"Get account balance","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /accounts/{id}/balance","href":"/api-reference/accounts/get-account-balance"},{"title":"Get account assets","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /accounts/{id}/assets","href":"/api-reference/accounts/get-account-assets"}]},{"group":"Virtual Asset Postings","pages":[{"title":"Create posting","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /postings/","href":"/api-reference/virtual-asset-postings/create-posting"},{"title":"Get posting","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /postings/{postingId}","href":"/api-reference/virtual-asset-postings/get-posting"}]},{"group":"Cards","pages":[{"title":"List cards","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /cards/","href":"/api-reference/cards/list-cards"},{"title":"Create card","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /cards/","href":"/api-reference/cards/create-card"},{"title":"Get card","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /cards/{id}","href":"/api-reference/cards/get-card"},{"title":"Delete card","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json delete /cards/{id}","href":"/api-reference/cards/delete-card"},{"title":"Update card PIN","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json put /cards/{id}/pin","href":"/api-reference/cards/update-card-pin"},{"title":"Freeze card","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /cards/{id}/freeze","href":"/api-reference/cards/freeze-card"},{"title":"Unfreeze card","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /cards/{id}/unfreeze","href":"/api-reference/cards/unfreeze-card"},{"title":"Block card","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /cards/{id}/block","href":"/api-reference/cards/block-card"},{"title":"Unblock card","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /cards/{id}/unblock","href":"/api-reference/cards/unblock-card"},{"title":"Reveal card details","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /cards/{id}/reveal","href":"/api-reference/cards/reveal-card-details"},{"title":"Reveal PAN","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /cards/{id}/reveal-pan","href":"/api-reference/cards/reveal-pan"},{"title":"Update 3DS challenge method","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json put /cards/{id}/3ds-challenge-method","href":"/api-reference/cards/update-3ds-challenge-method"},{"title":"Activate physical card","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /cards/{id}/activate","href":"/api-reference/cards/activate-physical-card"},{"title":"Get activation code","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /cards/{id}/activation-code","href":"/api-reference/cards/get-activation-code"},{"title":"Push-provision card","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /cards/{id}/push-provisioning","href":"/api-reference/cards/push-provision-card"},{"title":"Respond to 3DS challenge","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /card-3ds-challenges/{challengeId}/respond","href":"/api-reference/cards/respond-to-3ds-challenge"},{"title":"Get 3DS challenge","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /card-3ds-challenges/{challengeId}","href":"/api-reference/cards/get-3ds-challenge"}]},{"group":"Card Shipments","pages":[{"title":"List shipments","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /card-shipments/","href":"/api-reference/card-shipments/list-shipments"},{"title":"Create shipment draft","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /card-shipments/","href":"/api-reference/card-shipments/create-shipment-draft"},{"title":"Get shipment","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /card-shipments/{id}","href":"/api-reference/card-shipments/get-shipment"},{"title":"Delete shipment draft","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json delete /card-shipments/{id}","href":"/api-reference/card-shipments/delete-shipment-draft"},{"title":"Update shipping details","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json patch /card-shipments/{id}","href":"/api-reference/card-shipments/update-shipping-details"},{"title":"Add card to draft","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /card-shipments/{id}/cards","href":"/api-reference/card-shipments/add-card-to-draft"},{"title":"Remove card from draft","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json delete /card-shipments/{id}/cards/{memberId}","href":"/api-reference/card-shipments/remove-card-from-draft"},{"title":"Submit shipment","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /card-shipments/{id}/submit","href":"/api-reference/card-shipments/submit-shipment"}]},{"group":"Card Designs","pages":[{"title":"List card designs","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /card-designs/","href":"/api-reference/card-designs/list-card-designs"},{"title":"Set default card design","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json put /card-designs/default","href":"/api-reference/card-designs/set-default-card-design"},{"title":"Get card design","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /card-designs/{id}","href":"/api-reference/card-designs/get-card-design"}]},{"group":"Crypto Deposits","pages":[{"title":"Get crypto deposit","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /crypto-deposits/{id}","href":"/api-reference/crypto-deposits/get-crypto-deposit"}]},{"group":"Crypto Withdrawals","pages":[{"title":"Initiate crypto withdrawal","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /crypto-withdrawals/","href":"/api-reference/crypto-withdrawals/initiate-crypto-withdrawal"},{"title":"Get crypto withdrawal","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /crypto-withdrawals/{id}","href":"/api-reference/crypto-withdrawals/get-crypto-withdrawal"},{"title":"Mint signing payload","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /crypto-withdrawals/{id}/payload","href":"/api-reference/crypto-withdrawals/mint-signing-payload"},{"title":"Submit withdrawal signature","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /crypto-withdrawals/{id}/sign","href":"/api-reference/crypto-withdrawals/submit-withdrawal-signature"},{"title":"Cancel crypto withdrawal","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /crypto-withdrawals/{id}/cancel","href":"/api-reference/crypto-withdrawals/cancel-crypto-withdrawal"}]},{"group":"Fiat Deposits","pages":[{"title":"Get bank details","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /fiat-deposits/bank-details","href":"/api-reference/fiat-deposits/get-bank-details"},{"title":"Get fiat deposit","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /fiat-deposits/{id}","href":"/api-reference/fiat-deposits/get-fiat-deposit"}]},{"group":"Statements","pages":[{"title":"List statements","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /statements/","href":"/api-reference/statements/list-statements"},{"title":"Request statement","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /statements/","href":"/api-reference/statements/request-statement"},{"title":"Get statement","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /statements/{id}","href":"/api-reference/statements/get-statement"},{"title":"Download statement","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /statements/{id}/download","href":"/api-reference/statements/download-statement"}]},{"group":"Card Transactions","pages":[{"title":"Get card transaction","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /card-transactions/{id}","href":"/api-reference/card-transactions/get-card-transaction"}]},{"group":"Fraud Alerts","pages":[{"title":"List alerts","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /fraud-alerts/","href":"/api-reference/fraud-alerts/list-alerts"},{"title":"Report fraud","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /fraud-alerts/","href":"/api-reference/fraud-alerts/report-fraud"},{"title":"Get alert","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /fraud-alerts/{id}","href":"/api-reference/fraud-alerts/get-alert"},{"title":"Respond to alert","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /fraud-alerts/{id}/respond","href":"/api-reference/fraud-alerts/respond-to-alert"}]},{"group":"Disputes","pages":[{"title":"List disputes","description":"Returns a paginated list of card disputes, newest first. Filter by status, reason, category, card, transaction, or filed time range. No status default is applied.","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /disputes/","href":"/api-reference/disputes/list-disputes"},{"title":"File dispute","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /disputes/","href":"/api-reference/disputes/file-dispute"},{"title":"Get dispute","description":"Retrieves a single card dispute by its unique identifier.","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /disputes/{id}","href":"/api-reference/disputes/get-dispute"}]},{"group":"Activities","pages":[{"title":"List activities","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /activities/","href":"/api-reference/activities/list-activities"}]},{"group":"Policies","pages":[{"title":"List policies","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /policies/","href":"/api-reference/policies/list-policies"},{"title":"Create policy","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /policies/","href":"/api-reference/policies/create-policy"},{"title":"List effective policies","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /policies/effective","href":"/api-reference/policies/list-effective-policies"},{"title":"Get policy","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /policies/{id}","href":"/api-reference/policies/get-policy"},{"title":"Rename policy","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json patch /policies/{id}","href":"/api-reference/policies/rename-policy"},{"title":"Replace policy configuration","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json put /policies/{id}/config","href":"/api-reference/policies/replace-policy-configuration"},{"title":"Enable policy","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /policies/{id}/enable","href":"/api-reference/policies/enable-policy"},{"title":"Disable policy","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /policies/{id}/disable","href":"/api-reference/policies/disable-policy"}]},{"group":"Fees","pages":[{"title":"List fees","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /fees/","href":"/api-reference/fees/list-fees"},{"title":"Create fee override","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /fees/","href":"/api-reference/fees/create-fee-override"},{"title":"List effective fees","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /fees/effective","href":"/api-reference/fees/list-effective-fees"},{"title":"Get fee","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /fees/{id}","href":"/api-reference/fees/get-fee"},{"title":"Update fee value","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json put /fees/{id}","href":"/api-reference/fees/update-fee-value"},{"title":"Delete fee override","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json delete /fees/{id}","href":"/api-reference/fees/delete-fee-override"}]},{"group":"Simulation","pages":[{"title":"Simulate user application status","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /simulation/users/{userId}/application","href":"/api-reference/simulation/simulate-user-application-status"},{"title":"Simulate company status","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /simulation/companies/{companyId}/status","href":"/api-reference/simulation/simulate-company-status"},{"title":"Reset company application","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /simulation/companies/{companyId}/reset","href":"/api-reference/simulation/reset-company-application"},{"title":"Simulate account status","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /simulation/accounts/{id}/status","href":"/api-reference/simulation/simulate-account-status"},{"title":"Simulate card status","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /simulation/cards/{id}/status","href":"/api-reference/simulation/simulate-card-status"},{"title":"Simulate shipment status","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /simulation/card-shipments/{id}/status","href":"/api-reference/simulation/simulate-shipment-status"},{"title":"Simulate authorization","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /simulation/card-transactions/authorization","href":"/api-reference/simulation/simulate-authorization"},{"title":"Simulate 3DS authorization","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /simulation/card-transactions/authorization-with-3ds","href":"/api-reference/simulation/simulate-3ds-authorization"},{"title":"Simulate decline","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /simulation/card-transactions/decline","href":"/api-reference/simulation/simulate-decline"},{"title":"Simulate clearing","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /simulation/card-transactions/clearing","href":"/api-reference/simulation/simulate-clearing"},{"title":"Simulate reversal","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /simulation/card-transactions/reversal","href":"/api-reference/simulation/simulate-reversal"},{"title":"Simulate refund","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /simulation/card-transactions/refund","href":"/api-reference/simulation/simulate-refund"},{"title":"Simulate a fiat deposit","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /simulation/fiat-deposits","href":"/api-reference/simulation/simulate-a-fiat-deposit"}]},{"group":"Virtual Assets","pages":[{"title":"List virtual assets","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /virtual-assets/","href":"/api-reference/virtual-assets/list-virtual-assets"},{"title":"Create virtual asset","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /virtual-assets/","href":"/api-reference/virtual-assets/create-virtual-asset"},{"title":"Get virtual asset","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /virtual-assets/{id}","href":"/api-reference/virtual-assets/get-virtual-asset"},{"title":"Update virtual asset","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json patch /virtual-assets/{id}","href":"/api-reference/virtual-assets/update-virtual-asset"},{"title":"Disable virtual asset","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /virtual-assets/{id}/disable","href":"/api-reference/virtual-assets/disable-virtual-asset"},{"title":"Set rate for virtual asset","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json put /virtual-assets/{id}/rate","href":"/api-reference/virtual-assets/set-rate-for-virtual-asset"}]},{"group":"Webhooks","pages":[{"title":"List webhook endpoints","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /webhooks/","href":"/api-reference/webhooks/list-webhook-endpoints"},{"title":"Create webhook endpoint","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /webhooks/","href":"/api-reference/webhooks/create-webhook-endpoint"},{"title":"Get webhook endpoint","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /webhooks/{id}","href":"/api-reference/webhooks/get-webhook-endpoint"},{"title":"Update webhook endpoint","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json patch /webhooks/{id}","href":"/api-reference/webhooks/update-webhook-endpoint"},{"title":"Rotate signing secret","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /webhooks/{id}/rotate-secret","href":"/api-reference/webhooks/rotate-signing-secret"},{"title":"Disable webhook endpoint","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /webhooks/{id}/disable","href":"/api-reference/webhooks/disable-webhook-endpoint"}]},{"group":"Agentic","pages":[{"title":"List enrollments","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /agentic/enrollments","href":"/api-reference/agentic/list-enrollments"},{"title":"Create enrollment","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /agentic/enrollments","href":"/api-reference/agentic/create-enrollment"},{"title":"Get enrollment","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /agentic/enrollments/{id}","href":"/api-reference/agentic/get-enrollment"},{"title":"Revoke enrollment","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /agentic/enrollments/{id}/revoke","href":"/api-reference/agentic/revoke-enrollment"},{"title":"List mandates","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /agentic/mandates","href":"/api-reference/agentic/list-mandates"},{"title":"Create mandate","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /agentic/mandates","href":"/api-reference/agentic/create-mandate"},{"title":"Get mandate","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /agentic/mandates/{id}","href":"/api-reference/agentic/get-mandate"},{"title":"Pause mandate","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /agentic/mandates/{id}/pause","href":"/api-reference/agentic/pause-mandate"},{"title":"Resume mandate","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /agentic/mandates/{id}/resume","href":"/api-reference/agentic/resume-mandate"},{"title":"Cancel mandate","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /agentic/mandates/{id}/cancel","href":"/api-reference/agentic/cancel-mandate"},{"title":"Search products","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /agentic/products/search","href":"/api-reference/agentic/search-products"},{"title":"Get product details","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /agentic/products/details","href":"/api-reference/agentic/get-product-details"},{"title":"Resolve variant","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /agentic/products/variant","href":"/api-reference/agentic/resolve-variant"},{"title":"Create quote","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /agentic/quotes","href":"/api-reference/agentic/create-quote"},{"title":"Get quote","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /agentic/quotes/{id}","href":"/api-reference/agentic/get-quote"},{"title":"Select shipping option","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /agentic/quotes/{id}/shipping-option","href":"/api-reference/agentic/select-shipping-option"},{"title":"Create checkout","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /agentic/checkouts","href":"/api-reference/agentic/create-checkout"},{"title":"Get checkout","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /agentic/checkouts/{id}","href":"/api-reference/agentic/get-checkout"}]}]},{"tab":"Webhooks","icon":"bell","pages":[{"title":"Webhooks","href":"/webhooks/overview"}]},{"tab":"Changelog","icon":"history","pages":[{"title":"Changelog","href":"/changelog"}]}]},"basePath":"","title":"File dispute - Reap API","deploymentId":"dpl_Em2U4NQQ2N2DE3HPbPUJVZLnAtvc","buildId":"dpl_Em2U4NQQ2N2DE3HPbPUJVZLnAtvc","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-_HcdDqS2.js","snippetPresets-CXnm-WO6.js","utils-Dg59J__o.js","style-to-object-BY3JEAdk.js","utils-D8TRpdk7.js","v4-DIgz8zy6.js","addUniqueKeysToSchema-B6QaxWc5.js","conditional-requirements-CFM0id0Q.js","cloneDeep-DeMZ-lcM.js","_Uint8Array-BjA2mcVW.js","isObject-FP1Yky1u.js","ApiExamples-cjPyMv63.js","usePlaygroundInputsStore-D7BWoaw4.js","shallow-Z1ceDNSG.js","isEqual-BObTuQrO.js","CodeSnippets-D1UZ1AE-.js","CodeSnippet-B373COAT.js","getApiPlaygroundDisplay-CfL-UuDS.js","Page-DuqezyvM.js","DynamicMarkdown-5yMTCLas.js","SectionHeading-BxT1HYfP.js","icon-DYJTTD3g.js","MethodPill-4AyycJeu.js","getPastedJson-Bp3WV6cN.js","Check2Icon-PhZu6Gry.js","axios-CsQoIw0U.js","Markdown-Dy9a8hT8.js","AssistantPageLink-87tSPwGm.js","dist-CXMB3QQU.js","lib-DMeTj1gb.js","lib-B8HbPgcC.js","katex-Dbtb6Wk7.js","html-void-elements-mCSPHezU.js","marked.esm-CZWythHk.js"]}