Submits the applicant for identity verification. Verification completes in the background (returns immediately). Poll GET /v1/applicants//kyc-status until status is APPROVED, or subscribe to the applicant.status_changed webhook.
An end-user or business. Provider-internal identity references are white-labeled away.
Show child attributes
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Apocor Cards API","description":"The white-labeled API for issuing and managing cards on Apocor.","colors":{"primary":"#5B5BD6","light":"#8B8BF0","dark":"#4B3FC4"},"logo":{"light":"https://mintcdn.com/apocor/n0XJA8mr23N-d9qT/logo/light.svg?fit=max\u0026auto=format\u0026n=n0XJA8mr23N-d9qT\u0026q=85\u0026s=2843fb34569e52dd5b96fd8a762ddda8","dark":"https://mintcdn.com/apocor/n0XJA8mr23N-d9qT/logo/dark.svg?fit=max\u0026auto=format\u0026n=n0XJA8mr23N-d9qT\u0026q=85\u0026s=26e93d8e95d4177a4b18be7e1891122b"},"favicon":"https://mintcdn.com/apocor/n0XJA8mr23N-d9qT/favicon.svg?fit=max\u0026auto=format\u0026n=n0XJA8mr23N-d9qT\u0026q=85\u0026s=ebe9bf0cc0c6e55dfef57713a8c2dbf6","api":{"playground":{"display":"interactive","proxy":false},"mdx":{"server":"https://sandbox.apocor.ai"}},"navbar":{"primary":{"type":"button","label":"Dashboard","href":"https://dashboard.apocor.ai"}},"footer":{"socials":{"website":"https://apocor.ai"}},"styling":{"latex":false},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"apocor","hasAudioNarration":false,"actualSubdomain":"apocor","customDomains":["docs.apocor.ai"],"gitSource":{"type":"github","owner":"apocor-ai","repo":"apocor-api-docs","deployBranch":"main","contentDirectory":"","isPrivate":true,"mountPath":"","label":""},"chroma":{"collectionId":"f2d1f68a-3d71-4d33-8c17-47e699ee3e99","liveDeploymentHistoryId":"6aa471267c2d129df87be4d9","schemaVersion":"v3","latestBuiltDeploymentHistoryId":"6aa471267c2d129df87be4d9"},"entitlements":{"AI_CHAT":{"status":"DISABLED"}},"buildId":"6aa471267c2d129df87be4d9","clientVersion":"0.0.4054","searchFilterCounts":[{"language":"default","tag":"API Reference","count":67},{"language":"default","tag":"Documentation","count":12},{"language":"default","tag":"Identity verification (KYC)","count":12},{"language":"default","tag":"Cards — lifecycle","count":12},{"language":"default","tag":"Funding accounts","count":9},{"language":"default","tag":"Core concepts","count":6},{"language":"default","tag":"Webhooks \u0026 events","count":6},{"language":"default","tag":"Cards — issue","count":6},{"language":"default","tag":"Card funding (wallet \u0026 BYO)","count":4},{"language":"default","tag":"Cardholders","count":4}]},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":false,"enableContextualStarterQuestions":false,"enableAskAiSearchBar":true},"basePath":"","hasChatPermissions":false,"hasWebMcpPermissions":false,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"rbac-expansion","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"full-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"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":"turbopuffer-serve","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[],"page":{"pagePath":"api-reference/applicants/submit-for-kyc","slug":"/api-reference/applicants/submit-for-kyc","pageMetadata":{"title":"Submit for KYC","description":"Submits the applicant for identity verification. Verification completes in the background (returns immediately). Poll GET /v1/applicants/{id}/kyc-status until status is APPROVED, or subscribe to the applicant.status_changed webhook.","deprecated":null,"version":null,"openapi":"/openapi.json post /v1/applicants/{id}/submit","href":"/api-reference/applicants/submit-for-kyc","autogeneratedByOpenApi":true},"description":{"compiledSource":"\"use strict\";\nconst {jsx: _jsx, jsxs: _jsxs} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsxs(_components.p, {\n children: [\"Submits the applicant for identity verification. Verification completes in the background (returns immediately). Poll GET /v1/applicants/\", \"/kyc-status until status is APPROVED, or subscribe to the applicant.status_changed webhook.\"]\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":{"title":"Submit for KYC","description":"Submits the applicant for identity verification. Verification completes in the background (returns immediately). Poll GET /v1/applicants/{id}/kyc-status until status is APPROVED, or subscribe to the applicant.status_changed webhook.","deprecated":null,"version":null,"openapi":"/openapi.json post /v1/applicants/{id}/submit","href":"/api-reference/applicants/submit-for-kyc","autogeneratedByOpenApi":true}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":[],"openApiReferenceData":{"operation":{"tags":["Applicants","KYC"],"summary":"Submit for KYC","description":"Submits the applicant for identity verification. Verification completes in the background (returns immediately). Poll GET /v1/applicants/{id}/kyc-status until status is APPROVED, or subscribe to the applicant.status_changed webhook.","parameters":["d163b1a6-5712-4df2-b6dc-aa9d991076c6"],"responses":{"200":"c92fc843-724f-488a-87e8-37cb132f615b"},"operationId":"createApplicantsByIdSubmit","method":"post","type":"path","servers":["92bda58d-22ab-4e67-b1eb-8abdab45434f","a14df27f-5b60-4a9b-b0f7-59b1ed8d9839","8b6bdf38-81dc-409a-90fe-aeb1fdc65acd"],"security":["84389afe-be21-4f03-9bd1-a374d13f37e8"],"path":"/v1/applicants/{id}/submit","baseUrlOptions":["https://sandbox.apocor.ai","https://api.apocor.ai","http://localhost:4000"],"title":"Submit for KYC","codeSamples":[],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated","disableProxy":true},"dependencies":{"parameters":{"d163b1a6-5712-4df2-b6dc-aa9d991076c6":{"name":"id","in":"path","required":true,"schema":{"type":"string","isRequired":true,"description":"Resource identifier.","uniqueKey":"","typeLabel":"string"},"description":"Resource identifier."}},"responses":{"c92fc843-724f-488a-87e8-37cb132f615b":{"description":"Updated applicant.","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","description":"An end-user or business. Provider-internal identity references are white-labeled away.","properties":{"id":{"type":"string","uniqueKey":"data.id","typeLabel":"string"},"orgId":{"type":"string","uniqueKey":"data.orgId","typeLabel":"string"},"type":{"type":"string","enum":["PERSON","BUSINESS"],"uniqueKey":"data.type","typeLabel":"enum\u003cstring>"},"status":{"type":"string","enum":["PENDING","APPROVED","REVIEW","REJECTED"],"description":"Single verification verdict. APPROVED means the applicant has fully passed identity verification and cards can be issued. PENDING covers every in-progress stage; REVIEW means the application needs attention; REJECTED is terminal.","uniqueKey":"data.status","typeLabel":"enum\u003cstring>"},"email":{"oneOf":[{"type":"string","uniqueKey":"data.email.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"data.email.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.email","typeLabel":"string | null"},"data":{"type":"object","additionalProperties":true,"uniqueKey":"data.data","typeLabel":"object"},"createdAt":{"type":"string","format":"date-time","uniqueKey":"data.createdAt","typeLabel":"string\u003cdate-time>"}},"uniqueKey":"data","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"data":{"id":"\u003cstring>","orgId":"\u003cstring>","type":"PERSON","status":"PENDING","email":"\u003cstring>","data":{},"createdAt":"2023-11-07T05:31:56Z"}}}},"exampleType":"generated"}},"exampleType":"generated"}},"security":{"84389afe-be21-4f03-9bd1-a374d13f37e8":{"bearerAuth":{"type":"http","scheme":"bearer","bearerFormat":"JWT","description":"Bearer access token obtained from `POST /v1/oauth/token` using your Apocor API key.","scopes":[]}}},"servers":{"92bda58d-22ab-4e67-b1eb-8abdab45434f":{"url":"https://sandbox.apocor.ai","description":"Sandbox (live)"},"a14df27f-5b60-4a9b-b0f7-59b1ed8d9839":{"url":"https://api.apocor.ai","description":"Production"},"8b6bdf38-81dc-409a-90fe-aeb1fdc65acd":{"url":"http://localhost:4000","description":"Local development"}},"processedSecurityOptions":[{"schemes":[{"scheme":{"type":"http","scheme":"bearer","bearerFormat":"JWT","description":"Bearer access token obtained from `POST /v1/oauth/token` using your Apocor API key.","scopes":[]},"schema":{"title":"Bearer Auth","type":"string","isRequired":true,"description":"Bearer access token obtained from `POST /v1/oauth/token` using your Apocor API key.","format":"bearer","typeLabel":"string\u003cbearer>","deprecated":false},"schemeName":"bearerAuth","name":"Authorization"}],"title":"bearerAuth"}]},"originalFileLocation":"openapi.json"},"subdomain":"apocor","siteName":"Apocor Cards API","title":"Submit for KYC - Apocor Cards API","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-09-11T21:22:59.360Z","originalFileLocation":"api-reference/applicants/submit-for-kyc.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=\"Submits the applicant for identity verification. Verification completes in the background (returns immediately). Poll GET /v1/applicants/{id}/kyc-status until status is APPROVED, or subscribe to the applicant.status_changed webhook.\">\u003cmeta data-mint-head name=\"application-name\" content=\"Apocor Cards 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/apocor/7nZXwR9d99HSOGLD/_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/apocor/7nZXwR9d99HSOGLD/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/apocor/7nZXwR9d99HSOGLD/_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/apocor/7nZXwR9d99HSOGLD/_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/apocor/7nZXwR9d99HSOGLD/_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/apocor/7nZXwR9d99HSOGLD/_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/apocor/7nZXwR9d99HSOGLD/_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/apocor/7nZXwR9d99HSOGLD/_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/apocor/7nZXwR9d99HSOGLD/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Submit for KYC - Apocor Cards API\">\u003cmeta data-mint-head property=\"og:description\" content=\"Submits the applicant for identity verification. Verification completes in the background (returns immediately). Poll GET /v1/applicants/{id}/kyc-status until status is APPROVED, or subscribe to the applicant.status_changed webhook.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Apocor Cards API\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.apocor.ai/api-reference/applicants/submit-for-kyc\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://apocor.mintlify.app/_mintlify/api/og/v2?division=Identity+verification+%28KYC%29\u0026amp;title=Submit+for+KYC\u0026amp;description=Submits+the+applicant+for+identity+verification.+Verification+completes+in+the+background+%28returns+immediately%29.+Poll+GET+%2Fv1%2Fapplicants%2F%7Bid%7D%2Fkyc-status+until+s\u0026amp;theme=88149093ee09a2f63e7e8a96\u0026amp;signature=e8179468bd210026584553e454c6a17b66d4f6493f04d3ba4de429c421ad69f8\">\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=\"Submit for KYC - Apocor Cards API\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Submits the applicant for identity verification. Verification completes in the background (returns immediately). Poll GET /v1/applicants/{id}/kyc-status until status is APPROVED, or subscribe to the applicant.status_changed webhook.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://apocor.mintlify.app/_mintlify/api/og/v2?division=Identity+verification+%28KYC%29\u0026amp;title=Submit+for+KYC\u0026amp;description=Submits+the+applicant+for+identity+verification.+Verification+completes+in+the+background+%28returns+immediately%29.+Poll+GET+%2Fv1%2Fapplicants%2F%7Bid%7D%2Fkyc-status+until+s\u0026amp;theme=88149093ee09a2f63e7e8a96\u0026amp;signature=e8179468bd210026584553e454c6a17b66d4f6493f04d3ba4de429c421ad69f8\">\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/apocor/7nZXwR9d99HSOGLD/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Apocor Cards API\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#5B5BD6\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.apocor.ai/api-reference/applicants/submit-for-kyc\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/api-reference/applicants/submit-for-kyc.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.apocor.ai/#organization\",\"name\":\"Apocor Cards API\",\"url\":\"https://docs.apocor.ai\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/apocor/n0XJA8mr23N-d9qT/logo/light.svg?fit=max\u0026auto=format\u0026n=n0XJA8mr23N-d9qT\u0026q=85\u0026s=2843fb34569e52dd5b96fd8a762ddda8\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.apocor.ai#website\",\"name\":\"Apocor Cards API\",\"url\":\"https://docs.apocor.ai\",\"publisher\":{\"@id\":\"https://docs.apocor.ai/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.apocor.ai/api-reference/applicants/submit-for-kyc#webpage\",\"url\":\"https://docs.apocor.ai/api-reference/applicants/submit-for-kyc\",\"name\":\"Submit for KYC\",\"description\":\"Submits the applicant for identity verification. Verification completes in the background (returns immediately). Poll GET /v1/applicants/{id}/kyc-status until status is APPROVED, or subscribe to the applicant.status_changed webhook.\",\"dateModified\":\"2026-09-11T21:22:59.360Z\",\"isPartOf\":{\"@id\":\"https://docs.apocor.ai#website\"},\"breadcrumb\":{\"@id\":\"https://docs.apocor.ai/api-reference/applicants/submit-for-kyc#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.apocor.ai/api-reference/applicants/submit-for-kyc#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Identity verification (KYC)\",\"item\":\"https://docs.apocor.ai/api-reference/kyc/kyc-integration-settings\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Submit for KYC\",\"item\":\"https://docs.apocor.ai/api-reference/applicants/submit-for-kyc\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.apocor.ai/api-reference/applicants/submit-for-kyc#apireference\",\"headline\":\"Submit for KYC\",\"name\":\"Submit for KYC\",\"description\":\"Submits the applicant for identity verification. Verification completes in the background (returns immediately). Poll GET /v1/applicants/{id}/kyc-status until status is APPROVED, or subscribe to the applicant.status_changed webhook.\",\"url\":\"https://docs.apocor.ai/api-reference/applicants/submit-for-kyc\",\"mainEntityOfPage\":{\"@id\":\"https://docs.apocor.ai/api-reference/applicants/submit-for-kyc#webpage\"},\"dateModified\":\"2026-09-11T21:22:59.360Z\",\"publisher\":{\"@id\":\"https://docs.apocor.ai/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.apocor.ai#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Apocor Cards API\",\"creator\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","siteName":"Apocor Cards API","nav":{"global":null,"tabs":[{"tab":"Documentation","pages":[{"title":"Documentation","href":""}]},{"tab":"API Reference","groups":[{"group":"Authentication","pages":[{"title":"Get an access token","deprecated":null,"version":null,"openapi":"/openapi.json post /v1/oauth/token","href":"/api-reference/authentication/get-an-access-token"}]},{"group":"Identity verification (KYC)","pages":[{"title":"KYC integration settings","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/kyc/config","href":"/api-reference/kyc/kyc-integration-settings"},{"title":"List applicants","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/applicants","href":"/api-reference/applicants/list-applicants"},{"title":"Create an applicant","deprecated":null,"version":null,"openapi":"/openapi.json post /v1/applicants","href":"/api-reference/applicants/create-an-applicant"},{"title":"Get an applicant","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/applicants/{id}","href":"/api-reference/applicants/get-an-applicant"},{"title":"Update applicant profile","description":"Merges allowlisted profile fields into the applicant. Contact fields (phone, etc.) can usually be updated. Identity fields (name, DOB, nationality, address) are locked after issuer KYC is complete or cards exist. `ssn` may be set once when missing (required for US card issuance after hosted KYC). Never changes status or issuer references.","deprecated":null,"version":null,"openapi":"/openapi.json patch /v1/applicants/{id}","href":"/api-reference/applicants/update-applicant-profile"},{"title":"Submit for KYC","deprecated":null,"version":null,"openapi":"/openapi.json post /v1/applicants/{id}/submit","href":"/api-reference/applicants/submit-for-kyc"},{"title":"Start a hosted KYC session","description":"Returns a short-lived access token for the hosted identity-verification widget and a direct hosted verificationUrl you can share with the applicant.","deprecated":null,"version":null,"openapi":"/openapi.json post /v1/applicants/{id}/kyc-session","href":"/api-reference/applicants/start-a-hosted-kyc-session"},{"title":"Share BYOK verification with the issuer","deprecated":null,"version":null,"openapi":"/openapi.json post /v1/applicants/{id}/kyc-share","href":"/api-reference/applicants/share-byok-verification-with-the-issuer"},{"title":"Presign a direct KYC document upload","deprecated":null,"version":null,"openapi":"/openapi.json post /v1/applicants/{id}/kyc-direct/uploads","href":"/api-reference/applicants/presign-a-direct-kyc-document-upload"},{"title":"Confirm a direct KYC document upload","deprecated":null,"version":null,"openapi":"/openapi.json post /v1/applicants/{id}/kyc-direct/uploads/complete","href":"/api-reference/applicants/confirm-a-direct-kyc-document-upload"},{"title":"Submit direct document KYC","deprecated":null,"version":null,"openapi":"/openapi.json post /v1/applicants/{id}/kyc-direct","href":"/api-reference/applicants/submit-direct-document-kyc"},{"title":"Refresh issuer KYC status","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/applicants/{id}/kyc-status","href":"/api-reference/applicants/refresh-issuer-kyc-status"}]},{"group":"Programs","pages":[{"title":"List programs","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/programs","href":"/api-reference/programs/list-programs"},{"title":"Create a program","deprecated":null,"version":null,"openapi":"/openapi.json post /v1/programs","href":"/api-reference/programs/create-a-program"},{"title":"Get a program","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/programs/{id}","href":"/api-reference/programs/get-a-program"}]},{"group":"Funding accounts","pages":[{"title":"List accounts","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/accounts","href":"/api-reference/accounts/list-accounts"},{"title":"Create an account","deprecated":null,"version":null,"openapi":"/openapi.json post /v1/accounts","href":"/api-reference/accounts/create-an-account"},{"title":"Get an account","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/accounts/{id}","href":"/api-reference/accounts/get-an-account"},{"title":"Update an account","deprecated":null,"version":null,"openapi":"/openapi.json patch /v1/accounts/{id}","href":"/api-reference/accounts/update-an-account"},{"title":"Get account balance","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/accounts/{id}/balance","href":"/api-reference/accounts/get-account-balance"},{"title":"Transfer funds to or from an account","deprecated":null,"version":null,"openapi":"/openapi.json post /v1/accounts/{id}/transfers","href":"/api-reference/accounts/transfer-funds-to-or-from-an-account"},{"title":"List budgets","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/accounts/{id}/budgets","href":"/api-reference/budgets/list-budgets"},{"title":"Create a budget","deprecated":null,"version":null,"openapi":"/openapi.json post /v1/accounts/{id}/budgets","href":"/api-reference/budgets/create-a-budget"},{"title":"Rename a budget","deprecated":null,"version":null,"openapi":"/openapi.json patch /v1/budgets/{id}","href":"/api-reference/budgets/rename-a-budget"}]},{"group":"Card funding (wallet \u0026 BYO)","pages":[{"title":"Get program card-funding mode","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/programs/{id}/funding-config","href":"/api-reference/card-funding/get-program-card-funding-mode"},{"title":"Set program card-funding mode","deprecated":null,"version":null,"openapi":"/openapi.json put /v1/programs/{id}/funding-config","href":"/api-reference/card-funding/set-program-card-funding-mode"},{"title":"Get card-funding deposit address","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/applicants/{id}/funding/deposit-address","href":"/api-reference/card-funding/get-card-funding-deposit-address"},{"title":"Get card-funding balances","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/applicants/{id}/funding/balances","href":"/api-reference/card-funding/get-card-funding-balances"},{"title":"Fund card from deposit wallet","deprecated":null,"version":null,"openapi":"/openapi.json post /v1/cards/{id}/fund-from-wallet","href":"/api-reference/card-funding/fund-card-from-deposit-wallet"},{"title":"Quote a withdrawal to an external crypto wallet","deprecated":null,"version":null,"openapi":"/openapi.json post /v1/cards/{id}/withdraw-to-wallet/quote","href":"/api-reference/card-funding/quote-a-withdrawal-to-an-external-crypto-wallet"},{"title":"Send leftover card funds to an external crypto wallet","deprecated":null,"version":null,"openapi":"/openapi.json post /v1/cards/{id}/withdraw-to-wallet","href":"/api-reference/card-funding/send-leftover-card-funds-to-an-external-crypto-wallet"},{"title":"Get a card withdrawal","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/cards/{id}/withdrawals/{withdrawalId}","href":"/api-reference/card-funding/get-a-card-withdrawal"}]},{"group":"Cardholders","pages":[{"title":"List cardholders","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/cardholders","href":"/api-reference/cardholders/list-cardholders"},{"title":"Create a cardholder","deprecated":null,"version":null,"openapi":"/openapi.json post /v1/cardholders","href":"/api-reference/cardholders/create-a-cardholder"},{"title":"Get a cardholder","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/cardholders/{id}","href":"/api-reference/cardholders/get-a-cardholder"},{"title":"Update a cardholder","deprecated":null,"version":null,"openapi":"/openapi.json patch /v1/cardholders/{id}","href":"/api-reference/cardholders/update-a-cardholder"}]},{"group":"Cards — issue","pages":[{"title":"List cards","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/cards","href":"/api-reference/cards/list-cards"},{"title":"Issue a card","deprecated":null,"version":null,"openapi":"/openapi.json post /v1/cards","href":"/api-reference/cards/issue-a-card"},{"title":"Get card issuance status","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/cards/issuances/{id}","href":"/api-reference/cards/get-card-issuance-status"},{"title":"Batch issue cards","deprecated":null,"version":null,"openapi":"/openapi.json post /v1/cards/batch","href":"/api-reference/cards/batch-issue-cards"},{"title":"Get batch task progress","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/cards/batch/{taskId}","href":"/api-reference/cards/get-batch-task-progress"},{"title":"Batch delete cards","deprecated":null,"version":null,"openapi":"/openapi.json post /v1/cards/batch-delete","href":"/api-reference/cards/batch-delete-cards"}]},{"group":"Cards — lifecycle","pages":[{"title":"Get a card","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/cards/{id}","href":"/api-reference/cards/get-a-card"},{"title":"Update a card","deprecated":null,"version":null,"openapi":"/openapi.json patch /v1/cards/{id}","href":"/api-reference/cards/update-a-card"},{"title":"Freeze a card","deprecated":null,"version":null,"openapi":"/openapi.json post /v1/cards/{id}/freeze","href":"/api-reference/cards/freeze-a-card"},{"title":"Unfreeze a card","deprecated":null,"version":null,"openapi":"/openapi.json post /v1/cards/{id}/unfreeze","href":"/api-reference/cards/unfreeze-a-card"},{"title":"Activate a card","deprecated":null,"version":null,"openapi":"/openapi.json post /v1/cards/{id}/activate","href":"/api-reference/cards/activate-a-card"},{"title":"Close a card","deprecated":null,"version":null,"openapi":"/openapi.json post /v1/cards/{id}/close","href":"/api-reference/cards/close-a-card"},{"title":"Fund a prepaid card","deprecated":null,"version":null,"openapi":"/openapi.json post /v1/cards/{id}/fund","href":"/api-reference/cards/fund-a-prepaid-card"},{"title":"Fund card from deposit wallet","deprecated":null,"version":null,"openapi":"/openapi.json post /v1/cards/{id}/fund-from-wallet","href":"/api-reference/card-funding/fund-card-from-deposit-wallet"},{"title":"Quote a withdrawal to an external crypto wallet","deprecated":null,"version":null,"openapi":"/openapi.json post /v1/cards/{id}/withdraw-to-wallet/quote","href":"/api-reference/card-funding/quote-a-withdrawal-to-an-external-crypto-wallet"},{"title":"Send leftover card funds to an external crypto wallet","deprecated":null,"version":null,"openapi":"/openapi.json post /v1/cards/{id}/withdraw-to-wallet","href":"/api-reference/card-funding/send-leftover-card-funds-to-an-external-crypto-wallet"},{"title":"Get a card withdrawal","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/cards/{id}/withdrawals/{withdrawalId}","href":"/api-reference/card-funding/get-a-card-withdrawal"},{"title":"Withdraw from a prepaid card","deprecated":null,"version":null,"openapi":"/openapi.json post /v1/cards/{id}/defund","href":"/api-reference/cards/withdraw-from-a-prepaid-card"}]},{"group":"Cards — view PAN/CVV (Method 1 \u0026 2)","pages":[{"title":"Reveal token for Widget.js (PAN/CVV)","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/cards/{id}/secure-details","href":"/api-reference/cards/reveal-token-for-widgetjs-pancvv"},{"title":"Server-side encrypted PAN/CVV (PCI DSS Level 1)","deprecated":null,"version":null,"openapi":"/openapi.json post /v1/cards/{id}/payment-details","href":"/api-reference/cards/server-side-encrypted-pancvv-pci-dss-level-1"},{"title":"Widget.js (sandbox)","deprecated":null,"version":null,"openapi":"/openapi.json get /sdk/card/sandbox/1.0.0/index.min.js","href":"/api-reference/widget-sdk/widgetjs-sandbox"},{"title":"Widget.js (live)","deprecated":null,"version":null,"openapi":"/openapi.json get /sdk/card/1.0.0/index.min.js","href":"/api-reference/widget-sdk/widgetjs-live"}]},{"group":"Cards — spend controls","pages":[{"title":"List spend controls","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/cards/spend-controls","href":"/api-reference/cards/list-spend-controls"},{"title":"Create or update a spend control","deprecated":null,"version":null,"openapi":"/openapi.json post /v1/cards/spend-controls","href":"/api-reference/cards/create-or-update-a-spend-control"},{"title":"Delete a spend control","deprecated":null,"version":null,"openapi":"/openapi.json delete /v1/cards/spend-controls","href":"/api-reference/cards/delete-a-spend-control"},{"title":"Batch set spend controls","deprecated":null,"version":null,"openapi":"/openapi.json post /v1/cards/spend-controls/batch","href":"/api-reference/cards/batch-set-spend-controls"}]},{"group":"Transactions","pages":[{"title":"List transactions","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/transactions","href":"/api-reference/transactions/list-transactions"},{"title":"List card transactions","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/cards/{id}/transactions","href":"/api-reference/transactions/list-card-transactions"}]},{"group":"Webhooks \u0026 events","pages":[{"title":"List subscribable event types","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/webhooks/event-types","href":"/api-reference/webhooks/list-subscribable-event-types"},{"title":"List webhook subscriptions","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/webhooks","href":"/api-reference/webhooks/list-webhook-subscriptions"},{"title":"Create webhook subscription","deprecated":null,"version":null,"openapi":"/openapi.json post /v1/webhooks","href":"/api-reference/webhooks/create-webhook-subscription"},{"title":"Rotate webhook signing secret","deprecated":null,"version":null,"openapi":"/openapi.json post /v1/webhooks/{id}/rotate-secret","href":"/api-reference/webhooks/rotate-webhook-signing-secret"},{"title":"List domain events","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/events","href":"/api-reference/webhooks/list-domain-events"}]},{"group":"Sandbox testing","pages":[{"title":"Simulate sandbox events","deprecated":null,"version":null,"openapi":"/openapi.json post /v1/sandbox/simulate","href":"/api-reference/sandbox/simulate-sandbox-events"}]}]}]},"basePath":"","title":"Submit for KYC - Apocor Cards API","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"]}