Checks whether a given address is a valid delivery address for shipping purposes. The tax provider can decide whether to mention the full or valid address depending on their requirement.
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Chargebee Partner docs","colors":{"primary":"#ff3300","light":"#ff3300","dark":"#01283a"},"logo":{"light":"https://mintcdn.com/cb/t_llHYxnCXjWsl_M/logo/light.svg?fit=max\u0026auto=format\u0026n=t_llHYxnCXjWsl_M\u0026q=85\u0026s=ea8284652978e0e228b6e8490b85f386","dark":"https://mintcdn.com/cb/t_llHYxnCXjWsl_M/logo/dark.svg?fit=max\u0026auto=format\u0026n=t_llHYxnCXjWsl_M\u0026q=85\u0026s=ec5bfa91e37e3d17f52113436b5fa3c4"},"favicon":"https://mintcdn.com/cb/5NA3_g6K23tnaaEn/logo/favicon.png?fit=max\u0026auto=format\u0026n=5NA3_g6K23tnaaEn\u0026q=85\u0026s=f9754a80dbaca6ded2263ed1f98043a0","api":{"playground":{"display":"interactive"},"examples":{"defaults":"required","languages":["curl"],"prefill":true}},"background":{},"navbar":{"links":[{"href":"mailto:support@chargebee.com","label":"Support"}]},"integrations":{"ga4":{"measurementId":"G‑EJ2MQ2ENV4"}},"contextual":{"options":["copy","view","chatgpt","claude","mcp","cursor","vscode"],"display":"header"},"styling":{"latex":false},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"cb","hasAudioNarration":false,"actualSubdomain":"cb","customDomains":["spidocs.chargebee.com"],"gitSource":{"type":"github","owner":"chargebee","repo":"cb-partner-spi","deployBranch":"main","contentDirectory":"","isPrivate":false,"mountPath":"","label":""},"chroma":{"liveDeploymentHistoryId":"6ad1e31ae9fd0fe7b1164461","collectionId":"59759385-5554-4175-937c-3ada42f06abc","schemaVersion":"v3","latestBuiltDeploymentHistoryId":"6ad1e31ae9fd0fe7b1164461"},"entitlements":{"AI_CHAT":{"status":"ENABLED"},"WEB_MCP":{"status":"ENABLED"},"NARRATION":{"status":"ENABLED"}},"buildId":"6ad1e31ae9fd0fe7b1164461","clientVersion":"0.0.4054","searchFilterCounts":[{"language":"default","tag":"API Reference","count":41},{"language":"default","tag":"Tax SPI","count":16},{"language":"default","tag":"Einvoicing SPI","count":14},{"language":"default","tag":"Tax Registration Number Validation SPI","count":9},{"language":"default","tag":"Tax Registration Number Validation","count":5},{"language":"default","tag":"CreditNote","count":4},{"language":"default","tag":"Invoice","count":4},{"language":"default","tag":"Health","count":3},{"language":"default","tag":"Authentication","count":3},{"language":"default","tag":"Authorization","count":3}]},"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":"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":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"full-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"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":"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":"turbopuffer-dual-write","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"approve-review-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"sso-setup-deadline-banner","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"rbac-expansion","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[],"page":{"pagePath":"api-reference/tax-spi/endpoints/v1/address-validation","slug":"/api-reference/tax-spi/endpoints/v1/address-validation","pageMetadata":{"openapi":"post /address/validate","title":"Address validation","description":"Checks whether a given address is a valid delivery address for shipping purposes. The tax provider can decide whether to mention the full or valid address depending on their requirement.","href":"/api-reference/tax-spi/endpoints/v1/address-validation"},"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: \"Checks whether a given address is a valid delivery address for shipping purposes. The tax provider can decide whether to mention the full or valid address depending on their requirement.\"\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){return _jsx(_Fragment,{})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"openapi":"post /address/validate","title":"Address validation","description":"Checks whether a given address is a valid delivery address for shipping purposes. The tax provider can decide whether to mention the full or valid address depending on their requirement.","href":"/api-reference/tax-spi/endpoints/v1/address-validation"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":[],"openApiReferenceData":{"operation":{"description":"Checks whether a given address is a valid delivery address for shipping purposes. The tax provider can decide whether to mention the full or valid address depending on their requirement.","operationId":"validateAddress","parameters":["4ca48afc-c575-4475-8113-8b462974acc7","7d7da914-ba7b-43f2-8023-ca08c2f365d5"],"requestBody":"090ee18c-08d2-407b-9edf-1a183e23cc21","responses":{"200":"a5482997-c234-4b5c-8438-04d5f61dcad8","400":"59ec128f-147a-4d05-94f7-121885c1b179","401":"ce41127a-2690-40ca-bdab-3d3622c72769","403":"4872daa3-6292-4676-996f-51abb15a87a5","429":"5ac655c2-e4c8-4c7a-a64a-ce7c6f6e590a","500":"d5e57d6d-e164-44a8-8ca3-ba09ea6fea62","503":"24990d32-0521-4ecb-a00c-6d09879224f2"},"summary":"Address validation","tags":["Address"],"x-content-type":"application/json","x-accepts":"application/json","method":"post","type":"path","servers":["c28a995f-20ee-45aa-938a-235dc3a13394","d2b4c97a-e050-44c4-8ee5-3f9e286aad34"],"security":["e2308e21-4c26-48c2-b4e7-de65c54b5a0d"],"path":"/address/validate","baseUrlOptions":["https://rest.taxes.provider.com/api/v1","https://sandbox.taxes.provider.com/api/v1"],"title":"Address validation","codeSamples":[],"requestExampleLanguages":["bash"],"requiredOnlyExamples":true,"requestExampleType":"generated","responseExampleType":"generated","prefillPlaygroundWithExample":true,"prefillPlaygroundExamples":[{"body.address.line1":"1000 main","body.address.line2":"","body.address.line3":"","body.address.city":"Irvine","body.address.state":"CA","body.address.postalCode":"92615","body.address.country":"US"},{"body.address.line1":"1000 MAIN ST","body.address.line2":"","body.address.line3":"","body.address.city":"IRVINE","body.address.state":"CA","body.address.postalCode":"92614","body.address.country":"US"}]},"dependencies":{"parameters":{"4ca48afc-c575-4475-8113-8b462974acc7":{"description":"Merchant's domain name will be sent by Chargebee","in":"header","name":"merchant_id","required":false,"schema":{"type":"string","isRequired":false,"description":"Merchant's domain name will be sent by Chargebee","uniqueKey":"","typeLabel":"string"}},"7d7da914-ba7b-43f2-8023-ca08c2f365d5":{"description":"Unique id of the request will be sent by Chargebee","in":"header","name":"trace_id","required":false,"schema":{"type":"string","isRequired":false,"description":"Unique id of the request will be sent by Chargebee","uniqueKey":"","typeLabel":"string"}}},"requestBody":{"content":{"application/json":{"examples":{"AddressValidationValidRequest":{"title":"AddressValidationValidRequest","description":"Valid address request","value":{"address":{"line1":"1000 main","line2":"","line3":"","city":"Irvine","state":"CA","country":"US","postalCode":"92615"}}},"AddressValidationInvalidRequest":{"title":"AddressValidationInvalidRequest","description":"Invalid address request","value":{"address":{"line1":"1000 MAIN ST","line2":"","line3":"","city":"IRVINE","state":"CA","country":"US","postalCode":"92614"}}}},"schema":{"additionalProperties":false,"description":"The verification request containing the address. The following fields are mandatory -\n - line1\n - city\n - postalCode\n - state\n - country","example":{"address":{"country":"country","city":"city","postalCode":"postalCode","state":"state","line3":"line3","line2":"line2","line1":"line1"}},"properties":{"address":{"description":"Represents the address used for validation.","example":{"country":"country","city":"city","postalCode":"postalCode","state":"state","line3":"line3","line2":"line2","line1":"line1"},"properties":{"line1":{"description":"First line of the street address","maxLength":180,"type":"string","uniqueKey":"address.line1","typeLabel":"string"},"line2":{"description":"Second line of the street address","maxLength":150,"type":"string","uniqueKey":"address.line2","typeLabel":"string"},"line3":{"description":"Third line of the street address","maxLength":150,"type":"string","uniqueKey":"address.line3","typeLabel":"string"},"city":{"description":"The city of the address","maxLength":50,"type":"string","uniqueKey":"address.city","typeLabel":"string"},"state":{"description":"The state of the address following the ISO 3166-2 state/province code without the country prefix.","maxLength":50,"type":"string","uniqueKey":"address.state","typeLabel":"string"},"postalCode":{"description":"Postal Code / Zip Code of the address.","maxLength":20,"type":"string","uniqueKey":"address.postalCode","typeLabel":"string"},"country":{"description":"The country of the address following the ISO 3166-1 alpha-2 standard.","maxLength":2,"type":"string","uniqueKey":"address.country","typeLabel":"string"}},"type":"object","uniqueKey":"address","typeLabel":"object"}},"type":"object","uniqueKey":"","typeLabel":"object"},"exampleType":"examples"}},"exampleType":"examples"},"responses":{"a5482997-c234-4b5c-8438-04d5f61dcad8":{"content":{"application/json":{"examples":{"AddressValidationValidResponse":{"title":"AddressValidationValidResponse","description":"Valid address verification response when address is validated successfully","value":{"status":"VALID"}},"AddressValidationInvalidResponse":{"title":"AddressValidationInvalidResponse","description":"The address provided for verification was Invalid","value":{"status":"INVALID"}}},"schema":{"example":{"status":null},"properties":{"status":{"description":"The validation status of an address.","enum":["VALID","INVALID"],"type":"string","isRequired":true,"uniqueKey":"status","typeLabel":"enum\u003cstring>"}},"required":["status"],"type":"object","uniqueKey":"","typeLabel":"object"},"exampleType":"examples"}},"description":"Address is validated successfully","exampleType":"examples"},"59ec128f-147a-4d05-94f7-121885c1b179":{"content":{"application/json":{"example":{"errors":[{"code":"INVALID_DATA","message":"Empty address provided.","entity":"Address"}]},"schema":{"description":"The error response for validation errors with the respective entity and its field information.","properties":{"errors":{"items":{"properties":{"code":{"description":"The error codes classify the type of exception that occurred during processing the request.","enum":["INVALID_OPERATION","SERVICE_EXCEPTION","SERVICE_UNAVAILABLE","SERVICE_LIMIT_EXCEEDED","MISSING_REQUIRED_DATA","INVALID_DATA","INVALID_TYPE","INVALID_FORMAT","INVALID_RANGE","LOCATION_VALIDATION_FAILED"],"type":"string","isRequired":true,"uniqueKey":"errors.items.[INDEX].code","typeLabel":"enum\u003cstring>"},"message":{"description":"A short message describing the reason for the error.","example":"Invalid tax code provided.","maxLength":250,"type":"string","isRequired":true,"uniqueKey":"errors.items.[INDEX].message","typeLabel":"string"},"entity":{"description":"The target entity that has the invalid field or value.","example":"customer","maxLength":20,"type":"string","uniqueKey":"errors.items.[INDEX].entity","typeLabel":"string"},"entityField":{"description":"The field of an entity that has the invalid value.","example":"lineItems[0].taxIdentifiers[0].value","maxLength":250,"type":"string","uniqueKey":"errors.items.[INDEX].entityField","typeLabel":"string"},"helpUrl":{"description":"The link to the documentation for more information about the error and the corrective action.","example":"https://apidocs.chargebee.com#Authentication","format":"uri","type":"string","uniqueKey":"errors.items.[INDEX].helpUrl","typeLabel":"string\u003curi>"}},"required":["code","message"],"type":"object","uniqueKey":"errors.items.[INDEX]","typeLabel":"object"},"type":"array","isRequired":true,"uniqueKey":"errors","typeLabel":"object[]"}},"required":["errors"],"type":"object","uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"errors":[{"code":"INVALID_DATA","message":"Empty address provided.","entity":"Address"}]}}},"exampleType":"examples"}},"description":"Bad request.","exampleType":"examples"},"ce41127a-2690-40ca-bdab-3d3622c72769":{"description":"Unauthenticated request.","content":{"_mintlify/placeholder":{"schema":{"type":"object","description":""}}}},"4872daa3-6292-4676-996f-51abb15a87a5":{"description":"Unauthorized request.","content":{"_mintlify/placeholder":{"schema":{"type":"object","description":""}}}},"5ac655c2-e4c8-4c7a-a64a-ce7c6f6e590a":{"description":"Too many requests.","content":{"_mintlify/placeholder":{"schema":{"type":"object","description":""}}}},"d5e57d6d-e164-44a8-8ca3-ba09ea6fea62":{"content":{"application/json":{"examples":{"Error500":{"title":"Error500","description":"Unexpected error during processing the request.","value":{"message":"Unexpected error during processing the request."}}},"schema":{"additionalProperties":false,"description":"The basic error response containing the error message and the help documentation link.","properties":{"message":{"description":"The description of the error with details about it's cause.","example":"Invalid Credentials","maxLength":250,"type":"string","isRequired":true,"uniqueKey":"message","typeLabel":"string"},"helpUrl":{"description":"The link to the documentation for more information about the error and the corrective action.","example":"https://apidocs.chargebee.com#Authentication","format":"uri","type":"string","uniqueKey":"helpUrl","typeLabel":"string\u003curi>"}},"required":["message"],"type":"object","uniqueKey":"","typeLabel":"object"},"exampleType":"examples"}},"description":"Unexpected error while processing request.","exampleType":"examples"},"24990d32-0521-4ecb-a00c-6d09879224f2":{"content":{"application/json":{"example":{"status":"DOWN","version":"1.0.0","description":"The service is unhealthy. Several components are down.","components":[{"id":"app-db-memory","name":"Application Database Memory Usage","type":"DATABASE","status":"UP"},{"id":"adapter-server","name":"Adapter API Server","type":"ADAPTER","status":"DOWN"},{"id":"service-server","name":"API Server","type":"API","status":"DOWN"}],"time":"2022-11-01T05:12:08.131Z"},"schema":{"example":{"components":[{"endpoints":["endpoints","endpoints"],"name":"name","description":"description","id":"id","type":"OTHER","status":null},{"endpoints":["endpoints","endpoints"],"name":"name","description":"description","id":"id","type":"OTHER","status":null}],"description":"description","time":"2000-01-23T04:56:07.000Z","version":"version","status":null},"properties":{"status":{"description":"The status of a specific component reported by the Service Adapter.","enum":["UP","DOWN","WARN"],"type":"string","isRequired":true,"uniqueKey":"status","typeLabel":"enum\u003cstring>"},"components":{"description":"List of health status details for each component reported by the Service Adapter.","items":{"description":"The health status details of a specific component reported by the Service Adapter.","example":{"endpoints":["endpoints","endpoints"],"name":"name","description":"description","id":"id","type":"OTHER","status":null},"properties":{"id":{"description":"The id of the component.","maxLength":50,"type":"string","isRequired":true,"uniqueKey":"components.items.[INDEX].id","typeLabel":"string"},"name":{"description":"The name of the component.","maxLength":150,"type":"string","isRequired":true,"uniqueKey":"components.items.[INDEX].name","typeLabel":"string"},"type":{"description":"The type of component affected when `status` is `WARN` or `DOWN`. The possible values are:\n- `ADAPTER`: The reported status is for the Service Adapter.\n- `API`: The reported status is for the Service Provider.\n- `DATABASE`: The reported status is for a database dependency of the Service Provider.\n- `SYSTEM`: The reported status is for any other known system component such as cache or gateway.\n- `OTHER`: The reported status is either for a component that does not belong to the types described above or the source of the issue is unknown.\n","enum":["OTHER","SYSTEM","API","ADAPTER","DATABASE"],"type":"string","isRequired":true,"uniqueKey":"components.items.[INDEX].type","typeLabel":"enum\u003cstring>"},"status":{"description":"The status of a specific component reported by the Service Adapter.","enum":["UP","DOWN","WARN"],"type":"string","isRequired":true,"uniqueKey":"components.items.[INDEX].status","typeLabel":"enum\u003cstring>"},"description":{"description":"The detailed status of the component.","maxLength":250,"type":"string","uniqueKey":"components.items.[INDEX].description","typeLabel":"string"},"endpoints":{"description":"When the `status` of the component is not `UP`, then the list of endpoints affected.","items":{"type":"string","uniqueKey":"components.items.[INDEX].endpoints.items.[INDEX]","typeLabel":"string"},"type":"array","uniqueKey":"components.items.[INDEX].endpoints","typeLabel":"string[]"}},"required":["id","name","status","type"],"type":"object","uniqueKey":"components.items.[INDEX]","typeLabel":"object"},"type":"array","isRequired":true,"uniqueKey":"components","typeLabel":"object[]"},"time":{"description":"The timestamp of the health status reported by the Service Adapter.","format":"date-time","type":"string","isRequired":true,"uniqueKey":"time","typeLabel":"string\u003cdate-time>"},"version":{"minLength":1,"type":"string","uniqueKey":"version","typeLabel":"string"},"description":{"description":"The description of the health status returned by the Service Adapter.","maxLength":250,"type":"string","uniqueKey":"description","typeLabel":"string"}},"required":["components","status","time"],"type":"object","uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"status":"DOWN","version":"1.0.0","description":"The service is unhealthy. Several components are down.","components":[{"id":"app-db-memory","name":"Application Database Memory Usage","type":"DATABASE","status":"UP"},{"id":"adapter-server","name":"Adapter API Server","type":"ADAPTER","status":"DOWN"},{"id":"service-server","name":"API Server","type":"API","status":"DOWN"}],"time":"2022-11-01T05:12:08.131Z"}}},"exampleType":"examples"}},"description":"Service is unhealthy.","exampleType":"examples"}},"security":{"e2308e21-4c26-48c2-b4e7-de65c54b5a0d":{"Authorization":{"description":"The json of all the parameters specified in authentication configuration of tax app will be sent by Chargebee.","in":"header","name":"Authorization","type":"apiKey","scopes":[]}}},"servers":{"c28a995f-20ee-45aa-938a-235dc3a13394":{"description":"Production SPI server.","url":"https://rest.taxes.provider.com/api/v1"},"d2b4c97a-e050-44c4-8ee5-3f9e286aad34":{"description":"Sandbox SPI server.","url":"https://sandbox.taxes.provider.com/api/v1"}},"processedSecurityOptions":[{"schemes":[{"scheme":{"description":"The json of all the parameters specified in authentication configuration of tax app will be sent by Chargebee.","in":"header","name":"Authorization","type":"apiKey","scopes":[]},"schema":{"title":"Authorization","type":"string","description":"The json of all the parameters specified in authentication configuration of tax app will be sent by Chargebee.","isRequired":true,"typeLabel":"string","deprecated":false},"schemeName":"Authorization","name":"Authorization"}],"title":"Authorization"}]},"originalFileLocation":"spec/spi/generated/tax/api/openapi.yaml"},"subdomain":"cb","siteName":"Chargebee Partner docs","title":"Address validation - Chargebee Partner docs","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2025-08-14T04:22:02.577Z","originalFileLocation":"api-reference/tax-spi/endpoints/v1/address-validation.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=\"Checks whether a given address is a valid delivery address for shipping purposes. The tax provider can decide whether to mention the full or valid address depending on their requirement.\">\u003cmeta data-mint-head name=\"application-name\" content=\"Chargebee Partner docs\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/cb/t3SWCatkguaBu2Q3/_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/cb/t3SWCatkguaBu2Q3/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/cb/t3SWCatkguaBu2Q3/_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/cb/t3SWCatkguaBu2Q3/_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/cb/t3SWCatkguaBu2Q3/_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/cb/t3SWCatkguaBu2Q3/_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/cb/t3SWCatkguaBu2Q3/_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/cb/t3SWCatkguaBu2Q3/_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/cb/t3SWCatkguaBu2Q3/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Address validation - Chargebee Partner docs\">\u003cmeta data-mint-head property=\"og:description\" content=\"Checks whether a given address is a valid delivery address for shipping purposes. The tax provider can decide whether to mention the full or valid address depending on their requirement.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Chargebee Partner docs\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://spidocs.chargebee.com/api-reference/tax-spi/endpoints/v1/address-validation\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://cb.mintlify.app/_mintlify/api/og/v2?division=Address\u0026amp;title=Address+validation\u0026amp;description=Checks+whether+a+given+address+is+a+valid+delivery+address+for+shipping+purposes.+The+tax+provider+can+decide+whether+to+mention+the+full+or+valid+address+depen\u0026amp;theme=a92e97344d325fa945570ab8\u0026amp;signature=454bea58a7a53ddc562c613bdc4070d177c459b7863e73fc2ec569a7223b5b9d\">\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=\"Address validation - Chargebee Partner docs\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Checks whether a given address is a valid delivery address for shipping purposes. The tax provider can decide whether to mention the full or valid address depending on their requirement.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://cb.mintlify.app/_mintlify/api/og/v2?division=Address\u0026amp;title=Address+validation\u0026amp;description=Checks+whether+a+given+address+is+a+valid+delivery+address+for+shipping+purposes.+The+tax+provider+can+decide+whether+to+mention+the+full+or+valid+address+depen\u0026amp;theme=a92e97344d325fa945570ab8\u0026amp;signature=454bea58a7a53ddc562c613bdc4070d177c459b7863e73fc2ec569a7223b5b9d\">\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/cb/t3SWCatkguaBu2Q3/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Chargebee Partner docs\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#ff3300\">\u003clink data-mint-head rel=\"canonical\" href=\"https://spidocs.chargebee.com/api-reference/tax-spi/endpoints/v1/address-validation\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/api-reference/tax-spi/endpoints/v1/address-validation.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://spidocs.chargebee.com/#organization\",\"name\":\"Chargebee Partner docs\",\"url\":\"https://spidocs.chargebee.com\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/cb/t_llHYxnCXjWsl_M/logo/light.svg?fit=max\u0026auto=format\u0026n=t_llHYxnCXjWsl_M\u0026q=85\u0026s=ea8284652978e0e228b6e8490b85f386\"}},{\"@type\":\"WebSite\",\"@id\":\"https://spidocs.chargebee.com#website\",\"name\":\"Chargebee Partner docs\",\"url\":\"https://spidocs.chargebee.com\",\"publisher\":{\"@id\":\"https://spidocs.chargebee.com/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://spidocs.chargebee.com/api-reference/tax-spi/endpoints/v1/address-validation#webpage\",\"url\":\"https://spidocs.chargebee.com/api-reference/tax-spi/endpoints/v1/address-validation\",\"name\":\"Address validation\",\"description\":\"Checks whether a given address is a valid delivery address for shipping purposes. The tax provider can decide whether to mention the full or valid address depending on their requirement.\",\"dateModified\":\"2025-08-14T04:22:02.577Z\",\"isPartOf\":{\"@id\":\"https://spidocs.chargebee.com#website\"},\"breadcrumb\":{\"@id\":\"https://spidocs.chargebee.com/api-reference/tax-spi/endpoints/v1/address-validation#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://spidocs.chargebee.com/api-reference/tax-spi/endpoints/v1/address-validation#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Tax SPI\",\"item\":\"https://spidocs.chargebee.com/api-reference/tax-spi/docs/overview\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Address validation\",\"item\":\"https://spidocs.chargebee.com/api-reference/tax-spi/endpoints/v1/address-validation\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://spidocs.chargebee.com/api-reference/tax-spi/endpoints/v1/address-validation#apireference\",\"headline\":\"Address validation\",\"name\":\"Address validation\",\"description\":\"Checks whether a given address is a valid delivery address for shipping purposes. The tax provider can decide whether to mention the full or valid address depending on their requirement.\",\"url\":\"https://spidocs.chargebee.com/api-reference/tax-spi/endpoints/v1/address-validation\",\"mainEntityOfPage\":{\"@id\":\"https://spidocs.chargebee.com/api-reference/tax-spi/endpoints/v1/address-validation#webpage\"},\"dateModified\":\"2025-08-14T04:22:02.577Z\",\"publisher\":{\"@id\":\"https://spidocs.chargebee.com/#organization\"},\"isPartOf\":{\"@id\":\"https://spidocs.chargebee.com#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Chargebee Partner docs\",\"creator\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","siteName":"Chargebee Partner docs","nav":{"global":null,"tabs":[{"tab":"API Reference","groups":[{"group":"Partner SPI","pages":[{"title":"Overview","href":"/api-reference/partner-spi/overview"}]},{"group":"Tax SPI","pages":[{"title":null,"href":"/api-reference/tax-spi/docs/overview"},{"title":null,"description":null,"href":"/api-reference/tax-spi/docs/authorization"},{"group":"Address","pages":[{"openapi":"post /address/validate","title":"Address validation","href":"/api-reference/tax-spi/endpoints/v1/address-validation"},{"openapi":"post /address/check-taxability","title":"Check taxability","description":"Checks whether the tax address is valid in terms of tax calculation. This endpoint checks whether the address information of the customer is sufficient for the tax provider to return a tax rate. It does not consider the nexus status of the merchant and is mandatory to integrate for the tax provider.","href":"/api-reference/tax-spi/endpoints/v1/check-taxability"}]},{"group":"TaxEstimate","pages":[{"openapi":"post /tax-estimate","title":"Estimate tax","href":"/api-reference/tax-spi/endpoints/v1/estimate-tax"}]},{"group":"Invoice","pages":[{"openapi":"post /invoices","title":"Create Invoice","href":"/api-reference/tax-spi/endpoints/v1/create-invoice"},{"openapi":"get /invoices/{invoiceId}","title":"Retrieve Invoice","href":"/api-reference/tax-spi/endpoints/v1/retrieve-invoice"},{"openapi":"post /invoices/{invoiceId}/commit","title":"Commit Invoice","href":"/api-reference/tax-spi/endpoints/v1/commit-invoice"},{"openapi":"post /invoices/{invoiceId}/void","title":"Void Invoice","href":"/api-reference/tax-spi/endpoints/v1/void-invoice"}]},{"group":"CreditNote","pages":[{"openapi":"post /credit-notes","title":"Create credit note","href":"/api-reference/tax-spi/endpoints/v1/create-credit-note"},{"openapi":"get /credit-notes/{creditNoteId}","title":"Retrieve credit note","href":"/api-reference/tax-spi/endpoints/v1/retrieve-credit-note"},{"openapi":"post /credit-notes/{creditNoteId}/commit","title":"Commit credit note","href":"/api-reference/tax-spi/endpoints/v1/commit-credit-note"},{"openapi":"post /credit-notes/{creditNoteId}/void","title":"Void credit note","href":"/api-reference/tax-spi/endpoints/v1/void-credit-note"}]},{"group":"Authentication","pages":[{"openapi":"post /credentials/validate","title":"Validate credentials","href":"/api-reference/tax-spi/endpoints/v1/validate-credentials"}]},{"group":"Health","pages":[{"openapi":"get /health","title":"Fetch the health status of the Service Provider.","href":"/api-reference/tax-spi/endpoints/v1/fetch-the-health-status-of-the-service-provider"}]},{"title":"Testing with Postman","href":"/api-reference/tax-spi/docs/testing-with-postman"}]},{"group":"Tax Registration Number Validation SPI","pages":[{"title":null,"href":"/api-reference/tax-reg-number-validate/docs/overview"},{"group":"Authentication","pages":[{"openapi":"post /credentials/validate","title":"Validate credentials","href":"/api-reference/tax-reg-number-validate/endpoints/v1/validate-credentials"}]},{"group":"Health","pages":[{"openapi":"get /health","title":"Fetch the health status of the Service Provider.","href":"/api-reference/tax-reg-number-validate/endpoints/v1/fetch-the-health-status-of-the-service-provider"}]},{"group":"Tax Registration Number Validation","pages":[{"openapi":"post /trn/validate/batch","title":"Validate the tax registration numbers in batch","href":"/api-reference/tax-reg-number-validate/endpoints/v1/validate-the-tax-registration-numbers-in-batch"},{"openapi":"post /trn/validate","title":"Validate the tax registration number","href":"/api-reference/tax-reg-number-validate/endpoints/v1/validate-the-tax-registration-number"},{"openapi":"get /trn/validate/{requestId}","title":"Get the response of tax registration number validate request","href":"/api-reference/tax-reg-number-validate/endpoints/v1/get-the-response-of-tax-registration-number-validate-request"},{"openapi":"get /trn/validate/batch/{batchId}","title":"Get the response of batch of tax registration numbers","href":"/api-reference/tax-reg-number-validate/endpoints/v1/get-the-response-of-batch-of-tax-registration-numbers"},{"openapi":"delete /trn/validate/batch/{batchId}","title":"Delete the request of batch of tax registration numbers validation","href":"/api-reference/tax-reg-number-validate/endpoints/v1/delete-the-request-of-batch-of-tax-registration-numbers-validation"}]},{"title":"Testing with Postman","href":"/api-reference/tax-reg-number-validate/docs/testing-with-postman"}]},{"group":"Einvoicing SPI","pages":[{"title":null,"href":"/api-reference/einvoicing-spi/docs/overview"},{"group":"Authorization","pages":[{"title":null,"href":"/api-reference/einvoicing-spi/docs/authorization/overview"},{"title":"Chargebee to Adapter (Header-Based Auth)","href":"/api-reference/einvoicing-spi/docs/authorization/chargebee_to_adapter"},{"title":"Adapter to Chargebee(OAuth 2.0)","href":"/api-reference/einvoicing-spi/docs/authorization/adapter_to_chargebee"}]},{"group":"Activations","pages":[{"openapi":"get /einvoicing/activations","title":"Retrieve a list of Activations.","href":"/api-reference/einvoicing-spi/endpoints/v1/activations/retrieve-a-list-of-activations"},{"openapi":"get /einvoicing/data_input_fields","title":"Retrieves data input fields","href":"/api-reference/einvoicing-spi/endpoints/v1/activations/retrieves-data-input-fields"}]},{"group":"Documents","pages":[{"openapi":"post /einvoicing/documents","title":"Submit a document","href":"/api-reference/einvoicing-spi/endpoints/v1/documents/submit-a-document"},{"openapi":"get /einvoicing/documents/{document_id}/status","title":"Get Document Status","href":"/api-reference/einvoicing-spi/endpoints/v1/documents/get-document-status"},{"openapi":"get /einvoicing/documents/{document_id}/download","title":"Download Document","href":"/api-reference/einvoicing-spi/endpoints/v1/documents/download-document"}]},{"group":"Callbacks","pages":[{"openapi":"post /api/v2/invoices/{document_id}/einvoice_status","title":"Receive document status updates for an invoice","href":"/api-reference/einvoicing-spi/endpoints/v1/callbacks/receive-document-status-updates-for-invoice"},{"openapi":"post /api/v2/credit_notes/{document_id}/einvoice_status","title":"Receive document status updates for a credit note","href":"/api-reference/einvoicing-spi/endpoints/v1/callbacks/receive-document-status-updates-for-credit-note"}]},{"group":"Authentication","pages":[{"openapi":"post /credentials/validate","title":"Validate credentials","href":"/api-reference/common/validate-credentials"}]},{"group":"Health","pages":[{"openapi":"get /health","title":"Fetch the health status of the Service Provider.","href":"/api-reference/common/fetch-the-health-status-of-the-service-provider"}]},{"title":"Testing with Postman","href":"/api-reference/einvoicing-spi/docs/testing-with-postman"}]},{"group":"Troubleshooting","pages":[{"title":null,"href":"/api-reference/troubleshooting"}]}]},{"tab":"App Onboarding","pages":[{"title":"App Onboarding","href":"/app-onboarding/guide"}]}]},"basePath":"","title":"Address validation - Chargebee Partner docs","buildId":"dpl_345ReqzYaAjzS9QpeJemsKdb7KDj","deploymentId":"dpl_345ReqzYaAjzS9QpeJemsKdb7KDj","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-C8RPHPxo.js","utils-0BK-9q6z.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-DfjzsUJT.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-B4v9psJ4.js","snippetPresets-CpTQv-Ez.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","ApiExamples-BNP-Fvr0.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-BSgu6h1D.js","shallow-Biv1i9Gs.js","getApiPlaygroundDisplay-BoGOXhtF.js","CodeSnippet-DvQoT18_.js","CodeSnippets-Dnpa15xT.js","Page-Buji1S4J.js","getPastedJson-xAIyhUFE.js","icon-S6FBih11.js","MethodPill-SaYeUZyk.js","DuplicateIcon-Cs-p3v2Q.js","createIcon-DjCFEoHq.js","DynamicMarkdown-BcnBltEQ.js","SectionHeading-BUBl0eEF.js","axios-vUo_bRtp.js","Markdown-h4cOoD8d.js","clsx-B2v50t8t.js","lib-DuNMoZ05.js","lib-B8HbPgcC.js","html-void-elements-mCSPHezU.js","dist-DJnKvr0g.js","katex-YMM-FMeD.js","marked.esm-CZWythHk.js","AssistantPageLink-BHrrjR1K.js"]}