{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"SVRN Client API","description":"Reference documentation for the sequential client flow: authentication, onboarding, due diligence, and reconciliation.","colors":{"primary":"#0F766E"},"favicon":"https://mintcdn.com/svrndigitalinc/nTa00tYaJusC8G4T/images/favicon.png?fit=max\u0026auto=format\u0026n=nTa00tYaJusC8G4T\u0026q=85\u0026s=e8c46ba5242817328433ec5f6c167ccd","styling":{"latex":false},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"svrndigitalinc","hasAudioNarration":false,"actualSubdomain":"svrndigitalinc","customDomains":["docs.svrn.digital"],"gitSource":{"type":"github","owner":"lparisi","repo":"svrn-infra","deployBranch":"feature/create_users_and_api_token","contentDirectory":"","isPrivate":true,"mountPath":"","label":""},"chroma":{"liveDeploymentHistoryId":"6a20d85e861763af883d2300","collectionId":"e7d5f61d-2fc0-4dae-b8a5-9cde733f4fae","schemaVersion":"v2"},"entitlements":{"AI_CHAT":{"status":"DISABLED"}},"buildId":"6a20d85e861763af883d2300:success","clientVersion":"0.0.4043","searchFilterCounts":[{"language":"default","tag":"API Reference","count":18},{"language":"default","tag":"Onboarding","count":7},{"language":"default","tag":"Due Diligence","count":5},{"language":"default","tag":"Reconciliation","count":4},{"language":"default","tag":"Overview","count":3},{"language":"default","tag":"Authentication","count":2}]},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":false,"enableContextualStarterQuestions":false,"enableAskAiSearchBar":true},"basePath":"","hasChatPermissions":false,"hasWebMcpPermissions":false,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"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}],"googleFontsInlined":false},"customCss":[],"page":{"pagePath":"api-reference/02-onboarding/create-a-customer-and-start-svrn-onboarding","slug":"/api-reference/02-onboarding/create-a-customer-and-start-svrn-onboarding","pageMetadata":{"title":"Create a customer and start SVRN onboarding","description":null,"deprecated":null,"version":null,"openapi":"/contracts/svrn-integration-api.json post /onboarding","href":"/api-reference/02-onboarding/create-a-customer-and-start-svrn-onboarding","autogeneratedByOpenApi":true},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){return _jsx(_Fragment,{})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"Create a customer and start SVRN onboarding","description":null,"deprecated":null,"version":null,"openapi":"/contracts/svrn-integration-api.json post /onboarding","href":"/api-reference/02-onboarding/create-a-customer-and-start-svrn-onboarding","autogeneratedByOpenApi":true}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":[],"openApiReferenceData":{"operation":{"tags":["02 Onboarding"],"summary":"Create a customer and start SVRN onboarding","operationId":"createCustomer","requestBody":"f53da71c-1a50-4207-9c9e-2b3c28c11146","responses":{"201":"03bed5df-5089-41e4-a83b-2f32b42ee6bb","400":"8db75432-775b-4c97-8f7b-5c7747a8fcd5","409":"673ba3c3-5770-44bd-9cd4-401b97b843ef","502":"53e15219-4782-4e3e-89be-e6da95c3dc1c"},"method":"post","type":"path","servers":["6da5bfa9-4175-429a-8bf0-9007fd505a8e","2c913319-c06a-4e08-9904-4ede642b051d"],"security":["712192eb-84ac-4ee9-ac91-79b498325bda"],"path":"/onboarding","baseUrlOptions":["https://api.sandbox.svrn.digital","https://api.svrn.digital"],"title":"Create a customer and start SVRN onboarding","description":"","codeSamples":[],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{},"requestBody":{"required":true,"content":{"application/json":{"schema":{"oneOf":[{"type":"object","required":["type","role","name","tax_id","birth_date","email","country"],"example":{"type":"INDIVIDUAL","role":"ARTIST","name":"Test Artist","tax_id":"123.456.789-00","birth_date":"1995-09-18","email":"[email protected]","country":"BRA","metadata":{"segment":"artist-manual-test"}},"properties":{"type":{"type":"string","enum":["INDIVIDUAL"],"isRequired":true,"uniqueKey":"oneOf.0.type","typeLabel":"enum\u003cstring>"},"role":{"type":"string","enum":["ARTIST","LABEL"],"isRequired":true,"uniqueKey":"oneOf.0.role","typeLabel":"enum\u003cstring>"},"name":{"type":"string","isRequired":true,"uniqueKey":"oneOf.0.name","typeLabel":"string"},"tax_id":{"type":"string","isRequired":true,"uniqueKey":"oneOf.0.tax_id","typeLabel":"string"},"birth_date":{"type":"string","format":"date","isRequired":true,"uniqueKey":"oneOf.0.birth_date","typeLabel":"string\u003cdate>"},"email":{"type":"string","format":"email","isRequired":true,"uniqueKey":"oneOf.0.email","typeLabel":"string\u003cemail>"},"country":{"type":"string","example":"BRA","isRequired":true,"uniqueKey":"oneOf.0.country","typeLabel":"string"},"metadata":{"type":"object","additionalProperties":true,"uniqueKey":"oneOf.0.metadata","typeLabel":"object"},"idempotency_key":{"type":"string","uniqueKey":"oneOf.0.idempotency_key","typeLabel":"string"}},"uniqueKey":"oneOf.0","typeLabel":"object"},{"type":"object","required":["type","role","legal_name","tax_id","incorporation_date","email","country"],"example":{"type":"BUSINESS","role":"LABEL","legal_name":"Label LTDA","tax_id":"12.345.678/0001-99","incorporation_date":"2020-06-01","email":"[email protected]","country":"BRA","metadata":{"segment":"label-manual-test"}},"properties":{"type":{"type":"string","enum":["BUSINESS"],"isRequired":true,"uniqueKey":"oneOf.1.type","typeLabel":"enum\u003cstring>"},"role":{"type":"string","enum":["ARTIST","LABEL"],"isRequired":true,"uniqueKey":"oneOf.1.role","typeLabel":"enum\u003cstring>"},"legal_name":{"type":"string","isRequired":true,"uniqueKey":"oneOf.1.legal_name","typeLabel":"string"},"tax_id":{"type":"string","isRequired":true,"uniqueKey":"oneOf.1.tax_id","typeLabel":"string"},"incorporation_date":{"type":"string","format":"date","isRequired":true,"uniqueKey":"oneOf.1.incorporation_date","typeLabel":"string\u003cdate>"},"email":{"type":"string","format":"email","isRequired":true,"uniqueKey":"oneOf.1.email","typeLabel":"string\u003cemail>"},"country":{"type":"string","example":"BRA","isRequired":true,"uniqueKey":"oneOf.1.country","typeLabel":"string"},"metadata":{"type":"object","additionalProperties":true,"uniqueKey":"oneOf.1.metadata","typeLabel":"object"},"idempotency_key":{"type":"string","uniqueKey":"oneOf.1.idempotency_key","typeLabel":"string"}},"uniqueKey":"oneOf.1","typeLabel":"object"}],"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"type":"INDIVIDUAL","role":"ARTIST","name":"Test Artist","tax_id":"123.456.789-00","birth_date":"1995-09-18","email":"[email protected]","country":"BRA","metadata":{"segment":"artist-manual-test"}}}},"exampleType":"generated"}},"exampleType":"generated"},"responses":{"03bed5df-5089-41e4-a83b-2f32b42ee6bb":{"description":"Customer created and onboarding started.","content":{"application/json":{"schema":{"type":"object","required":["customer_id","partner_id","lumx_customer_id","type","role","customer_name","email","kyc_status"],"properties":{"customer_id":{"type":"string","format":"uuid","isRequired":true,"uniqueKey":"customer_id","typeLabel":"string\u003cuuid>"},"partner_id":{"type":"string","format":"uuid","isRequired":true,"uniqueKey":"partner_id","typeLabel":"string\u003cuuid>"},"lumx_customer_id":{"type":"string","isRequired":true,"uniqueKey":"lumx_customer_id","typeLabel":"string"},"type":{"type":"string","isRequired":true,"uniqueKey":"type","typeLabel":"string"},"role":{"type":"string","isRequired":true,"uniqueKey":"role","typeLabel":"string"},"customer_name":{"type":"string","isRequired":true,"uniqueKey":"customer_name","typeLabel":"string"},"email":{"type":"string","format":"email","isRequired":true,"uniqueKey":"email","typeLabel":"string\u003cemail>"},"kyc_status":{"type":"string","isRequired":true,"uniqueKey":"kyc_status","typeLabel":"string"},"verification_link":{"type":"string","uniqueKey":"verification_link","typeLabel":"string"},"default_wallet":{"type":"string","uniqueKey":"default_wallet","typeLabel":"string"},"wallets":{"type":"array","items":{"type":"object","properties":{"address":{"type":"string","uniqueKey":"wallets.items.[INDEX].address","typeLabel":"string"},"blockchain":{"type":"string","uniqueKey":"wallets.items.[INDEX].blockchain","typeLabel":"string"},"default":{"type":"boolean","uniqueKey":"wallets.items.[INDEX].default","typeLabel":"boolean"},"isDefault":{"type":"boolean","uniqueKey":"wallets.items.[INDEX].isDefault","typeLabel":"boolean"},"blockExplorerUrl":{"type":"string","format":"uri","uniqueKey":"wallets.items.[INDEX].blockExplorerUrl","typeLabel":"string\u003curi>"}},"additionalProperties":true,"uniqueKey":"wallets.items.[INDEX]","typeLabel":"object"},"uniqueKey":"wallets","typeLabel":"object[]"},"requirements":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string","uniqueKey":"requirements.items.[INDEX].name","typeLabel":"string"},"status":{"type":"string","uniqueKey":"requirements.items.[INDEX].status","typeLabel":"string"}},"additionalProperties":true,"uniqueKey":"requirements.items.[INDEX]","typeLabel":"object"},"uniqueKey":"requirements","typeLabel":"object[]"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"customer_id":"3c90c3cc-0d44-4b50-8888-8dd25736052a","partner_id":"3c90c3cc-0d44-4b50-8888-8dd25736052a","lumx_customer_id":"\u003cstring>","type":"\u003cstring>","role":"\u003cstring>","customer_name":"\u003cstring>","email":"[email protected]","kyc_status":"\u003cstring>","verification_link":"\u003cstring>","default_wallet":"\u003cstring>","wallets":[{"address":"\u003cstring>","blockchain":"\u003cstring>","default":true,"isDefault":true,"blockExplorerUrl":"\u003cstring>"}],"requirements":[{"name":"\u003cstring>","status":"\u003cstring>"}]}}},"exampleType":"generated"}},"exampleType":"generated"},"8db75432-775b-4c97-8f7b-5c7747a8fcd5":{"description":"Bad request.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","isRequired":true,"uniqueKey":"error","typeLabel":"string"},"message":{"type":"string","uniqueKey":"message","typeLabel":"string"}},"example":{"error":"MISSING_FIELD","message":"artist.customer_id is required"},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":"MISSING_FIELD","message":"artist.customer_id is required"}}},"exampleType":"generated"}},"exampleType":"generated"},"673ba3c3-5770-44bd-9cd4-401b97b843ef":{"description":"The request conflicts with the current workflow state.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","isRequired":true,"uniqueKey":"error","typeLabel":"string"},"message":{"type":"string","uniqueKey":"message","typeLabel":"string"}},"example":{"error":"MISSING_FIELD","message":"artist.customer_id is required"},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":"MISSING_FIELD","message":"artist.customer_id is required"}}},"exampleType":"generated"}},"exampleType":"generated"},"53e15219-4782-4e3e-89be-e6da95c3dc1c":{"description":"Upstream provider error.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","isRequired":true,"uniqueKey":"error","typeLabel":"string"},"message":{"type":"string","uniqueKey":"message","typeLabel":"string"}},"example":{"error":"MISSING_FIELD","message":"artist.customer_id is required"},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":"MISSING_FIELD","message":"artist.customer_id is required"}}},"exampleType":"generated"}},"exampleType":"generated"}},"security":{"712192eb-84ac-4ee9-ac91-79b498325bda":{"bearerAuth":{"type":"http","scheme":"bearer","bearerFormat":"JWT","scopes":[]}}},"servers":{"6da5bfa9-4175-429a-8bf0-9007fd505a8e":{"url":"https://api.sandbox.svrn.digital","description":"Sandbox"},"2c913319-c06a-4e08-9904-4ede642b051d":{"url":"https://api.svrn.digital","description":"Production"}},"processedSecurityOptions":[{"schemes":[{"scheme":{"type":"http","scheme":"bearer","bearerFormat":"JWT","scopes":[]},"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":"contracts/svrn-integration-api.json"},"subdomain":"svrndigitalinc","siteName":"SVRN Client API","title":"Create a customer and start SVRN onboarding - SVRN Client API","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-04-28T11:10:58.478Z","originalFileLocation":"api-reference/02-onboarding/create-a-customer-and-start-svrn-onboarding.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=\"application-name\" content=\"SVRN Client 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/svrndigitalinc/LoquIojgTNaZm6Ol/_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/svrndigitalinc/LoquIojgTNaZm6Ol/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/svrndigitalinc/LoquIojgTNaZm6Ol/_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/svrndigitalinc/LoquIojgTNaZm6Ol/_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/svrndigitalinc/LoquIojgTNaZm6Ol/_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/svrndigitalinc/LoquIojgTNaZm6Ol/_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/svrndigitalinc/LoquIojgTNaZm6Ol/_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/svrndigitalinc/LoquIojgTNaZm6Ol/_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/svrndigitalinc/LoquIojgTNaZm6Ol/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Create a customer and start SVRN onboarding - SVRN Client API\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"SVRN Client API\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.svrn.digital/api-reference/02-onboarding/create-a-customer-and-start-svrn-onboarding\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://svrndigitalinc.mintlify.app/_mintlify/api/og/v2?division=Onboarding\u0026amp;title=Create+a+customer+and+start+SVRN+onboarding\u0026amp;theme=2b1688a329860e6affb861ba\u0026amp;signature=35e3d456a15d7155301dbf080fb7c073b61d24b4c119556133c971eafa3ed1e1\">\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 a customer and start SVRN onboarding - SVRN Client API\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://svrndigitalinc.mintlify.app/_mintlify/api/og/v2?division=Onboarding\u0026amp;title=Create+a+customer+and+start+SVRN+onboarding\u0026amp;theme=2b1688a329860e6affb861ba\u0026amp;signature=35e3d456a15d7155301dbf080fb7c073b61d24b4c119556133c971eafa3ed1e1\">\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/svrndigitalinc/LoquIojgTNaZm6Ol/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"SVRN Client API\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#0F766E\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.svrn.digital/api-reference/02-onboarding/create-a-customer-and-start-svrn-onboarding\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/api-reference/02-onboarding/create-a-customer-and-start-svrn-onboarding.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.svrn.digital/#organization\",\"name\":\"SVRN Client API\",\"url\":\"https://docs.svrn.digital\"},{\"@type\":\"WebSite\",\"@id\":\"https://docs.svrn.digital#website\",\"name\":\"SVRN Client API\",\"url\":\"https://docs.svrn.digital\",\"publisher\":{\"@id\":\"https://docs.svrn.digital/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.svrn.digital/api-reference/02-onboarding/create-a-customer-and-start-svrn-onboarding#webpage\",\"url\":\"https://docs.svrn.digital/api-reference/02-onboarding/create-a-customer-and-start-svrn-onboarding\",\"name\":\"Create a customer and start SVRN onboarding\",\"dateModified\":\"2026-04-28T11:10:58.478Z\",\"isPartOf\":{\"@id\":\"https://docs.svrn.digital#website\"},\"breadcrumb\":{\"@id\":\"https://docs.svrn.digital/api-reference/02-onboarding/create-a-customer-and-start-svrn-onboarding#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.svrn.digital/api-reference/02-onboarding/create-a-customer-and-start-svrn-onboarding#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"API Reference\",\"item\":\"https://docs.svrn.digital/authentication-guide\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Onboarding\",\"item\":\"https://docs.svrn.digital/onboarding-guide\"},{\"@type\":\"ListItem\",\"position\":3,\"name\":\"Create a customer and start SVRN onboarding\",\"item\":\"https://docs.svrn.digital/api-reference/02-onboarding/create-a-customer-and-start-svrn-onboarding\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.svrn.digital/api-reference/02-onboarding/create-a-customer-and-start-svrn-onboarding#apireference\",\"headline\":\"Create a customer and start SVRN onboarding\",\"name\":\"Create a customer and start SVRN onboarding\",\"url\":\"https://docs.svrn.digital/api-reference/02-onboarding/create-a-customer-and-start-svrn-onboarding\",\"mainEntityOfPage\":{\"@id\":\"https://docs.svrn.digital/api-reference/02-onboarding/create-a-customer-and-start-svrn-onboarding#webpage\"},\"dateModified\":\"2026-04-28T11:10:58.478Z\",\"publisher\":{\"@id\":\"https://docs.svrn.digital/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.svrn.digital#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"SVRN Client API\",\"creator\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","siteName":"SVRN Client API","nav":{"global":null,"groups":[{"group":"Overview","pages":[{"title":null,"href":"/index"},{"title":"API Overview","href":"/api-overview"},{"title":"Platform Workflow","href":"/architecture-overview"}]},{"group":"API Reference","pages":[{"group":"Authentication","pages":[{"title":"Overview","sidebarTitle":"Overview","href":"/authentication-guide"},{"title":"Exchange client credentials for a bearer token","deprecated":null,"version":null,"openapi":"/contracts/svrn-integration-api.json post /auth","href":"/api-reference/01-authentication/exchange-client-credentials-for-a-bearer-token"}]},{"group":"Onboarding","pages":[{"title":"Overview","sidebarTitle":"Overview","description":"Create customers, track KYC state, resume verification, and register artist PIX details.","href":"/onboarding-guide"},{"title":"Create a customer and start SVRN onboarding","deprecated":null,"version":null,"openapi":"/contracts/svrn-integration-api.json post /onboarding","href":"/api-reference/02-onboarding/create-a-customer-and-start-svrn-onboarding"},{"title":"List customers for the authenticated client","description":null,"deprecated":null,"version":null,"openapi":"/contracts/svrn-integration-api.json get /onboarding/list","href":"/api-reference/02-onboarding/list-customers-for-the-authenticated-client"},{"title":"Get a customer","deprecated":null,"version":null,"openapi":"/contracts/svrn-integration-api.json get /onboarding/{customer_id}","href":"/api-reference/02-onboarding/get-a-customer"},{"title":"Delete a customer","deprecated":null,"version":null,"openapi":"/contracts/svrn-integration-api.json delete /onboarding/{customer_id}","href":"/api-reference/02-onboarding/delete-a-customer"},{"title":"Resume verification for a customer","deprecated":null,"version":null,"openapi":"/contracts/svrn-integration-api.json post /onboarding/{customer_id}/resume-verification","href":"/api-reference/02-onboarding/resume-verification-for-a-customer"},{"title":"Register or replace an artist PIX bank account","deprecated":null,"version":null,"openapi":"/contracts/svrn-integration-api.json post /onboarding/{customer_id}/create-bank-account","href":"/api-reference/02-onboarding/register-or-replace-an-artist-pix-bank-account"}]},{"group":"Due Diligence","pages":[{"title":"Overview","sidebarTitle":"Overview","href":"/due-diligence-guide"},{"title":"Initialize a due diligence case","deprecated":null,"version":null,"openapi":"/contracts/svrn-integration-api.json post /due-diligence/init","href":"/api-reference/03-due-diligence/initialize-a-due-diligence-case"},{"title":"Get a due diligence case","deprecated":null,"version":null,"openapi":"/contracts/svrn-integration-api.json get /due-diligence/{due_diligence_id}","href":"/api-reference/03-due-diligence/get-a-due-diligence-case"},{"title":"Request presigned upload URLs for due diligence files","deprecated":null,"version":null,"openapi":"/contracts/svrn-integration-api.json post /due-diligence/{due_diligence_id}/uploads","href":"/api-reference/03-due-diligence/request-presigned-upload-urls-for-due-diligence-files"},{"title":"Publish a credit offer for a due diligence case","deprecated":null,"version":null,"openapi":"/contracts/svrn-integration-api.json post /due-diligence/{due_diligence_id}/credit-offer","href":"/api-reference/03-due-diligence/publish-a-credit-offer-for-a-due-diligence-case"}]},{"group":"Reconciliation","pages":[{"title":"Overview","sidebarTitle":"Overview","href":"/reconciliation-guide"},{"title":"Initialize a reconciliation for a contract","deprecated":null,"version":null,"openapi":"/contracts/svrn-integration-api.json post /contracts/reconciliations/init","href":"/api-reference/04-reconciliation/initialize-a-reconciliation-for-a-contract"},{"title":"Get a reconciliation","deprecated":null,"version":null,"openapi":"/contracts/svrn-integration-api.json get /contracts/{contract_id}/reconciliations/{reconciliation_id}","href":"/api-reference/04-reconciliation/get-a-reconciliation"},{"title":"Request presigned upload URLs for reconciliation files","deprecated":null,"version":null,"openapi":"/contracts/svrn-integration-api.json post /contracts/{contract_id}/reconciliations/{reconciliation_id}/uploads","href":"/api-reference/04-reconciliation/request-presigned-upload-urls-for-reconciliation-files"}]}]}]},"basePath":"","title":"Create a customer and start SVRN onboarding - SVRN Client API","buildId":"dpl_G9nrg4qeJSZtah1Ziwbc2n6WkLch","deploymentId":"dpl_G9nrg4qeJSZtah1Ziwbc2n6WkLch","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-B7XKH4J3.js","utils-lOYzL7z-.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-DF6jUUIM.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-Dpsj5f7C.js","snippetPresets-CYeiDe8v.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","ApiExamples-CUFz1YZ_.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-D8H_iLS4.js","shallow-DdluZBHX.js","getApiPlaygroundDisplay-B9922vev.js","CodeSnippet-CMoRNGYs.js","CodeSnippets-DwyrPHuw.js","Page-DSVu9Ucl.js","getPastedJson-G-zIvlHh.js","icon-B03fnEy0.js","MethodPill-CW7teklc.js","DuplicateIcon-CtO8eekd.js","createIcon-DZTKdM_A.js","DynamicMarkdown-D5M2At0B.js","SectionHeading-C_2NaA2U.js","axios-vUo_bRtp.js","Markdown-D7QRHV3m.js","clsx-D1Z-ELXV.js","lib-DuNMoZ05.js","lib-B8HbPgcC.js","html-void-elements-mCSPHezU.js","dist-lvhuD9Du.js","katex-YMM-FMeD.js","marked.esm-CZWythHk.js","AssistantPageLink-CKfC4ywL.js"]}