If the refund is type=full, line items aren't necessary. If the refund is type=partial, you must provide the line item(s) you wish to apply refunds against using a reference_product_id.
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Numeral API","colors":{"primary":"#0D9373","light":"#07C983","dark":"#0D9373"},"logo":{"light":"https://mintcdn.com/numeralhq/w35K7dUKWBDiixfd/logo/logo.svg?fit=max\u0026auto=format\u0026n=w35K7dUKWBDiixfd\u0026q=85\u0026s=2330fe2568887c273331c4846f7a4d1e","dark":"https://mintcdn.com/numeralhq/w35K7dUKWBDiixfd/logo/logo-dark.svg?fit=max\u0026auto=format\u0026n=w35K7dUKWBDiixfd\u0026q=85\u0026s=3c46c5bdc314577d1ce3660b957c0ad8"},"favicon":"https://mintcdn.com/numeralhq/NAgHCHKl6ucev5Pu/favicon.ico?fit=max\u0026auto=format\u0026n=NAgHCHKl6ucev5Pu\u0026q=85\u0026s=a6ecac944d1933a8432a8b2234eed9a4","api":{"openapi":["api-reference/v2026-03-01/openapi.json","api-reference/v2026-01-01/openapi.json","api-reference/v2025-05-12/openapi.json","api-reference/v2024-09-01/openapi.json","api-reference/v2026-11-01/openapi.json"]},"navbar":{"links":[{"href":"mailto:hi@mintlify.com","label":"Support"}],"primary":{"type":"button","label":"Dashboard","href":"https://dashboard.mintlify.com"}},"interaction":{"drilldown":false},"styling":{"latex":true},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"numeralhq","hasAudioNarration":false,"actualSubdomain":"numeralhq","customDomains":["docs.numeral.com"],"gitSource":{"type":"github","owner":"numeralhq","repo":"tax-engine-documentation","deployBranch":"main","contentDirectory":"","isPrivate":true,"mountPath":"","label":""},"chroma":{"liveDeploymentHistoryId":"6ae27c81d56b3c07efab159a","collectionId":"623087f7-94a8-47ab-94bd-032bc5ea9868","schemaVersion":"v3","latestBuiltDeploymentHistoryId":"6ae27c81d56b3c07efab159a"},"entitlements":{"AI_CHAT":{"status":"ENABLED"},"WEB_MCP":{"status":"ENABLED"},"NARRATION":{"status":"ENABLED"}},"buildId":"6ae27c81d56b3c07efab159a","clientVersion":"0.0.4006","searchFilterCounts":[{"language":"default","tag":"API Documentation","count":56},{"language":"default","tag":"Integrations","count":53},{"language":"default","tag":"Platform Integrations","count":48},{"language":"default","tag":"API Reference","count":46},{"language":"default","tag":"Getting Started","count":10},{"language":"default","tag":"Stripe","count":8},{"language":"default","tag":"Numeral for Stripe Checkout","count":6},{"language":"default","tag":"Integration Guides","count":5},{"language":"default","tag":"Shopify","count":5},{"language":"default","tag":"MCP","count":5}]},"assistantConfig":{},"basePath":"","hasChatPermissions":true,"hasWebMcpPermissions":true,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-v7-file-tree","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"pause-universal-search-reconcile","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"per-site-search-delta","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-private-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-nav-generations","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"byok-sep-25","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"vite-origin","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-agent-model-picker","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-updated-9-15","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[{"filePath":"src/style.css","content":".text-gray-100{color:#c1c2c5}[class*=max-w-8xl]{max-width:112rem!important}#content-container{max-width:none!important}td:first-child code{white-space:nowrap}"},{"filePath":"src/resource-pages.css","content":".sx-section{display:grid;grid-template-columns:minmax(0,1fr) minmax(0,1fr);gap:3rem;padding:2.5rem 0;border-top:1px solid rgb(127 127 127/.2)}.sx-section:first-of-type{border-top:none;padding-top:0}.sx-right{position:sticky;top:8rem;align-self:start;max-height:calc(100vh - 9rem);overflow-y:auto}.sx-wide{grid-template-columns:minmax(0,1fr);gap:0}.sx-wide .sx-right{position:static;max-height:none}.sx-wide td code{white-space:nowrap}.sx-left>h2:first-child{margin-top:0}@media (max-width:1024px){.sx-section{grid-template-columns:minmax(0,1fr)}.sx-right{position:static;max-height:none}}.sx-endpoints{border:1px solid rgb(127 127 127/.25);border-radius:.75rem;padding:.75rem 1rem .25rem}.sx-endpoints-title{font-size:.75rem;font-weight:600;text-transform:uppercase;letter-spacing:.05em;opacity:.7;margin-bottom:.5rem}div.sx-endpoints a{display:block;position:relative;font-family:inherit;font-size:inherit;padding:.6rem 1.5rem .6rem 0;border-top:1px solid rgb(127 127 127/.2);border-bottom:none!important;text-decoration:none}.sx-endpoints a::after{content:\"›\";position:absolute;right:.25rem;top:50%;transform:translateY(-50%);font-size:1.25rem;opacity:.5}.sx-endpoints a:hover::after{opacity:1}.sx-ep-name{display:block;font-weight:600;font-size:.9rem}.sx-ep-path{display:block;font-family:ui-monospace,SFMono-Regular,Menlo,monospace;font-size:.8rem;margin-top:.15rem}.sx-ep-url{opacity:.65}.sx-endpoints .sx-method{display:inline-block;min-width:3.75rem;margin-right:0;font-weight:700}.sx-endpoints .sx-get{color:#3b82f6}.sx-endpoints .sx-post{color:#16a34a}.sx-endpoints .sx-delete{color:#ef4444}.sx-nav-sub{list-style:none;margin:.15rem 0 .5rem;padding:0 0 0 1.75rem}.sx-nav-sub a{display:flex;align-items:baseline;gap:.5rem;padding:.3rem .5rem;border-radius:.5rem;font-size:.8125rem;line-height:1.3;opacity:.7}.sx-nav-sub a.sx-current,.sx-nav-sub a:hover{opacity:1;background:rgb(127 127 127/.1)}.sx-nav-sub a:focus{outline:0}.sx-nav-sub a:focus-visible{outline:2px solid rgb(127 127 127/.5)}.sx-nav-method.sx-nav-spacer{visibility:hidden}.sx-nav-method{flex:none;min-width:2.4rem;padding:.05rem .3rem;border-radius:.3rem;font-family:ui-monospace,SFMono-Regular,Menlo,monospace;font-size:.625rem;font-weight:700;text-align:center}.sx-nav-method.sx-get{color:#3b82f6;background:rgb(59 130 246/.15)}.sx-nav-method.sx-post{color:#16a34a;background:rgb(22 163 74/.15)}.sx-nav-method.sx-delete{color:#ef4444;background:rgb(239 68 68/.15)}.sx-page-end{height:4rem}.sx-children,.sx-toggle{border:1px solid rgb(127 127 127/.3)}.sx-toggle{margin-top:.75rem;border-radius:9999px;padding:.3rem .9rem;font-size:.85rem;font-weight:500;white-space:pre;cursor:pointer}.sx-toggle.sx-open{border-radius:.75rem .75rem 0 0;border-bottom:none}.sx-children{border-radius:0 .75rem .75rem .75rem;padding:0 1rem .5rem}.sx-children[hidden]{border:0;padding:0}"}],"page":{"pagePath":"api-reference/v2026-11-01/endpoint/refunds","slug":"/api-reference/v2026-11-01/endpoint/refunds","pageMetadata":{"title":"Create Refunds","openapi":"api-reference/v2026-11-01/openapi.json POST /tax/refunds","description":"Add a refund to a transaction","href":"/api-reference/v2026-11-01/endpoint/refunds"},"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: \"Add a refund to a transaction\"\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,jsxs:_jsxs}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){const _components={code:`code`,p:`p`,..._provideComponents(),...props.components},{Heading,Note}=_components;if(!Heading)_missingMdxReference(`Heading`,true);if(!Note)_missingMdxReference(`Note`,true);return _jsxs(_Fragment,{children:[_jsx(Heading,{level:`2`,id:`refund-endpoint-2026-11-01`,children:`Refund Endpoint (2026-11-01)`}),`\n`,_jsx(_components.p,{children:`Add a refund to a previously recorded transaction.`}),`\n`,_jsx(Note,{children:_jsxs(_components.p,{children:[`Remember to include the `,_jsx(_components.code,{children:`X-API-Version: 2026-11-01`}),` header in your request to use this API version.`]})})]})}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":"Create Refunds","openapi":"api-reference/v2026-11-01/openapi.json POST /tax/refunds","description":"Add a refund to a transaction","href":"/api-reference/v2026-11-01/endpoint/refunds"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[{"title":"Refund Endpoint (2026-11-01)","slug":"refund-endpoint-2026-11-01","depth":2,"children":[]}],"codeExamples":{}},"jsLinks":["/_mintlify/custom/numeralhq/f4a41b99b7afe396/src/version-refresh.js","/_mintlify/custom/numeralhq/4721c15820461e09/src/resource-pages.js"],"openApiReferenceData":{"operation":{"summary":"Create Refund","description":"Add a refund to a transaction","operationId":"createRefund_v20261101","requestBody":"b3ebb20e-0234-4bfc-a27d-330b37aca276","responses":{"200":"b3c2e6f5-a9e0-4721-9d0a-c1b770822480","400":"b9146369-e8c8-4522-b02b-e84bf770ee9f","404":"1c6cf6b2-898a-4055-8bb3-fdfd95dc73d3"},"method":"post","type":"path","servers":["d3db3deb-e04d-4d36-bd09-6cab37404789"],"security":["b4782b25-0821-4684-a511-1dad9c1762cf"],"path":"/tax/refunds","baseUrlOptions":["https://api.numeralhq.com/"],"title":"Create Refund","codeSamples":[],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{},"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"transaction_id":{"type":"string","description":"The ID of the `transaction` to refund. This is the `transaction_id` returned from the `/transactions` creation response.","example":"tr_123456789","isRequired":true,"uniqueKey":"transaction_id","typeLabel":"string"},"type":{"type":"string","enum":["full","partial"],"description":"This will be either `'full'` or `'partial'`. If `type='partial'`, you must also provide the line item(s) you wish to apply refunds against.","example":"partial","isRequired":true,"uniqueKey":"type","typeLabel":"enum\u003cstring>"},"refund_processed_at":{"type":"number","description":"Unix timestamp in **seconds** representing the date and time the refund was made. If not provided, the current date and time will be used.","example":1714787673,"uniqueKey":"refund_processed_at","typeLabel":"number"},"line_items":{"type":"array","description":"If the refund is `type=full`, line items aren't necessary. If the refund is `type=partial`, you must provide the line item(s) you wish to apply refunds against using a `reference_product_id`.","items":{"type":"object","properties":{"reference_product_id":{"type":"string","description":"The ID of the product to apply refunds against. We will attempt to find the line item from the original transaction based on this `reference_product_id`.","example":"p-1233543","uniqueKey":"line_items.items.[INDEX].reference_product_id","typeLabel":"string"},"reference_line_item_id":{"type":"string","description":"This **optional** attribute is the ID of the line item from your system. It will be used only for reporting.","example":"line_123456789","uniqueKey":"line_items.items.[INDEX].reference_line_item_id","typeLabel":"string"},"sales_amount_refunded":{"type":"number","description":"The sale amount that was refunded to the customer on this line item, not inclusive of tax refunded.","example":-200,"uniqueKey":"line_items.items.[INDEX].sales_amount_refunded","typeLabel":"number"},"quantity":{"type":"number","description":"The quantity of this product being refunded.","example":2,"uniqueKey":"line_items.items.[INDEX].quantity","typeLabel":"number"},"tax_amount_refunded":{"type":"number","description":"The amount of tax that was refunded to the customer.","example":-14,"uniqueKey":"line_items.items.[INDEX].tax_amount_refunded","typeLabel":"number"}},"uniqueKey":"line_items.items.[INDEX]","typeLabel":"object"},"uniqueKey":"line_items","typeLabel":"object[]"}},"required":["transaction_id","type"],"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"transaction_id":"tr_123456789","type":"partial","refund_processed_at":1714787673,"line_items":[{"reference_product_id":"p-1233543","reference_line_item_id":"line_123456789","sales_amount_refunded":-200,"quantity":2,"tax_amount_refunded":-14}]}}},"exampleType":"generated"}},"required":true,"exampleType":"generated"},"responses":{"b3c2e6f5-a9e0-4721-9d0a-c1b770822480":{"description":"Refund response","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","description":"The ID of the `refund`. We recommend you store this value. If you need to reverse this refund, you will be required to reference this ID.","example":"ref_tr_123456789","uniqueKey":"id","typeLabel":"string"},"object":{"type":"string","description":"The type of object: `tax.refund`.","example":"tax.refund","uniqueKey":"object","typeLabel":"string"},"refund_type":{"type":"string","description":"This will be either `'full'` or `'partial'`.","example":"partial","uniqueKey":"refund_type","typeLabel":"string"},"testmode":{"type":"boolean","description":"`True` if using a production API key. `False` if using a test API key.","example":false,"uniqueKey":"testmode","typeLabel":"boolean"},"refund_processed_at":{"type":"number","description":"Unix timestamp in **seconds** representing the date and time the refund was made. If not provided, the time the `refund` was created will be used.","example":1714787673,"uniqueKey":"refund_processed_at","typeLabel":"number"},"line_items":{"type":"array","items":{"type":"object","properties":{"line_item_id":{"type":"string","description":"Numeral-generated ID for this line item.","example":"li_1783369661107e97b4af5-b61a-487d-aa31-ecee6e616f7f","uniqueKey":"line_items.items.[INDEX].line_item_id","typeLabel":"string"},"product":{"type":"object","description":"Product information for this line item.","properties":{"reference_product_name":{"type":"string","description":"The name of the product.","example":"Red Shoes","uniqueKey":"line_items.items.[INDEX].product.reference_product_name","typeLabel":"string"},"reference_line_item_id":{"type":"string","description":"The ID of the line item from your system.","example":"line_123456789","uniqueKey":"line_items.items.[INDEX].product.reference_line_item_id","typeLabel":"string"},"reference_product_id":{"type":"string","description":"The product ID in your system.","example":"p-1233543","uniqueKey":"line_items.items.[INDEX].product.reference_product_id","typeLabel":"string"},"product_tax_code":{"type":"string","description":"The tax code applied to this product.","example":"GENERAL_MERCHANDISE","uniqueKey":"line_items.items.[INDEX].product.product_tax_code","typeLabel":"string"}},"uniqueKey":"line_items.items.[INDEX].product","typeLabel":"object"},"tax_jurisdictions":{"type":"array","description":"Array of tax jurisdictions that apply to this line item.","items":{"type":"object","properties":{"tax_rate":{"type":"number","description":"The tax rate for this jurisdiction, rounded to 6 decimal places. This is the statutory rate for the jurisdiction and may apply to only part of the line item amount (for example, Tennessee single article rules). Do not sum rates across jurisdictions to derive an effective rate; use `tax_amount / amount_excluding_tax` instead.","example":0.07,"uniqueKey":"line_items.items.[INDEX].tax_jurisdictions.items.[INDEX].tax_rate","typeLabel":"number"},"tax_due_decimal":{"type":"number","description":"The unrounded tax due for this jurisdiction, in the currency's smallest unit. May be fractional (it is not rounded to an integer). `0` for flat-fee jurisdictions — see `fee_amount` instead.","example":724.9275,"uniqueKey":"line_items.items.[INDEX].tax_jurisdictions.items.[INDEX].tax_due_decimal","typeLabel":"number"},"fee_amount":{"type":"number","description":"Any fixed fee amount for this jurisdiction.","example":0,"uniqueKey":"line_items.items.[INDEX].tax_jurisdictions.items.[INDEX].fee_amount","typeLabel":"number"},"rate_type":{"type":"string","description":"Descriptive rate classification for this jurisdiction.","example":"GENERAL STATE SALES TAX","uniqueKey":"line_items.items.[INDEX].tax_jurisdictions.items.[INDEX].rate_type","typeLabel":"string"},"tax_authority_name":{"type":"string","description":"Name of the tax authority.","example":"Tennessee","uniqueKey":"line_items.items.[INDEX].tax_jurisdictions.items.[INDEX].tax_authority_name","typeLabel":"string"},"tax_authority_type":{"type":"string","description":"Type of tax authority (e.g., STATE, COUNTY, CITY, DISTRICT).","example":"","uniqueKey":"line_items.items.[INDEX].tax_jurisdictions.items.[INDEX].tax_authority_type","typeLabel":"string"},"tax_type":{"type":"string","description":"Type of tax: SALES, USE, VAT, or GST.","example":"SALES","uniqueKey":"line_items.items.[INDEX].tax_jurisdictions.items.[INDEX].tax_type","typeLabel":"string"},"note":{"type":"string","description":"Why this row came out the way it did. Empty string for normally calculated tax. Otherwise one of `no_collection_exempt_customer`, `no_collection_no_state_nexus`, `no_collection_no_vat_registration`, `no_collection_no_gst_registration`, `collection_manually_deactivated`, `automatic_tax_disabled`, `b2b_reverse_charge`, `shipping_follows_highest_taxed_item`, `canary_islands_zero_rate`. Records created before this version was released may return an empty note.","example":"","uniqueKey":"line_items.items.[INDEX].tax_jurisdictions.items.[INDEX].note","typeLabel":"string"}},"uniqueKey":"line_items.items.[INDEX].tax_jurisdictions.items.[INDEX]","typeLabel":"object"},"uniqueKey":"line_items.items.[INDEX].tax_jurisdictions","typeLabel":"object[]"},"quantity":{"type":"number","description":"The quantity of this product.","example":2,"uniqueKey":"line_items.items.[INDEX].quantity","typeLabel":"number"},"tax_amount":{"type":"number","description":"The tax amount for this line item.","example":14,"uniqueKey":"line_items.items.[INDEX].tax_amount","typeLabel":"number"},"amount_excluding_tax":{"type":"number","description":"The line item amount excluding tax.","example":200,"uniqueKey":"line_items.items.[INDEX].amount_excluding_tax","typeLabel":"number"},"amount_including_tax":{"type":"number","description":"The line item amount including tax.","example":214,"uniqueKey":"line_items.items.[INDEX].amount_including_tax","typeLabel":"number"}},"uniqueKey":"line_items.items.[INDEX]","typeLabel":"object"},"uniqueKey":"line_items","typeLabel":"object[]"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"id":"ref_tr_123456789","object":"tax.refund","refund_type":"partial","testmode":false,"refund_processed_at":1714787673,"line_items":[{"line_item_id":"li_1783369661107e97b4af5-b61a-487d-aa31-ecee6e616f7f","product":{"reference_product_name":"Red Shoes","reference_line_item_id":"line_123456789","reference_product_id":"p-1233543","product_tax_code":"GENERAL_MERCHANDISE"},"tax_jurisdictions":[{"tax_rate":0.07,"tax_due_decimal":724.9275,"fee_amount":0,"rate_type":"GENERAL STATE SALES TAX","tax_authority_name":"Tennessee","tax_authority_type":"","tax_type":"SALES","note":""}],"quantity":2,"tax_amount":14,"amount_excluding_tax":200,"amount_including_tax":214}]}}},"exampleType":"generated"}},"exampleType":"generated"},"b9146369-e8c8-4522-b02b-e84bf770ee9f":{"description":"Unexpected error","content":{"application/json":{"schema":{"type":"object","description":"Standard error response format for API version 2026-01-01","properties":{"code":{"type":"integer","description":"HTTP status code","example":400,"isRequired":true,"uniqueKey":"code","typeLabel":"integer"},"type":{"type":"string","description":"Machine-readable error type","example":"MISSING_FIELD","isRequired":true,"uniqueKey":"type","typeLabel":"string"},"message":{"type":"string","description":"Human-readable error message","example":"Required field 'address_country' is missing","isRequired":true,"uniqueKey":"message","typeLabel":"string"}},"required":["code","type","message"],"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"code":400,"type":"MISSING_FIELD","message":"Required field 'address_country' is missing"}}},"exampleType":"generated"}},"exampleType":"generated"},"1c6cf6b2-898a-4055-8bb3-fdfd95dc73d3":{"description":"Transaction not found","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"integer","example":404,"uniqueKey":"code","typeLabel":"integer"},"type":{"type":"string","example":"TRANSACTION_NOT_FOUND","uniqueKey":"type","typeLabel":"string"},"message":{"type":"string","example":"Transaction not found","uniqueKey":"message","typeLabel":"string"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"code":404,"type":"TRANSACTION_NOT_FOUND","message":"Transaction not found"}}},"exampleType":"generated"}},"exampleType":"generated"}},"security":{"b4782b25-0821-4684-a511-1dad9c1762cf":{"bearerAuth":{"type":"http","scheme":"bearer","scopes":[],"schemeName":"bearerAuth"}}},"servers":{"d3db3deb-e04d-4d36-bd09-6cab37404789":{"url":"https://api.numeralhq.com/"}},"processedSecurityOptions":[{"schemes":[{"scheme":{"type":"http","scheme":"bearer","scopes":[],"schemeName":"bearerAuth"},"schema":{"title":"Bearer Auth","type":"string","isRequired":true,"description":"Bearer authentication header of the form `Bearer \u003ctoken>`, where `\u003ctoken>` is your auth token.","format":"bearer","typeLabel":"string\u003cbearer>","deprecated":false},"schemeName":"bearerAuth","name":"Authorization"}],"title":"bearerAuth"}]},"originalFileLocation":"api-reference/v2026-11-01/openapi.json"},"subdomain":"numeralhq","siteName":"Numeral API","title":"Create Refunds - Numeral API","navMaps":{"firstHrefInVersion":{"2026-11-01":{"href":"/api-reference/v2026-11-01/endpoint/refunds","matchLevel":0},"2026-03-01":{"href":"/introduction","matchLevel":4},"2026-01-01":{"href":"/introduction","matchLevel":4},"2025-05-12":{"href":"/introduction","matchLevel":4},"2024-09-01":{"href":"/introduction","matchLevel":4}},"firstHrefInLanguage":{}},"lastModified":"2026-10-28T21:02:43.122Z","originalFileLocation":"api-reference/v2026-11-01/endpoint/refunds.mdx"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=null;if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"system\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"description\" content=\"Add a refund to a transaction\">\u003cmeta data-mint-head name=\"application-name\" content=\"Numeral 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/numeralhq/T60dQ7B6WxiReCVN/_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/numeralhq/T60dQ7B6WxiReCVN/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/numeralhq/T60dQ7B6WxiReCVN/_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/numeralhq/T60dQ7B6WxiReCVN/_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/numeralhq/T60dQ7B6WxiReCVN/_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/numeralhq/T60dQ7B6WxiReCVN/_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/numeralhq/T60dQ7B6WxiReCVN/_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/numeralhq/T60dQ7B6WxiReCVN/_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/numeralhq/T60dQ7B6WxiReCVN/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Create Refunds - Numeral API\">\u003cmeta data-mint-head property=\"og:description\" content=\"Add a refund to a transaction\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Numeral API\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.numeral.com/api-reference/v2026-11-01/endpoint/refunds\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://numeralhq.mintlify.app/_mintlify/api/og/v2?division=Documentation\u0026amp;title=Create+Refunds\u0026amp;description=Add+a+refund+to+a+transaction\u0026amp;theme=db0aa42568482bdcbfb10a73\u0026amp;signature=57df080d7c020e873634fc253bfd87df3fff6891262732effaaccc46bb0d41b8\">\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=\"Create Refunds - Numeral API\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Add a refund to a transaction\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://numeralhq.mintlify.app/_mintlify/api/og/v2?division=Documentation\u0026amp;title=Create+Refunds\u0026amp;description=Add+a+refund+to+a+transaction\u0026amp;theme=db0aa42568482bdcbfb10a73\u0026amp;signature=57df080d7c020e873634fc253bfd87df3fff6891262732effaaccc46bb0d41b8\">\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/numeralhq/T60dQ7B6WxiReCVN/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Numeral API\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#0D9373\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.numeral.com/api-reference/v2026-11-01/endpoint/refunds\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/api-reference/v2026-11-01/endpoint/refunds.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Numeral API\",\"creator\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","siteName":"Numeral API","nav":{"global":null,"versions":[{"version":"2026-11-01","tabs":[{"tab":"API Documentation","groups":[{"group":"Getting Started","pages":[{"title":"Introduction","icon":"hand-wave","href":"/introduction"},{"title":"Quickstart","icon":"rabbit","href":"/essentials/quickstart/quickstart"},{"title":"Changelog","icon":"wind","href":"/api-reference/v2026-11-01/changelog"},{"title":"API Keys","icon":"key","href":"/essentials/api-keys"},{"title":"API Versioning","icon":"code-branch","href":"/api-reference/versioning"},{"title":"Currencies","icon":"money-bill","href":"/essentials/currencies"},{"title":"Product Categories","icon":"tag","href":"/essentials/product-categories"},{"title":"Tax IDs","icon":"id-card","href":"/essentials/tax-ids"},{"title":"FAQs","icon":"question","href":"/essentials/faqs"},{"title":"AI help","icon":"robot","href":"/ai-help/overview"}]},{"group":"API Reference","pages":[{"title":"Introduction v2026-11-01","href":"/api-reference/v2026-11-01/introduction"},{"title":"Error Codes","icon":"triangle-exclamation","href":"/api-reference/v2026-11-01/error-codes"},{"title":"Calculations","icon":"calculator","mode":"wide","href":"/v2026-11-01/objects/calculations"},{"title":"Transactions","icon":"cash-register","mode":"wide","href":"/v2026-11-01/objects/transactions"},{"title":"Platform","icon":"store","mode":"wide","href":"/v2026-11-01/objects/platform"},{"title":"Merchants","icon":"store","mode":"wide","href":"/v2026-11-01/objects/merchants"},{"title":"Products","icon":"boxes-stacked","mode":"wide","href":"/v2026-11-01/objects/products"},{"title":"Customers","icon":"person","mode":"wide","href":"/v2026-11-01/objects/customers"},{"title":"Exemption (Resale) Certificates","icon":"file-certificate","mode":"wide","href":"/v2026-11-01/objects/exemption-certificates"},{"title":"Exchange Rates","icon":"money-bill-transfer","mode":"wide","href":"/v2026-11-01/objects/exchange-rates"},{"title":"Health Check","openapi":"api-reference/v2026-11-01/openapi.json GET /tax/ping","href":"/api-reference/v2026-11-01/endpoint/ping"}]}]},{"tab":"Integrations","groups":[{"group":"Integration Guides","pages":[{"title":"Reference Objects","icon":"link","href":"/essentials/integration-guides/reference-objects-faq"},{"title":"Managing Product Categories","icon":"bucket","href":"/essentials/integration-guides/products-and-categories"},{"title":"Exemptions Behavior","icon":"circle-xmark","href":"/essentials/integration-guides/exemptions-behavior"},{"title":"Submit Certificates via API","icon":"file-arrow-up","href":"/essentials/integration-guides/submit-certificates-via-api"},{"title":"Best Practices for a Successful Launch","icon":"circle-check","href":"/essentials/integration-guides/best-practices"}]},{"group":"Platform Integrations","pages":[{"title":"Integrations Overview","href":"/integrations/overview"},{"title":"Marketplaces","href":"/integrations/marketplaces"},{"title":"HR Systems","href":"/integrations/hr-systems"},{"title":"Acumatica","href":"/integrations/acumatica"},{"title":"Adobe Commerce","href":"/integrations/adobe-commerce"},{"title":"BigCommerce","href":"/integrations/bigcommerce"},{"title":"Microsoft Business Central","href":"/integrations/business-central"},{"title":"Campfire","href":"/integrations/campfire"},{"title":"Chargebee","href":"/integrations/chargebee"},{"title":"CheckoutChamp","href":"/integrations/checkoutchamp"},{"title":"Fulfil","href":"/integrations/fulfil"},{"title":"HubSpot","href":"/integrations/hubspot"},{"title":"Infor M3","href":"/integrations/infor-m3"},{"title":"JustPaid","href":"/integrations/justpaid"},{"title":"Maxio","href":"/integrations/maxio"},{"title":"Measure","href":"/integrations/measure"},{"title":"NetSuite","href":"/integrations/netsuite"},{"title":"Odoo","href":"/integrations/odoo"},{"title":"Orb","href":"/integrations/orb"},{"title":"QuickBooks Online","href":"/integrations/quickbooks-online"},{"title":"Rillet","href":"/integrations/rillet"},{"title":"SaaSGrid","href":"/integrations/saasgrid"},{"title":"Sage Intacct","href":"/integrations/sage-intacct"},{"title":"Salesforce Commerce Cloud","href":"/integrations/salesforce-commerce-cloud"},{"title":"Salesforce Sales Cloud","href":"/integrations/salesforce-sales-cloud"},{"title":"SAP S/4HANA","href":"/integrations/sap-s4hana"},{"title":"Sequence","href":"/integrations/sequence"},{"group":"Shopify","pages":[{"title":"Shopify Partner Access","href":"/integrations/shopify/shopify-partner-access"},{"title":"Shopify Tax Services and Troubleshooting","href":"/integrations/shopify/shopify-tax-services"},{"title":"Shopify Apps","href":"/integrations/shopify/shopify-apps"},{"title":"Configuring Shopify Sales Channels","href":"/integrations/shopify/shopify-sales-channels"},{"title":"Shopify Settings for Schedule C Reporting in California","href":"/integrations/shopify/shopify-schedule-c-california"}]},{"title":"SKU.io","href":"/integrations/skuio"},{"title":"Solidus","href":"/integrations/solidus"},{"group":"Stripe","pages":[{"group":"Numeral for Stripe Checkout","pages":[{"title":"Numeral for Stripe Checkout","href":"/integrations/stripe/stripe-checkout"},{"title":"Customer location and address validation","href":"/integrations/stripe/stripe-checkout-location"},{"title":"Embed address collection","href":"/integrations/stripe/stripe-checkout-embedded"},{"title":"Branding and appearance","href":"/integrations/stripe/stripe-checkout-branding"},{"title":"Discounts and promotion codes","href":"/integrations/stripe/stripe-checkout-discounts"},{"title":"Metadata and saved cards","href":"/integrations/stripe/stripe-checkout-metadata"}]},{"title":"Using Numeral's Tax Engine on Stripe Invoices","href":"/integrations/stripe/stripe-invoices"},{"title":"How Stripe Tax Works with Numeral","href":"/integrations/stripe/stripe-tax"}]},{"title":"Subscript","href":"/integrations/subscript"},{"title":"Tabs","href":"/integrations/tabs"},{"title":"WooCommerce","href":"/integrations/woocommerce"},{"title":"Xero","href":"/integrations/xero"},{"title":"Zoho Billing","href":"/integrations/zoho-billing"},{"title":"Zoho Books","href":"/integrations/zoho-books"}]}]},{"tab":"MCP","groups":[{"group":"Get Started","pages":[{"title":"MCP Overview","icon":"plug","href":"/mcp/overview"},{"title":"MCP Quickstart","icon":"rocket","href":"/mcp/quickstart"}]},{"group":"Reference","pages":[{"title":"MCP Tool Reference","icon":"wrench","href":"/mcp/tools"},{"title":"MCP Authentication \u0026 Limits","icon":"shield","href":"/mcp/authentication"}]},{"group":"Build with MCP","pages":[{"title":"MCP Demo Application","icon":"github","href":"/mcp/demo-app"}]}]}]},{"version":"2026-03-01","pages":[{"title":"2026-03-01","href":"/introduction"}]},{"version":"2026-01-01","pages":[{"title":"2026-01-01","href":"/introduction"}]},{"version":"2025-05-12","pages":[{"title":"2025-05-12","href":"/introduction"}]},{"version":"2024-09-01","pages":[{"title":"2024-09-01","href":"/introduction"}]}]},"title":"Create Refunds - Numeral API","buildId":"dpl_2xiSHD9XEvLsPGPcfoMtkLTB3dy9","deploymentId":"dpl_2xiSHD9XEvLsPGPcfoMtkLTB3dy9","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-DmVyH30O.js","utils-BHQqGGOd.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-CD-E4BIt.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-Bp5Lq9Ds.js","snippetPresets-C4xAVCFP.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","ApiExamples-CgXVLxUC.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-BF8I5oUf.js","shallow-Byd0lWnC.js","getApiPlaygroundDisplay-BGOZG1OK.js","CodeSnippet-CpvQL0CY.js","CodeSnippets-B8wkBKXa.js","Page-CBCH2P7b.js","getPastedJson-Ry3scI3Y.js","icon-D7a9HcdD.js","MethodPill-CJ8pmHhz.js","DuplicateIcon-rh1HJF0t.js","createIcon-DvGznqYs.js","DynamicMarkdown-Cc6AuSHS.js","SectionHeading-B4A0S-ep.js","axios-vUo_bRtp.js","Markdown-Cc16CX65.js","clsx-Cs6nMGht.js","lib-DuNMoZ05.js","lib-B8HbPgcC.js","html-void-elements-mCSPHezU.js","dist-zbf22OZA.js","katex-YMM-FMeD.js","marked.esm-CZWythHk.js","AssistantPageLink-C_fs-y5n.js"]}