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.
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/update-applicant-profile","slug":"/api-reference/applicants/update-applicant-profile","pageMetadata":{"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","autogeneratedByOpenApi":true},"description":{"compiledSource":"\"use strict\";\nconst {jsx: _jsx, jsxs: _jsxs} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n code: \"code\",\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsxs(_components.p, {\n children: [\"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. \", _jsx(_components.code, {\n children: \"ssn\"\n }), \" may be set once when missing (required for US card issuance after hosted KYC). Never changes status or issuer references.\"]\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":"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","autogeneratedByOpenApi":true}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":[],"openApiReferenceData":{"operation":{"tags":["Applicants"],"summary":"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.","parameters":["c93405a4-87d6-4a80-aac5-7114214a3fd6"],"requestBody":"c8f6b1d9-294a-4348-8d6f-384ee24788b3","responses":{"200":"e7f5d743-5a9e-4681-8f19-cdbad7469794","400":"ab7d3755-b16e-440d-8fe7-af3fba41f3f4","404":"66b627fc-26c9-4260-b610-9def5f630c9c","409":"ffb6f8d7-6e91-4992-b4b6-8f189bf9d77b"},"operationId":"patchApplicantsById","method":"patch","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}","baseUrlOptions":["https://sandbox.apocor.ai","https://api.apocor.ai","http://localhost:4000"],"title":"Update applicant profile","codeSamples":[],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated","disableProxy":true},"dependencies":{"parameters":{"c93405a4-87d6-4a80-aac5-7114214a3fd6":{"name":"id","in":"path","required":true,"schema":{"type":"string","isRequired":true,"description":"Resource identifier.","uniqueKey":"","typeLabel":"string"},"description":"Resource identifier."}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"email":{"oneOf":[{"type":"string","format":"email","uniqueKey":"email.oneOf.0","typeLabel":"string\u003cemail>"},{"type":"null","format":"email","uniqueKey":"email.oneOf.1","typeLabel":"null"}],"uniqueKey":"email","typeLabel":"string\u003cemail> | null"},"data":{"type":"object","additionalProperties":true,"properties":{"ssn":{"type":"string","description":"9-digit US SSN (digits or dashed). Once-write when missing.","example":"123456789","uniqueKey":"data.ssn","typeLabel":"string"},"phone":{"type":"string","uniqueKey":"data.phone","typeLabel":"string"},"phoneCountryCode":{"type":"string","uniqueKey":"data.phoneCountryCode","typeLabel":"string"}},"uniqueKey":"data","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"example":{"data":{"ssn":"123456789"}},"examples":{"Example":{"title":"Example","value":{"data":{"ssn":"123456789"}}}},"exampleType":"examples"}},"exampleType":"examples"},"responses":{"e7f5d743-5a9e-4681-8f19-cdbad7469794":{"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"},"ab7d3755-b16e-440d-8fe7-af3fba41f3f4":{"description":"The request was invalid.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","description":"Stable, machine-readable error code.","uniqueKey":"error.code","typeLabel":"string"},"message":{"type":"string","description":"Human-readable explanation.","uniqueKey":"error.message","typeLabel":"string"}},"uniqueKey":"error","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"example":{"error":{"code":"INVALID_REQUEST","message":"Applicant must be approved"}},"examples":{"Example":{"title":"Example","value":{"error":{"code":"INVALID_REQUEST","message":"Applicant must be approved"}}}},"exampleType":"examples"}},"exampleType":"examples"},"66b627fc-26c9-4260-b610-9def5f630c9c":{"description":"Resource not found.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","description":"Stable, machine-readable error code.","uniqueKey":"error.code","typeLabel":"string"},"message":{"type":"string","description":"Human-readable explanation.","uniqueKey":"error.message","typeLabel":"string"}},"uniqueKey":"error","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"example":{"error":{"code":"NOT_FOUND","message":"Not found"}},"examples":{"Example":{"title":"Example","value":{"error":{"code":"NOT_FOUND","message":"Not found"}}}},"exampleType":"examples"}},"exampleType":"examples"},"ffb6f8d7-6e91-4992-b4b6-8f189bf9d77b":{"description":"Profile or SSN locked.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","description":"Stable, machine-readable error code.","uniqueKey":"error.code","typeLabel":"string"},"message":{"type":"string","description":"Human-readable explanation.","uniqueKey":"error.message","typeLabel":"string"}},"uniqueKey":"error","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":{"code":"\u003cstring>","message":"\u003cstring>"}}}},"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":"Update applicant profile - Apocor Cards API","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-09-11T21:22:59.350Z","originalFileLocation":"api-reference/applicants/update-applicant-profile.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=\"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.\">\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=\"Update applicant profile - Apocor Cards API\">\u003cmeta data-mint-head property=\"og:description\" content=\"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.\">\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/update-applicant-profile\">\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=Update+applicant+profile\u0026amp;description=Merges+allowlisted+profile+fields+into+the+applicant.+Contact+fields+%28phone%2C+etc.%29+can+usually+be+updated.+Identity+fields+%28name%2C+DOB%2C+nationality%2C+address%29+are\u0026amp;theme=88149093ee09a2f63e7e8a96\u0026amp;signature=8fb47f7b3e1b39170d95cc112c780fc067a420e67452f7e87f8e7eec95993f3e\">\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=\"Update applicant profile - Apocor Cards API\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"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.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://apocor.mintlify.app/_mintlify/api/og/v2?division=Identity+verification+%28KYC%29\u0026amp;title=Update+applicant+profile\u0026amp;description=Merges+allowlisted+profile+fields+into+the+applicant.+Contact+fields+%28phone%2C+etc.%29+can+usually+be+updated.+Identity+fields+%28name%2C+DOB%2C+nationality%2C+address%29+are\u0026amp;theme=88149093ee09a2f63e7e8a96\u0026amp;signature=8fb47f7b3e1b39170d95cc112c780fc067a420e67452f7e87f8e7eec95993f3e\">\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/update-applicant-profile\">\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/update-applicant-profile.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/update-applicant-profile#webpage\",\"url\":\"https://docs.apocor.ai/api-reference/applicants/update-applicant-profile\",\"name\":\"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.\",\"dateModified\":\"2026-09-11T21:22:59.350Z\",\"isPartOf\":{\"@id\":\"https://docs.apocor.ai#website\"},\"breadcrumb\":{\"@id\":\"https://docs.apocor.ai/api-reference/applicants/update-applicant-profile#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.apocor.ai/api-reference/applicants/update-applicant-profile#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\":\"Update applicant profile\",\"item\":\"https://docs.apocor.ai/api-reference/applicants/update-applicant-profile\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.apocor.ai/api-reference/applicants/update-applicant-profile#apireference\",\"headline\":\"Update applicant profile\",\"name\":\"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.\",\"url\":\"https://docs.apocor.ai/api-reference/applicants/update-applicant-profile\",\"mainEntityOfPage\":{\"@id\":\"https://docs.apocor.ai/api-reference/applicants/update-applicant-profile#webpage\"},\"dateModified\":\"2026-09-11T21:22:59.350Z\",\"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","description":null,"deprecated":null,"version":null,"openapi":"/openapi.json get /v1/applicants/{id}","href":"/api-reference/applicants/get-an-applicant"},{"title":"Update applicant profile","deprecated":null,"version":null,"openapi":"/openapi.json patch /v1/applicants/{id}","href":"/api-reference/applicants/update-applicant-profile"},{"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"},{"title":"Start a hosted KYC session","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":"Update applicant profile - 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"]}