Rate limit: 60 requests per 60 seconds. This is the default shared quota — it is shared with every other endpoint that has no dedicated limit, so requests across those endpoints all draw from the same budget.
Updates the authenticated user’s KYC personal details. Supports partial updates - any subset of the fields may be supplied and omitted fields are left unchanged. Tax identifications are supplied via taxIds[] and support multiple jurisdictions; when present, taxIds[] replaces the full set of tax identifications on the user record. The deprecated single taxId/taxIdCountry fields are still accepted for backward compatibility and are used only when taxIds[] is absent. Tax-id number format is validated per country by the upstream KYC service.
API key of the application. Only valid together with the x-user-key header — the pair is an alternative to OAuth bearer authentication, never sent alongside it. The pair is granted the same permissions the operation's OAuth scopes describe.
Demo credential for trying the API from these docs: lhgfaslk21490FAScVPkdsb53F9dNkfHG4faZSG5vfjndfcfgdssdgsdHF4663
x-user-key
string
header
required
User-specific authentication key. Only valid together with the x-api-key header — the pair is an alternative to OAuth bearer authentication, never sent alongside it.
Demo credential for trying the API from these docs: eyJlYW4iOiJVbnJlZ2lzdGVyZWRBcHBsaWNhdGlvbiIsImVrIjoiOE5sZ2cwcW5EUVdROUFNWGpXT2lmOWktZnpidG5KcUlqWGJ3WHJZZkpZcldrbG90ZEhvLVBjSWhQaU8xU1ZtMW84aU1WZGZqN2xWNzFjLXFxLmcybXE1dnh4Q1hUT25xaWRUaTFlcEhmVk1fIn0_
Scopes
etoro-public:verification.personaldetails:write
Grants access to the 'etoro-public:verification.personaldetails:write' scope.
Headers
x-request-id
string<uuid>
required
A unique request identifier.
Example:
"3b0632cf-e7db-4558-9598-ad9c4808f653"
Body
application/json
Partial-update payload for KYC personal details. Any subset of these fields may be supplied; omitted fields are left unchanged. The gcid is taken from the authenticated session and is not accepted in the body.
ISO 3166-1 alpha-2 country code of the user's place of birth.
Example:
"US"
citizenshipCountry
string
ISO 3166-1 alpha-2 country code of the user's primary citizenship.
Example:
"US"
personalIdentification
object
A personal identification document (e.g. national ID, passport).
Show child attributes
taxIds
object[]
Tax identifications for the user. Supports multiple jurisdictions. When supplied, this replaces the full set of tax identifications on the user record and takes precedence over the deprecated single taxId/taxIdCountry fields. At most one entry may be flagged primary; at most 10 entries; one entry per country.
Show child attributes
taxId
string
deprecated
Deprecated. Use taxIds[]. Accepted only when taxIds[] is absent. Retained for backward compatibility.
taxIdCountry
string
deprecated
Deprecated. Use taxIds[]. ISO 3166-1 alpha-2 country code of the deprecated single tax identification. Retained for backward compatibility.
Example:
"DE"
additionalCitizenship
object
A secondary citizenship held by the user.
Show child attributes
Response
KYC personal details updated successfully. Returns the full personal-details record after the update.
Full KYC personal-details record for the authenticated user.
ISO 3166-1 alpha-2 country code of the user's place of birth.
Example:
"US"
citizenshipCountry
string
ISO 3166-1 alpha-2 country code of the user's primary citizenship.
Example:
"US"
personalIdentification
object
A personal identification document (e.g. national ID, passport).
Show child attributes
taxIds
object[]
All tax identifications held by the user, one entry per issuing country.
Show child attributes
taxId
string
deprecated
Deprecated. Use taxIds[]. Mirrors the primary tax identification number. Retained for backward compatibility.
taxIdCountry
string
deprecated
Deprecated. Use taxIds[]. ISO 3166-1 alpha-2 country code of the primary tax identification. Retained for backward compatibility.
Example:
"DE"
additionalCitizenship
object
A secondary citizenship held by the user.
Show child attributes
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"etoro API Docs","colors":{"primary":"#16A34A","light":"#07C983","dark":"#15803D"},"logo":{"light":"https://mintcdn.com/etoro-6fc30280/KKUNTvuhL1tWIl3G/images/logo.svg?fit=max\u0026auto=format\u0026n=KKUNTvuhL1tWIl3G\u0026q=85\u0026s=7bbb280a3f86decc927b143516fd5b80","dark":"https://mintcdn.com/etoro-6fc30280/KKUNTvuhL1tWIl3G/images/logo-dark.svg?fit=max\u0026auto=format\u0026n=KKUNTvuhL1tWIl3G\u0026q=85\u0026s=a861cfdb3d024e2cb3df41653159c91a"},"favicon":"https://mintcdn.com/etoro-6fc30280/MTKJaixgHfhPDkFN/favicon.svg?fit=max\u0026auto=format\u0026n=MTKJaixgHfhPDkFN\u0026q=85\u0026s=0e51b4752d27e2e71dd3f05670b4d9e1","api":{"playground":{"display":"interactive"},"examples":{"prefill":true}},"navbar":{"primary":{"type":"button","label":"Get API Keys","href":"https://www.etoro.com/settings/trade"}},"footer":{"socials":{"x":"https://x.com/etoro","linkedin":"https://linkedin.com/company/etoro"}},"contextual":{"options":["copy","view","chatgpt","claude","perplexity","mcp","cursor","vscode"],"display":"header"},"styling":{"latex":false},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"etoro-6fc30280","hasAudioNarration":false,"actualSubdomain":"etoro-6fc30280","customDomains":["api-portal.etoro.com"],"gitSource":{"type":"github","owner":"etoro-ai-foundry","repo":"etoro-api-docs","deployBranch":"main","contentDirectory":"","isPrivate":true,"mountPath":"","label":""},"entitlements":{"AI_CHAT":{"status":"ENABLED"},"WEB_MCP":{"status":"ENABLED"},"NARRATION":{"status":"ENABLED"}},"buildId":"6b02bfd293edbf63bed54970","clientVersion":"0.0.4270","searchFilterCounts":[{"language":"default","tag":"Core API","count":330},{"language":"default","tag":"Partners API","count":133},{"language":"default","tag":"Create the user","count":31},{"language":"default","tag":"KYC","count":23},{"language":"default","tag":"Trading - Demo","count":23},{"language":"default","tag":"Trading - Real","count":23},{"language":"default","tag":"Watchlists","count":18},{"language":"default","tag":"Deprecated","count":15},{"language":"default","tag":"Money","count":15},{"language":"default","tag":"Operations","count":15}]},"assistantConfig":{"enableAskAiButton":true,"enableStarterQuestions":false,"enableAskAiSearchBar":true,"deflection":{"enabled":true,"email":"apisupport@etoro.com","showHelpButton":true}},"basePath":"","hasChatPermissions":true,"hasWebMcpPermissions":true,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-rbac-roles","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":"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":"site-roles","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":"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":"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":"editor-metadata","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},{"name":"live-agents","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"starter-pricing","enabled":true,"variant":{"name":"treatment","enabled":true,"payload":{"type":"string","value":"treatment"},"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"wildcard-email-auth","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[{"filePath":"style.css","content":"html:not([data-preview])[data-current-path^=\"/core/websocket/notifications\"] [data-testid=\"try-it-button\"],html:not([data-preview])[data-current-path^=\"/core/websocket/notifications\"] .tryit-button,html:not([data-preview])[data-current-path^=\"/core/websocket/notifications\"] #api-playground,html:not([data-preview])[data-current-path^=\"/core/websocket/notifications\"] [data-testid=\"playground\"],html:not([data-preview])[data-current-path^=\"/core/websocket/notifications\"] [class*=\"playground-button\"],html:not([data-preview])[data-current-path^=\"/core/websocket/notifications\"] button[aria-label=\"Try it\"],html:not([data-preview])[data-current-path^=\"/core/websocket/notifications\"] button[aria-label=\"Connect\"]{display:none!important}html:not([data-preview])[data-current-path^=\"/core/websocket/notifications\"] #endpoints-menu-trigger,html:not([data-preview])[data-current-path^=\"/core/websocket/notifications\"] [aria-labelledby=\"endpoints-menu-trigger\"],html:not([data-preview])[data-current-path^=\"/core/websocket/notifications\"] [id^=\"endpoints-menu-trigger\"]{display:none!important}html:not([data-preview]) [role=\"menu\"] a[href^=\"/core/websocket/notifications\"],html:not([data-preview]) [data-testid=\"playground\"] a[href^=\"/core/websocket/notifications\"]{display:none!important}a:focus-visible,button:focus-visible,summary:focus-visible,[role=\"button\"]:focus-visible,[role=\"menuitem\"]:focus-visible,[tabindex]:not([tabindex=\"-1\"]):focus-visible{outline:2px solid currentColor;outline-offset:2px;border-radius:4px}@media (prefers-reduced-motion: reduce){*,*::before,*::after{animation-duration:0.01ms;animation-iteration-count:1;transition-duration:0.01ms}}button[aria-label]:not([aria-label=\"\"]){min-width:24px;min-height:24px}main h2{margin-top:2.25em;margin-bottom:0.6em}main h3{margin-top:1.75em;margin-bottom:0.5em}main>h2:first-child,main>h3:first-child{margin-top:0}main p,main>ul,main>ol{max-width:78ch}main :not(pre)>code{padding:0.12em 0.36em;border-radius:5px;font-size:0.9em;background:color-mix(in srgb, currentColor 7%, transparent);letter-spacing:-0.01em}main table{display:block;overflow-x:auto;-webkit-overflow-scrolling:touch;max-width:100%}main tbody tr:nth-child(even){background:color-mix(in srgb, currentColor 3%, transparent)}[data-component-part=\"field-name\"]{font-weight:600;font-variant-numeric:tabular-nums}[data-component-part=\"field-required-pill\"]{font-weight:650;letter-spacing:0.01em;color:#B45309}.dark [data-component-part=\"field-required-pill\"]{color:#FCD34D}[data-component-part=\"code-block-root\"]{border-radius:10px;border:1px solid color-mix(in srgb, currentColor 12%, transparent)}[data-testid=\"copy-code-button\"]:focus-visible{opacity:1}[data-current-path^=\"/core/websocket\"] [data-component-part=\"field-name\"]{scroll-margin-top:6rem}main :is(h1,h2,h3,h4){scroll-margin-top:6rem}nav a[aria-current=\"page\"]{font-weight:650}.nav-tag-pill{flex-shrink:0}.nav-tag-pill-text{white-space:nowrap}@media print{nav,aside,[data-component-part=\"pagination-prev\"],[data-component-part=\"pagination-next\"]{display:none}main a[href^=\"http\"]::after{content:\" (\" attr(href) \")\";font-size:0.85em;word-break:break-all}}"}]}
{"page":{"pagePath":"partners-api-reference/kyc/update-kyc-personal-details","slug":"/partners-api-reference/kyc/update-kyc-personal-details","pageMetadata":{"title":"Update KYC Personal Details","description":"**Rate limit:** 60 requests per 60 seconds. This is the **default shared quota** — it is shared with every other endpoint that has no dedicated limit, so requests across those endpoints all draw from the same budget.\n\n---\n\nUpdates the authenticated user's KYC personal details. Supports partial updates - any subset of the fields may be supplied and omitted fields are left unchanged. Tax identifications are supplied via taxIds[] and support multiple jurisdictions; when present, taxIds[] replaces the full set of tax identifications on the user record. The deprecated single taxId/taxIdCountry fields are still accepted for backward compatibility and are used only when taxIds[] is absent. Tax-id number format is validated per country by the upstream KYC service.","deprecated":null,"version":null,"openapi":"/api-reference/partners-openapi.json put /api/v1/users/personaldetails","href":"/partners-api-reference/kyc/update-kyc-personal-details","autogeneratedByOpenApi":true},"description":{"compiledSource":"\"use strict\";\nconst {Fragment: _Fragment, jsx: _jsx, jsxs: _jsxs} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n hr: \"hr\",\n p: \"p\",\n strong: \"strong\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsxs(_Fragment, {\n children: [_jsxs(_components.p, {\n children: [_jsx(_components.strong, {\n children: \"Rate limit:\"\n }), \" 60 requests per 60 seconds. This is the \", _jsx(_components.strong, {\n children: \"default shared quota\"\n }), \" — it is shared with every other endpoint that has no dedicated limit, so requests across those endpoints all draw from the same budget.\"]\n }), \"\\n\", _jsx(_components.hr, {}), \"\\n\", _jsx(_components.p, {\n children: \"Updates the authenticated user’s KYC personal details. Supports partial updates - any subset of the fields may be supplied and omitted fields are left unchanged. Tax identifications are supplied via taxIds[] and support multiple jurisdictions; when present, taxIds[] replaces the full set of tax identifications on the user record. The deprecated single taxId/taxIdCountry fields are still accepted for backward compatibility and are used only when taxIds[] is absent. Tax-id number format is validated per country by the upstream KYC service.\"\n })]\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 KYC Personal Details","description":"**Rate limit:** 60 requests per 60 seconds. This is the **default shared quota** — it is shared with every other endpoint that has no dedicated limit, so requests across those endpoints all draw from the same budget.\n\n---\n\nUpdates the authenticated user's KYC personal details. Supports partial updates - any subset of the fields may be supplied and omitted fields are left unchanged. Tax identifications are supplied via taxIds[] and support multiple jurisdictions; when present, taxIds[] replaces the full set of tax identifications on the user record. The deprecated single taxId/taxIdCountry fields are still accepted for backward compatibility and are used only when taxIds[] is absent. Tax-id number format is validated per country by the upstream KYC service.","deprecated":null,"version":null,"openapi":"/api-reference/partners-openapi.json put /api/v1/users/personaldetails","href":"/partners-api-reference/kyc/update-kyc-personal-details","autogeneratedByOpenApi":true}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":["/_mintlify/custom/etoro-6fc30280/29aee0c87554e32b/js/placeholders.js","/_mintlify/custom/etoro-6fc30280/b73b20726f405fff/js/preview-flag.js","/_mintlify/custom/etoro-6fc30280/a63041172e718d03/js/websocket-url.js","/_mintlify/custom/etoro-6fc30280/265471ec7516abfe/js/request-id.js","/_mintlify/custom/etoro-6fc30280/d4932eb5fd7799f1/js/beta-messages.js","/_mintlify/custom/etoro-6fc30280/c79b596fa5eb3800/js/beta-nav.js","/_mintlify/custom/etoro-6fc30280/b7b2ce3b4d7b5b66/js/oauth-scopes.js","/_mintlify/custom/etoro-6fc30280/07a9d44829efc6df/js/beta-tooltip.js","/_mintlify/custom/etoro-6fc30280/a7cd0fbb6bb0e6e6/js/websocket-fields.js","/_mintlify/custom/etoro-6fc30280/67254ebe1e1dc8f2/js/onetrust-gtm.js"],"openApiReferenceData":{"operation":{"tags":["KYC"],"summary":"Update KYC Personal Details","description":"**Rate limit:** 60 requests per 60 seconds. This is the **default shared quota** — it is shared with every other endpoint that has no dedicated limit, so requests across those endpoints all draw from the same budget.\n\n---\n\nUpdates the authenticated user's KYC personal details. Supports partial updates - any subset of the fields may be supplied and omitted fields are left unchanged. Tax identifications are supplied via taxIds[] and support multiple jurisdictions; when present, taxIds[] replaces the full set of tax identifications on the user record. The deprecated single taxId/taxIdCountry fields are still accepted for backward compatibility and are used only when taxIds[] is absent. Tax-id number format is validated per country by the upstream KYC service.","operationId":"UpdateKycPersonalDetails","requestBody":"642077c6-273a-4dc4-bae8-c3c9e9cca1cd","responses":{"200":"65986779-cda6-4f3f-a65a-849782a6f52f","400":"e164271d-af66-4577-953a-cc8e06d7396e","401":"ea532113-7d2f-466f-91ba-4b5f7c476eee","422":"702e8197-1572-430a-93d0-5af4841a7eb6","429":"edf277bd-598b-49cd-a3af-49c95f6fd504","500":"29787aeb-67aa-427c-bb2b-be4a29fe3204"},"security":["32f5b536-8a1c-4f18-ab1c-ea69a9feb1ab","10595834-8563-4dc6-b9cf-032252c90728"],"x-ratelimit":{"limit":60,"window":60,"shared":true,"defaultPool":true},"parameters":["d9ac1f50-d34e-4ab6-8fe0-42c76ab8d02f"],"method":"put","type":"path","servers":["e0851524-5431-447a-a347-d6923f70b4b9"],"path":"/api/v1/users/personaldetails","baseUrlOptions":["https://public-api.etoro.com"],"title":"Update KYC Personal Details","codeSamples":[],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated","prefillPlaygroundWithExample":true,"prefillPlaygroundExamples":[{"body.firstName":"John","body.lastName":"Doe","body.dateOfBirth":"1990-01-01","body.citizenshipCountry":"DE","body.taxIds.items.0.taxId":"IL311111118","body.taxIds.items.0.country":"IL","body.taxIds.items.0.primary":false,"body.taxIds.items.1.taxId":"44892353279","body.taxIds.items.1.country":"DE","body.taxIds.items.1.primary":true}]},"dependencies":{"parameters":{"d9ac1f50-d34e-4ab6-8fe0-42c76ab8d02f":{"name":"x-request-id","in":"header","required":true,"schema":{"type":"string","format":"uuid","example":"3b0632cf-e7db-4558-9598-ad9c4808f653","isRequired":true,"description":"A unique request identifier.","uniqueKey":"","typeLabel":"string\u003cuuid>"},"description":"A unique request identifier.","example":"3b0632cf-e7db-4558-9598-ad9c4808f653"}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","description":"Partial-update payload for KYC personal details. Any subset of these fields may be supplied; omitted fields are left unchanged. The gcid is taken from the authenticated session and is not accepted in the body.","properties":{"firstName":{"type":"string","description":"The user's first name.","uniqueKey":"firstName","typeLabel":"string"},"middleName":{"oneOf":[{"type":"string","description":"The user's middle name (optional).","uniqueKey":"middleName.oneOf.0","typeLabel":"string"},{"type":"null","description":"The user's middle name (optional).","uniqueKey":"middleName.oneOf.1","typeLabel":"null"}],"uniqueKey":"middleName","typeLabel":"string | null"},"lastName":{"type":"string","description":"The user's last name.","uniqueKey":"lastName","typeLabel":"string"},"gender":{"type":"integer","description":"Gender code. Values: 0=Unspecified, 1=Male, 2=Female, 3=Other.","uniqueKey":"gender","typeLabel":"integer"},"dateOfBirth":{"type":"string","format":"date","description":"The user's date of birth (ISO 8601, YYYY-MM-DD).","uniqueKey":"dateOfBirth","typeLabel":"string\u003cdate>"},"placeOfBirthCountry":{"type":"string","description":"ISO 3166-1 alpha-2 country code of the user's place of birth.","example":"US","uniqueKey":"placeOfBirthCountry","typeLabel":"string"},"citizenshipCountry":{"type":"string","description":"ISO 3166-1 alpha-2 country code of the user's primary citizenship.","example":"US","uniqueKey":"citizenshipCountry","typeLabel":"string"},"personalIdentification":{"type":"object","description":"A personal identification document (e.g. national ID, passport).","properties":{"type":{"type":"string","description":"Identification document type (e.g. \"NationalId\", \"Passport\", \"DriverLicense\"). Exact value set is defined by the KYC facade.","uniqueKey":"personalIdentification.type","typeLabel":"string"},"value":{"type":"string","description":"The identification number / document value.","uniqueKey":"personalIdentification.value","typeLabel":"string"},"issuingCountry":{"type":"string","description":"ISO 3166-1 alpha-2 country code of the issuing jurisdiction.","example":"US","uniqueKey":"personalIdentification.issuingCountry","typeLabel":"string"}},"uniqueKey":"personalIdentification","typeLabel":"object"},"taxIds":{"type":"array","description":"Tax identifications for the user. Supports multiple jurisdictions. When supplied, this replaces the full set of tax identifications on the user record and takes precedence over the deprecated single taxId/taxIdCountry fields. At most one entry may be flagged primary; at most 10 entries; one entry per country.","items":{"type":"object","description":"A tax identification supplied on update. One entry per issuing country; at most one may be primary.","properties":{"taxId":{"type":"string","description":"The tax identification number. Format is validated per country by the upstream KYC service.","uniqueKey":"taxIds.items.[INDEX].taxId","typeLabel":"string"},"country":{"type":"string","description":"ISO 3166-1 alpha-2 country code of the issuing jurisdiction.","example":"DE","uniqueKey":"taxIds.items.[INDEX].country","typeLabel":"string"},"primary":{"type":"boolean","description":"Whether this is the primary tax identification. At most one entry may be primary.","uniqueKey":"taxIds.items.[INDEX].primary","typeLabel":"boolean"}},"uniqueKey":"taxIds.items.[INDEX]","typeLabel":"object"},"uniqueKey":"taxIds","typeLabel":"object[]"},"taxId":{"type":"string","deprecated":true,"description":"Deprecated. Use taxIds[]. Accepted only when taxIds[] is absent. Retained for backward compatibility.","uniqueKey":"taxId","typeLabel":"string"},"taxIdCountry":{"type":"string","deprecated":true,"description":"Deprecated. Use taxIds[]. ISO 3166-1 alpha-2 country code of the deprecated single tax identification. Retained for backward compatibility.","example":"DE","uniqueKey":"taxIdCountry","typeLabel":"string"},"additionalCitizenship":{"type":"object","description":"A secondary citizenship held by the user.","properties":{"countryCode":{"type":"string","description":"ISO 3166-1 alpha-2 country code of the additional citizenship.","example":"GB","uniqueKey":"additionalCitizenship.countryCode","typeLabel":"string"},"personalIdentification":{"type":"object","description":"A personal identification document (e.g. national ID, passport).","properties":{"type":{"type":"string","description":"Identification document type (e.g. \"NationalId\", \"Passport\", \"DriverLicense\"). Exact value set is defined by the KYC facade.","uniqueKey":"additionalCitizenship.personalIdentification.type","typeLabel":"string"},"value":{"type":"string","description":"The identification number / document value.","uniqueKey":"additionalCitizenship.personalIdentification.value","typeLabel":"string"},"issuingCountry":{"type":"string","description":"ISO 3166-1 alpha-2 country code of the issuing jurisdiction.","example":"US","uniqueKey":"additionalCitizenship.personalIdentification.issuingCountry","typeLabel":"string"}},"uniqueKey":"additionalCitizenship.personalIdentification","typeLabel":"object"}},"uniqueKey":"additionalCitizenship","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"example":{"firstName":"John","lastName":"Doe","dateOfBirth":"1990-01-01","citizenshipCountry":"DE","taxIds":[{"taxId":"IL311111118","country":"IL","primary":false},{"taxId":"44892353279","country":"DE","primary":true}]},"examples":{"Example":{"title":"Example","value":{"firstName":"John","lastName":"Doe","dateOfBirth":"1990-01-01","citizenshipCountry":"DE","taxIds":[{"taxId":"IL311111118","country":"IL","primary":false},{"taxId":"44892353279","country":"DE","primary":true}]}}},"exampleType":"examples"}},"exampleType":"examples"},"responses":{"65986779-cda6-4f3f-a65a-849782a6f52f":{"description":"KYC personal details updated successfully. Returns the full personal-details record after the update.","content":{"application/json":{"schema":{"type":"object","description":"Full KYC personal-details record for the authenticated user.","properties":{"gcid":{"type":"integer","format":"int64","description":"The user's global customer identifier.","uniqueKey":"gcid","typeLabel":"integer\u003cint64>"},"firstName":{"type":"string","description":"The user's first name.","uniqueKey":"firstName","typeLabel":"string"},"middleName":{"oneOf":[{"type":"string","description":"The user's middle name (optional).","uniqueKey":"middleName.oneOf.0","typeLabel":"string"},{"type":"null","description":"The user's middle name (optional).","uniqueKey":"middleName.oneOf.1","typeLabel":"null"}],"uniqueKey":"middleName","typeLabel":"string | null"},"lastName":{"type":"string","description":"The user's last name.","uniqueKey":"lastName","typeLabel":"string"},"gender":{"type":"integer","description":"Gender code. Values: 0=Unspecified, 1=Male, 2=Female, 3=Other.","uniqueKey":"gender","typeLabel":"integer"},"dateOfBirth":{"type":"string","format":"date","description":"The user's date of birth (ISO 8601, YYYY-MM-DD).","uniqueKey":"dateOfBirth","typeLabel":"string\u003cdate>"},"placeOfBirthCountry":{"type":"string","description":"ISO 3166-1 alpha-2 country code of the user's place of birth.","example":"US","uniqueKey":"placeOfBirthCountry","typeLabel":"string"},"citizenshipCountry":{"type":"string","description":"ISO 3166-1 alpha-2 country code of the user's primary citizenship.","example":"US","uniqueKey":"citizenshipCountry","typeLabel":"string"},"personalIdentification":{"type":"object","description":"A personal identification document (e.g. national ID, passport).","properties":{"type":{"type":"string","description":"Identification document type (e.g. \"NationalId\", \"Passport\", \"DriverLicense\"). Exact value set is defined by the KYC facade.","uniqueKey":"personalIdentification.type","typeLabel":"string"},"value":{"type":"string","description":"The identification number / document value.","uniqueKey":"personalIdentification.value","typeLabel":"string"},"issuingCountry":{"type":"string","description":"ISO 3166-1 alpha-2 country code of the issuing jurisdiction.","example":"US","uniqueKey":"personalIdentification.issuingCountry","typeLabel":"string"}},"uniqueKey":"personalIdentification","typeLabel":"object"},"taxIds":{"type":"array","description":"All tax identifications held by the user, one entry per issuing country.","items":{"type":"object","description":"A tax identification returned on read.","properties":{"taxId":{"type":"string","description":"The tax identification number.","uniqueKey":"taxIds.items.[INDEX].taxId","typeLabel":"string"},"country":{"type":"string","description":"ISO 3166-1 alpha-2 country code of the issuing jurisdiction.","example":"DE","uniqueKey":"taxIds.items.[INDEX].country","typeLabel":"string"},"primary":{"type":"boolean","description":"Whether this is the primary tax identification. Inferred: the entry whose country matches the user's citizenship is primary; otherwise the first entry.","uniqueKey":"taxIds.items.[INDEX].primary","typeLabel":"boolean"}},"uniqueKey":"taxIds.items.[INDEX]","typeLabel":"object"},"uniqueKey":"taxIds","typeLabel":"object[]"},"taxId":{"type":"string","deprecated":true,"description":"Deprecated. Use taxIds[]. Mirrors the primary tax identification number. Retained for backward compatibility.","uniqueKey":"taxId","typeLabel":"string"},"taxIdCountry":{"type":"string","deprecated":true,"description":"Deprecated. Use taxIds[]. ISO 3166-1 alpha-2 country code of the primary tax identification. Retained for backward compatibility.","example":"DE","uniqueKey":"taxIdCountry","typeLabel":"string"},"additionalCitizenship":{"type":"object","description":"A secondary citizenship held by the user.","properties":{"countryCode":{"type":"string","description":"ISO 3166-1 alpha-2 country code of the additional citizenship.","example":"GB","uniqueKey":"additionalCitizenship.countryCode","typeLabel":"string"},"personalIdentification":{"type":"object","description":"A personal identification document (e.g. national ID, passport).","properties":{"type":{"type":"string","description":"Identification document type (e.g. \"NationalId\", \"Passport\", \"DriverLicense\"). Exact value set is defined by the KYC facade.","uniqueKey":"additionalCitizenship.personalIdentification.type","typeLabel":"string"},"value":{"type":"string","description":"The identification number / document value.","uniqueKey":"additionalCitizenship.personalIdentification.value","typeLabel":"string"},"issuingCountry":{"type":"string","description":"ISO 3166-1 alpha-2 country code of the issuing jurisdiction.","example":"US","uniqueKey":"additionalCitizenship.personalIdentification.issuingCountry","typeLabel":"string"}},"uniqueKey":"additionalCitizenship.personalIdentification","typeLabel":"object"}},"uniqueKey":"additionalCitizenship","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"gcid":123,"firstName":"\u003cstring>","middleName":"\u003cstring>","lastName":"\u003cstring>","gender":123,"dateOfBirth":"2023-12-25","placeOfBirthCountry":"US","citizenshipCountry":"US","personalIdentification":{"type":"\u003cstring>","value":"\u003cstring>","issuingCountry":"US"},"taxIds":[{"taxId":"\u003cstring>","country":"DE","primary":true}],"taxId":"\u003cstring>","taxIdCountry":"DE","additionalCitizenship":{"countryCode":"GB","personalIdentification":{"type":"\u003cstring>","value":"\u003cstring>","issuingCountry":"US"}}}}},"exampleType":"generated"}},"headers":{"RateLimit-Limit":{"description":"Maximum number of requests allowed per window. This is the default shared pool used by every endpoint without a dedicated limit, so it is NOT per-endpoint — requests across those endpoints all draw from this one budget.","schema":{"type":"integer"},"example":60},"RateLimit-Remaining":{"description":"Requests remaining in the current window for this quota.","schema":{"type":"integer"}},"RateLimit-Reset":{"description":"Seconds until the current window resets.","schema":{"type":"integer"}},"RateLimit-Policy":{"description":"Quota policy in the form `\u003climit>;w=\u003cwindow-seconds>`.","schema":{"type":"string"},"example":"60;w=60"}},"exampleType":"generated"},"e164271d-af66-4577-953a-cc8e06d7396e":{"description":"Structural validation failed for taxIds[].","content":{"application/json":{"schema":{"type":"object","properties":{"errorCode":{"type":"string","uniqueKey":"errorCode","typeLabel":"string"},"errorMessage":{"type":"string","uniqueKey":"errorMessage","typeLabel":"string"}},"uniqueKey":"","typeLabel":"object"},"examples":{"MissingRequiredField":{"title":"MissingRequiredField","summary":"An entry is missing taxId or country","value":{"errorCode":"MISSING_REQUIRED_FIELD","errorMessage":"taxIds[].taxId is required"}},"TooManyTaxIds":{"title":"TooManyTaxIds","summary":"More than 10 tax identifications supplied","value":{"errorCode":"TOO_MANY_TAX_IDS","errorMessage":"taxIds must not contain more than 10 items"}}},"exampleType":"examples"}},"exampleType":"examples"},"ea532113-7d2f-466f-91ba-4b5f7c476eee":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"errorCode":{"type":"string","uniqueKey":"errorCode","typeLabel":"string"},"errorMessage":{"type":"string","uniqueKey":"errorMessage","typeLabel":"string"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"errorCode":"\u003cstring>","errorMessage":"\u003cstring>"}}},"exampleType":"generated"}},"exampleType":"generated"},"702e8197-1572-430a-93d0-5af4841a7eb6":{"description":"Business validation failed, or the upstream KYC service rejected a tax identification (e.g. invalid number format, or missing residence-country tax id).","content":{"application/json":{"schema":{"type":"object","properties":{"errorCode":{"type":"string","uniqueKey":"errorCode","typeLabel":"string"},"errorMessage":{"type":"string","uniqueKey":"errorMessage","typeLabel":"string"}},"uniqueKey":"","typeLabel":"object"},"examples":{"DuplicateTaxIdCountry":{"title":"DuplicateTaxIdCountry","summary":"Two entries for the same country","value":{"errorCode":"DUPLICATE_TAX_ID_COUNTRY","errorMessage":"taxIds must not contain more than one entry for the same country"}},"MultiplePrimaryTaxIds":{"title":"MultiplePrimaryTaxIds","summary":"More than one entry flagged primary","value":{"errorCode":"MULTIPLE_PRIMARY_TAX_IDS","errorMessage":"Only one tax identification may be marked as primary"}},"InvalidTaxIdCountry":{"title":"InvalidTaxIdCountry","summary":"Unknown ISO 3166-1 alpha-2 country code","value":{"errorCode":"INVALID_TAX_ID_COUNTRY","errorMessage":"taxIds[].country 'XX' is not a valid ISO 3166-1 alpha-2 country code"}},"UpstreamRejected":{"title":"UpstreamRejected","summary":"Upstream KYC service rejected a tax identification","value":{"errorCode":"UPSTREAM_REJECTED","errorMessage":"The Tax Id without reason format is not valid."}}},"exampleType":"examples"}},"exampleType":"examples"},"edf277bd-598b-49cd-a3af-49c95f6fd504":{"description":"Too Many Requests — the shared rate limit (60 requests / 60s) was exceeded.","headers":{"RateLimit-Limit":{"description":"Maximum number of requests allowed per window. This is the default shared pool used by every endpoint without a dedicated limit, so it is NOT per-endpoint — requests across those endpoints all draw from this one budget.","schema":{"type":"integer"},"example":60},"RateLimit-Remaining":{"description":"Requests remaining in the current window for this quota.","schema":{"type":"integer"}},"RateLimit-Reset":{"description":"Seconds until the current window resets.","schema":{"type":"integer"}},"RateLimit-Policy":{"description":"Quota policy in the form `\u003climit>;w=\u003cwindow-seconds>`.","schema":{"type":"string"},"example":"60;w=60"},"Retry-After":{"description":"Seconds to wait before retrying.","schema":{"type":"integer"},"example":60}},"content":{"_mintlify/placeholder":{"schema":{"type":"object","description":""}}}},"29787aeb-67aa-427c-bb2b-be4a29fe3204":{"description":"The request could not be completed due to an unexpected error, typically an upstream KYC service failure (outage, timeout, or circuit open).","content":{"application/json":{"schema":{"type":"object","properties":{"errorCode":{"type":"string","uniqueKey":"errorCode","typeLabel":"string"},"errorMessage":{"type":"string","uniqueKey":"errorMessage","typeLabel":"string"}},"uniqueKey":"","typeLabel":"object"},"example":{"errorCode":"UserApiDependencyFailed","errorMessage":"UserApi dependency failed"},"examples":{"Example":{"title":"Example","value":{"errorCode":"UserApiDependencyFailed","errorMessage":"UserApi dependency failed"}}},"exampleType":"examples"}},"exampleType":"examples"}},"security":{"32f5b536-8a1c-4f18-ab1c-ea69a9feb1ab":{"apiKeyAuth":{"type":"apiKey","in":"header","name":"x-api-key","description":"API key of the application. Only valid together with the x-user-key header — the pair is an alternative to OAuth bearer authentication, never sent alongside it. The pair is granted the same permissions the operation's OAuth scopes describe.\n\nDemo credential for trying the API from these docs: `lhgfaslk21490FAScVPkdsb53F9dNkfHG4faZSG5vfjndfcfgdssdgsdHF4663`","scopes":[],"schemeName":"apiKeyAuth"},"userKeyAuth":{"type":"apiKey","in":"header","name":"x-user-key","description":"User-specific authentication key. Only valid together with the x-api-key header — the pair is an alternative to OAuth bearer authentication, never sent alongside it.\n\nDemo credential for trying the API from these docs: `eyJlYW4iOiJVbnJlZ2lzdGVyZWRBcHBsaWNhdGlvbiIsImVrIjoiOE5sZ2cwcW5EUVdROUFNWGpXT2lmOWktZnpidG5KcUlqWGJ3WHJZZkpZcldrbG90ZEhvLVBjSWhQaU8xU1ZtMW84aU1WZGZqN2xWNzFjLXFxLmcybXE1dnh4Q1hUT25xaWRUaTFlcEhmVk1fIn0_`","scopes":[],"schemeName":"userKeyAuth"}},"10595834-8563-4dc6-b9cf-032252c90728":{"oauth2":{"type":"oauth2","description":"etoro OAuth2 — send the access token as `Authorization: Bearer \u003ctoken>`. Each operation lists the scopes that grant access as separate `security` requirements (OpenAPI OR semantics): the caller's token only needs ONE of them — you do NOT need all of them. Mutually exclusive with the x-api-key/x-user-key credential pair: never send both.","flows":{"authorizationCode":{"authorizationUrl":"https://www.etoro.com/sso","tokenUrl":"https://www.etoro.com/api/sso/v1/token","scopes":{"etoro-public:demo:read":"Grants access to the 'etoro-public:demo:read' scope.","etoro-public:kyc:answers:read":"Grants access to the 'etoro-public:kyc:answers:read' scope.","etoro-public:kyc:answers:write":"Grants access to the 'etoro-public:kyc:answers:write' scope.","etoro-public:kyc:questions:read":"Grants access to the 'etoro-public:kyc:questions:read' scope.","etoro-public:kyc:read":"Grants access to the 'etoro-public:kyc:read' scope.","etoro-public:kyc:regulations:read":"Grants access to the 'etoro-public:kyc:regulations:read' scope.","etoro-public:kyc:write":"Grants access to the 'etoro-public:kyc:write' scope.","etoro-public:money.accounts:read":"Grants access to the 'etoro-public:money.accounts:read' scope.","etoro-public:money.accounts:write":"Grants access to the 'etoro-public:money.accounts:write' scope.","etoro-public:money.deposit.crypto:read":"Grants access to the 'etoro-public:money.deposit.crypto:read' scope.","etoro-public:money.deposit.crypto:write":"Grants access to the 'etoro-public:money.deposit.crypto:write' scope.","etoro-public:money.ftd:read":"Grants access to the 'etoro-public:money.ftd:read' scope.","etoro-public:money.ftd:write":"Grants access to the 'etoro-public:money.ftd:write' scope.","etoro-public:money.withdraw.crypto:read":"Grants access to the 'etoro-public:money.withdraw.crypto:read' scope.","etoro-public:money.withdraw.crypto:write":"Grants access to the 'etoro-public:money.withdraw.crypto:write' scope.","etoro-public:partner:registration:read":"Grants access to the 'etoro-public:partner:registration:read' scope.","etoro-public:partner:registration:write":"Grants access to the 'etoro-public:partner:registration:write' scope.","etoro-public:real:read":"Grants access to the 'etoro-public:real:read' scope.","etoro-public:sub-accounts:create":"Grants access to the 'etoro-public:sub-accounts:create' scope.","etoro-public:sub-accounts:delete":"Grants access to the 'etoro-public:sub-accounts:delete' scope.","etoro-public:verification.address:read":"Grants access to the 'etoro-public:verification.address:read' scope.","etoro-public:verification.address:write":"Grants access to the 'etoro-public:verification.address:write' scope.","etoro-public:verification.email:write":"Grants access to the 'etoro-public:verification.email:write' scope.","etoro-public:verification.personaldetails:read":"Grants access to the 'etoro-public:verification.personaldetails:read' scope.","etoro-public:verification.personaldetails:write":"Grants access to the 'etoro-public:verification.personaldetails:write' scope.","etoro-public:verification.phone:write":"Grants access to the 'etoro-public:verification.phone:write' scope.","etoro-public:verification.trusted.email:write":"Grants access to the 'etoro-public:verification.trusted.email:write' scope.","etoro-public:verification.trusted.phone:write":"Grants access to the 'etoro-public:verification.trusted.phone:write' scope.","etoro-public:verification:trusted:user:write":"Grants access to the 'etoro-public:verification:trusted:user:write' scope."}}},"scopes":["etoro-public:verification.personaldetails:write"],"schemeName":"oauth2"}}},"servers":{"e0851524-5431-447a-a347-d6923f70b4b9":{"url":"https://public-api.etoro.com","description":"etoro Public API - Partners"}},"processedSecurityOptions":[{"schemes":[{"scheme":{"type":"apiKey","in":"header","name":"x-api-key","description":"API key of the application. Only valid together with the x-user-key header — the pair is an alternative to OAuth bearer authentication, never sent alongside it. The pair is granted the same permissions the operation's OAuth scopes describe.\n\nDemo credential for trying the API from these docs: `lhgfaslk21490FAScVPkdsb53F9dNkfHG4faZSG5vfjndfcfgdssdgsdHF4663`","scopes":[],"schemeName":"apiKeyAuth"},"schema":{"title":"x-api-key","type":"string","description":"API key of the application. Only valid together with the x-user-key header — the pair is an alternative to OAuth bearer authentication, never sent alongside it. The pair is granted the same permissions the operation's OAuth scopes describe.\n\nDemo credential for trying the API from these docs: `lhgfaslk21490FAScVPkdsb53F9dNkfHG4faZSG5vfjndfcfgdssdgsdHF4663`","isRequired":true,"typeLabel":"string","deprecated":false},"schemeName":"apiKeyAuth","name":"x-api-key"},{"scheme":{"type":"apiKey","in":"header","name":"x-user-key","description":"User-specific authentication key. Only valid together with the x-api-key header — the pair is an alternative to OAuth bearer authentication, never sent alongside it.\n\nDemo credential for trying the API from these docs: `eyJlYW4iOiJVbnJlZ2lzdGVyZWRBcHBsaWNhdGlvbiIsImVrIjoiOE5sZ2cwcW5EUVdROUFNWGpXT2lmOWktZnpidG5KcUlqWGJ3WHJZZkpZcldrbG90ZEhvLVBjSWhQaU8xU1ZtMW84aU1WZGZqN2xWNzFjLXFxLmcybXE1dnh4Q1hUT25xaWRUaTFlcEhmVk1fIn0_`","scopes":[],"schemeName":"userKeyAuth"},"schema":{"title":"x-user-key","type":"string","description":"User-specific authentication key. Only valid together with the x-api-key header — the pair is an alternative to OAuth bearer authentication, never sent alongside it.\n\nDemo credential for trying the API from these docs: `eyJlYW4iOiJVbnJlZ2lzdGVyZWRBcHBsaWNhdGlvbiIsImVrIjoiOE5sZ2cwcW5EUVdROUFNWGpXT2lmOWktZnpidG5KcUlqWGJ3WHJZZkpZcldrbG90ZEhvLVBjSWhQaU8xU1ZtMW84aU1WZGZqN2xWNzFjLXFxLmcybXE1dnh4Q1hUT25xaWRUaTFlcEhmVk1fIn0_`","isRequired":true,"typeLabel":"string","deprecated":false},"schemeName":"userKeyAuth","name":"x-user-key"}],"title":"apiKeyAuth \u0026 userKeyAuth"},{"schemes":[{"scheme":{"type":"oauth2","description":"etoro OAuth2 — send the access token as `Authorization: Bearer \u003ctoken>`. Each operation lists the scopes that grant access as separate `security` requirements (OpenAPI OR semantics): the caller's token only needs ONE of them — you do NOT need all of them. Mutually exclusive with the x-api-key/x-user-key credential pair: never send both.","flows":{"authorizationCode":{"authorizationUrl":"https://www.etoro.com/sso","tokenUrl":"https://www.etoro.com/api/sso/v1/token","scopes":{"etoro-public:demo:read":"Grants access to the 'etoro-public:demo:read' scope.","etoro-public:kyc:answers:read":"Grants access to the 'etoro-public:kyc:answers:read' scope.","etoro-public:kyc:answers:write":"Grants access to the 'etoro-public:kyc:answers:write' scope.","etoro-public:kyc:questions:read":"Grants access to the 'etoro-public:kyc:questions:read' scope.","etoro-public:kyc:read":"Grants access to the 'etoro-public:kyc:read' scope.","etoro-public:kyc:regulations:read":"Grants access to the 'etoro-public:kyc:regulations:read' scope.","etoro-public:kyc:write":"Grants access to the 'etoro-public:kyc:write' scope.","etoro-public:money.accounts:read":"Grants access to the 'etoro-public:money.accounts:read' scope.","etoro-public:money.accounts:write":"Grants access to the 'etoro-public:money.accounts:write' scope.","etoro-public:money.deposit.crypto:read":"Grants access to the 'etoro-public:money.deposit.crypto:read' scope.","etoro-public:money.deposit.crypto:write":"Grants access to the 'etoro-public:money.deposit.crypto:write' scope.","etoro-public:money.ftd:read":"Grants access to the 'etoro-public:money.ftd:read' scope.","etoro-public:money.ftd:write":"Grants access to the 'etoro-public:money.ftd:write' scope.","etoro-public:money.withdraw.crypto:read":"Grants access to the 'etoro-public:money.withdraw.crypto:read' scope.","etoro-public:money.withdraw.crypto:write":"Grants access to the 'etoro-public:money.withdraw.crypto:write' scope.","etoro-public:partner:registration:read":"Grants access to the 'etoro-public:partner:registration:read' scope.","etoro-public:partner:registration:write":"Grants access to the 'etoro-public:partner:registration:write' scope.","etoro-public:real:read":"Grants access to the 'etoro-public:real:read' scope.","etoro-public:sub-accounts:create":"Grants access to the 'etoro-public:sub-accounts:create' scope.","etoro-public:sub-accounts:delete":"Grants access to the 'etoro-public:sub-accounts:delete' scope.","etoro-public:verification.address:read":"Grants access to the 'etoro-public:verification.address:read' scope.","etoro-public:verification.address:write":"Grants access to the 'etoro-public:verification.address:write' scope.","etoro-public:verification.email:write":"Grants access to the 'etoro-public:verification.email:write' scope.","etoro-public:verification.personaldetails:read":"Grants access to the 'etoro-public:verification.personaldetails:read' scope.","etoro-public:verification.personaldetails:write":"Grants access to the 'etoro-public:verification.personaldetails:write' scope.","etoro-public:verification.phone:write":"Grants access to the 'etoro-public:verification.phone:write' scope.","etoro-public:verification.trusted.email:write":"Grants access to the 'etoro-public:verification.trusted.email:write' scope.","etoro-public:verification.trusted.phone:write":"Grants access to the 'etoro-public:verification.trusted.phone:write' scope.","etoro-public:verification:trusted:user:write":"Grants access to the 'etoro-public:verification:trusted:user:write' scope."}}},"scopes":["etoro-public:verification.personaldetails:write"],"schemeName":"oauth2"},"schema":{"title":"OAuth2 Auth","type":"string","isRequired":true,"description":"etoro OAuth2 — send the access token as `Authorization: Bearer \u003ctoken>`. Each operation lists the scopes that grant access as separate `security` requirements (OpenAPI OR semantics): the caller's token only needs ONE of them — you do NOT need all of them. Mutually exclusive with the x-api-key/x-user-key credential pair: never send both.","format":"bearer","typeLabel":"string\u003cbearer>","deprecated":false},"schemeName":"oauth2","name":"Authorization"}],"title":"oauth2"}]},"originalFileLocation":"api-reference/partners-openapi.json"},"subdomain":"etoro-6fc30280","siteName":"etoro API Docs","title":"Update KYC Personal Details - etoro API Docs","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-11-22T09:13:28.561Z","originalFileLocation":"partners-api-reference/kyc/update-kyc-personal-details.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=\"Rate limit: 60 requests per 60 seconds. This is the default shared quota — it is shared with every other endpoint that has no dedicated limit, so requests across those endpoints all draw from the same budget. --- Updates the authenticated user\u0026#x27;s KYC personal details. Supports partial updates - any subset of the fields may be supplied and omitted fields are left unchanged. Tax identifications are supplied via taxIds[] and support multiple jurisdictions; when present, taxIds[] replaces the full set of tax identifications on the user record. The deprecated single taxId/taxIdCountry fields are still accepted for backward compatibility and are used only when taxIds[] is absent. Tax-id number format is validated per country by the upstream KYC service.\">\u003cmeta data-mint-head name=\"application-name\" content=\"etoro API Docs\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/etoro-6fc30280/sCsBGcUYX-CTk40V/_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/etoro-6fc30280/sCsBGcUYX-CTk40V/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/etoro-6fc30280/sCsBGcUYX-CTk40V/_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/etoro-6fc30280/sCsBGcUYX-CTk40V/_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/etoro-6fc30280/sCsBGcUYX-CTk40V/_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/etoro-6fc30280/sCsBGcUYX-CTk40V/_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/etoro-6fc30280/sCsBGcUYX-CTk40V/_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/etoro-6fc30280/sCsBGcUYX-CTk40V/_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/etoro-6fc30280/sCsBGcUYX-CTk40V/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Update KYC Personal Details - etoro API Docs\">\u003cmeta data-mint-head property=\"og:description\" content=\"Rate limit: 60 requests per 60 seconds. This is the default shared quota — it is shared with every other endpoint that has no dedicated limit, so requests across those endpoints all draw from the same budget. --- Updates the authenticated user\u0026#x27;s KYC personal details. Supports partial updates - any subset of the fields may be supplied and omitted fields are left unchanged. Tax identifications are supplied via taxIds[] and support multiple jurisdictions; when present, taxIds[] replaces the full set of tax identifications on the user record. The deprecated single taxId/taxIdCountry fields are still accepted for backward compatibility and are used only when taxIds[] is absent. Tax-id number format is validated per country by the upstream KYC service.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"etoro API Docs\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://api-portal.etoro.com/partners-api-reference/kyc/update-kyc-personal-details\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://etoro-6fc30280.mintlify.site/_mintlify/api/og/v2?division=KYC\u0026amp;title=Update+KYC+Personal+Details\u0026amp;description=**Rate+limit%3A**+60+requests+per+60+seconds.+This+is+the+**default+shared+quota**+%E2%80%94+it+is+shared+with+every+other+endpoint+that+has+no+dedicated+limit%2C+so+reques\u0026amp;theme=846b12a90f6ef610305b3580\u0026amp;signature=5ab014d67b4a014d4144f5a54a301db070af41d6ea6d5ff618645c487d827f64\">\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 KYC Personal Details - etoro API Docs\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Rate limit: 60 requests per 60 seconds. This is the default shared quota — it is shared with every other endpoint that has no dedicated limit, so requests across those endpoints all draw from the same budget. --- Updates the authenticated user\u0026#x27;s KYC personal details. Supports partial updates - any subset of the fields may be supplied and omitted fields are left unchanged. Tax identifications are supplied via taxIds[] and support multiple jurisdictions; when present, taxIds[] replaces the full set of tax identifications on the user record. The deprecated single taxId/taxIdCountry fields are still accepted for backward compatibility and are used only when taxIds[] is absent. Tax-id number format is validated per country by the upstream KYC service.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://etoro-6fc30280.mintlify.site/_mintlify/api/og/v2?division=KYC\u0026amp;title=Update+KYC+Personal+Details\u0026amp;description=**Rate+limit%3A**+60+requests+per+60+seconds.+This+is+the+**default+shared+quota**+%E2%80%94+it+is+shared+with+every+other+endpoint+that+has+no+dedicated+limit%2C+so+reques\u0026amp;theme=846b12a90f6ef610305b3580\u0026amp;signature=5ab014d67b4a014d4144f5a54a301db070af41d6ea6d5ff618645c487d827f64\">\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/etoro-6fc30280/sCsBGcUYX-CTk40V/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"etoro API Docs\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#16A34A\">\u003clink data-mint-head rel=\"canonical\" href=\"https://api-portal.etoro.com/partners-api-reference/kyc/update-kyc-personal-details\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/partners-api-reference/kyc/update-kyc-personal-details.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://api-portal.etoro.com/#organization\",\"name\":\"etoro API Docs\",\"url\":\"https://api-portal.etoro.com\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/etoro-6fc30280/KKUNTvuhL1tWIl3G/images/logo.svg?fit=max\u0026auto=format\u0026n=KKUNTvuhL1tWIl3G\u0026q=85\u0026s=7bbb280a3f86decc927b143516fd5b80\"}},{\"@type\":\"WebSite\",\"@id\":\"https://api-portal.etoro.com#website\",\"name\":\"etoro API Docs\",\"url\":\"https://api-portal.etoro.com\",\"publisher\":{\"@id\":\"https://api-portal.etoro.com/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://api-portal.etoro.com/partners-api-reference/kyc/update-kyc-personal-details#webpage\",\"url\":\"https://api-portal.etoro.com/partners-api-reference/kyc/update-kyc-personal-details\",\"name\":\"Update KYC Personal Details\",\"description\":\"Rate limit: 60 requests per 60 seconds. This is the default shared quota — it is shared with every other endpoint that has no dedicated limit, so requests across those endpoints all draw from the same budget. --- Updates the authenticated user's KYC personal details. Supports partial updates - any subset of the fields may be supplied and omitted fields are left unchanged. Tax identifications are supplied via taxIds[] and support multiple jurisdictions; when present, taxIds[] replaces the full set of tax identifications on the user record. The deprecated single taxId/taxIdCountry fields are still accepted for backward compatibility and are used only when taxIds[] is absent. Tax-id number format is validated per country by the upstream KYC service.\",\"dateModified\":\"2026-11-22T09:13:28.561Z\",\"isPartOf\":{\"@id\":\"https://api-portal.etoro.com#website\"},\"breadcrumb\":{\"@id\":\"https://api-portal.etoro.com/partners-api-reference/kyc/update-kyc-personal-details#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://api-portal.etoro.com/partners-api-reference/kyc/update-kyc-personal-details#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Partners API\",\"item\":\"https://api-portal.etoro.com/partners-api-reference/registration/partner-registers-a-new-etoro-user\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Create the user\",\"item\":\"https://api-portal.etoro.com/partners-api-reference/registration/partner-registers-a-new-etoro-user\"},{\"@type\":\"ListItem\",\"position\":3,\"name\":\"KYC\",\"item\":\"https://api-portal.etoro.com/partners-api-reference/kyc/get-kyc-questionnaire\"},{\"@type\":\"ListItem\",\"position\":4,\"name\":\"Update KYC Personal Details\",\"item\":\"https://api-portal.etoro.com/partners-api-reference/kyc/update-kyc-personal-details\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://api-portal.etoro.com/partners-api-reference/kyc/update-kyc-personal-details#apireference\",\"headline\":\"Update KYC Personal Details\",\"name\":\"Update KYC Personal Details\",\"description\":\"Rate limit: 60 requests per 60 seconds. This is the default shared quota — it is shared with every other endpoint that has no dedicated limit, so requests across those endpoints all draw from the same budget. --- Updates the authenticated user's KYC personal details. Supports partial updates - any subset of the fields may be supplied and omitted fields are left unchanged. Tax identifications are supplied via taxIds[] and support multiple jurisdictions; when present, taxIds[] replaces the full set of tax identifications on the user record. The deprecated single taxId/taxIdCountry fields are still accepted for backward compatibility and are used only when taxIds[] is absent. Tax-id number format is validated per country by the upstream KYC service.\",\"url\":\"https://api-portal.etoro.com/partners-api-reference/kyc/update-kyc-personal-details\",\"mainEntityOfPage\":{\"@id\":\"https://api-portal.etoro.com/partners-api-reference/kyc/update-kyc-personal-details#webpage\"},\"dateModified\":\"2026-11-22T09:13:28.561Z\",\"publisher\":{\"@id\":\"https://api-portal.etoro.com/#organization\"},\"isPartOf\":{\"@id\":\"https://api-portal.etoro.com#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"etoro API Docs\",\"publisher\":{\"@type\":\"Organization\",\"name\":\"etoro API Docs\"},\"provider\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","agentPointerHref":"/partners-api-reference/kyc/update-kyc-personal-details.md","siteName":"etoro API Docs","nav":{"global":null,"tabs":[{"tab":"Core API","pages":[{"title":"Core API","href":""}]},{"tab":"Partners API","groups":[{"group":"Getting started","pages":[{"title":"Introduction","href":"/partners/introduction"},{"title":"Start here","href":"/partners/start-here"}]},{"group":"Guides","pages":[{"title":"Partner integration flow","href":"/partners/integration"},{"title":"Register users, submit KYC, and sign them in","href":"/partners/guides/user-onboarding"}]},{"group":"Events","pages":[{"title":"Overview","href":"/partners/events-from-etoro"},{"group":"KYC","pages":[{"title":"KycUpdates","href":"/partners/events/kyc-updates"}]}]},{"group":"Partners API","pages":[{"group":"Create the user","pages":[{"group":"Registration","pages":[{"title":"Partner registers a new etoro user","deprecated":null,"version":null,"openapi":"/api-reference/partners-openapi.json post /api/v1/registration/users","href":"/partners-api-reference/registration/partner-registers-a-new-etoro-user"},{"title":"Get registration eligibility","deprecated":null,"version":null,"openapi":"/api-reference/partners-openapi.json get /api/v1/registration/users/eligibility","href":"/partners-api-reference/registration/get-registration-eligibility"}]},{"group":"KYC","pages":[{"title":"Get KYC Questionnaire","deprecated":null,"version":null,"openapi":"/api-reference/partners-openapi.json get /api/v1/kyc-data/questionnaire","href":"/partners-api-reference/kyc/get-kyc-questionnaire"},{"title":"Submit KYC Questionnaire Answers","deprecated":null,"version":null,"openapi":"/api-reference/partners-openapi.json post /api/v1/kyc-data/questionnaire","href":"/partners-api-reference/kyc/submit-kyc-questionnaire-answers"},{"title":"Submit Single KYC Questionnaire Answer","deprecated":null,"version":null,"openapi":"/api-reference/partners-openapi.json post /api/v1/kyc-data/questionnaire/{questionId}","href":"/partners-api-reference/kyc/submit-single-kyc-questionnaire-answer"},{"title":"Get Single KYC Questionnaire Question","deprecated":null,"version":null,"openapi":"/api-reference/partners-openapi.json get /api/v1/kyc-data/questionnaire/{questionId}","href":"/partners-api-reference/kyc/get-single-kyc-questionnaire-question"},{"title":"Get KYC Fields","deprecated":null,"version":null,"openapi":"/api-reference/partners-openapi.json post /api/v1/kyc-fields","href":"/partners-api-reference/kyc/get-kyc-fields"},{"title":"Get requirement categories dictionary","deprecated":null,"version":null,"openapi":"/api-reference/partners-openapi.json get /api/v1/kyc/dictionary/requirements/category","href":"/partners-api-reference/kyc/get-requirement-categories-dictionary"},{"title":"Get requirement overview statuses dictionary","deprecated":null,"version":null,"openapi":"/api-reference/partners-openapi.json get /api/v1/kyc/dictionary/requirements/overviewStatus","href":"/partners-api-reference/kyc/get-requirement-overview-statuses-dictionary"},{"title":"Get requirement status reasons dictionary","deprecated":null,"version":null,"openapi":"/api-reference/partners-openapi.json get /api/v1/kyc/dictionary/requirements/statusReason","href":"/partners-api-reference/kyc/get-requirement-status-reasons-dictionary"},{"title":"Get requirement types dictionary","deprecated":null,"version":null,"openapi":"/api-reference/partners-openapi.json get /api/v1/kyc/dictionary/requirements/type","href":"/partners-api-reference/kyc/get-requirement-types-dictionary"},{"title":"Get user interaction types dictionary","deprecated":null,"version":null,"openapi":"/api-reference/partners-openapi.json get /api/v1/kyc/dictionary/userInteractions/type","href":"/partners-api-reference/kyc/get-user-interaction-types-dictionary"},{"title":"Get customer KYC gaps","deprecated":null,"version":null,"openapi":"/api-reference/partners-openapi.json get /api/v1/kyc/gaps","href":"/partners-api-reference/kyc/get-customer-kyc-gaps"},{"title":"Get KYC questions-answers mapping","deprecated":null,"version":null,"openapi":"/api-reference/partners-openapi.json get /api/v1/kyc/questions","href":"/partners-api-reference/kyc/get-kyc-questions-answers-mapping"},{"title":"Get KYC question-answers mapping by question ID","deprecated":null,"version":null,"openapi":"/api-reference/partners-openapi.json get /api/v1/kyc/questions/{questionId}","href":"/partners-api-reference/kyc/get-kyc-question-answers-mapping-by-question-id"},{"title":"Get KYC Regulations","deprecated":null,"version":null,"openapi":"/api-reference/partners-openapi.json get /api/v1/kyc/regulations","href":"/partners-api-reference/kyc/get-kyc-regulations"},{"title":"Update KYC Address","deprecated":null,"version":null,"openapi":"/api-reference/partners-openapi.json put /api/v1/users/address/{addressType}","href":"/partners-api-reference/kyc/update-kyc-address"},{"title":"Get KYC Address","deprecated":null,"version":null,"openapi":"/api-reference/partners-openapi.json get /api/v1/users/address/{addressType}","href":"/partners-api-reference/kyc/get-kyc-address"},{"title":"Get Contact Info","description":"**Rate limit:** 60 requests per 60 seconds. This is the **default shared quota** — it is shared with every other endpoint that has no dedicated limit, so requests across those endpoints all draw from the same budget.\n\n---\n\nReturns the authenticated user's contact information (email and phone number, read-only).","deprecated":null,"version":null,"openapi":"/api-reference/partners-openapi.json get /api/v1/users/contact-info","href":"/partners-api-reference/kyc/get-contact-info"},{"title":"Update KYC Personal Details","deprecated":null,"version":null,"openapi":"/api-reference/partners-openapi.json put /api/v1/users/personaldetails","href":"/partners-api-reference/kyc/update-kyc-personal-details"},{"title":"Get KYC Personal Details","description":"**Rate limit:** 60 requests per 60 seconds. This is the **default shared quota** — it is shared with every other endpoint that has no dedicated limit, so requests across those endpoints all draw from the same budget.\n\n---\n\nReturns the authenticated user's KYC personal details, including identification, citizenship and tax information.","deprecated":null,"version":null,"openapi":"/api-reference/partners-openapi.json get /api/v1/users/personaldetails","href":"/partners-api-reference/kyc/get-kyc-personal-details"},{"title":"Get KYC Fields (V2)","deprecated":null,"version":null,"openapi":"/api-reference/partners-openapi.json post /api/v2/kyc-fields","href":"/partners-api-reference/kyc/get-kyc-fields-v2"},{"title":"Get KYC Metadata Mappings","deprecated":null,"version":null,"openapi":"/api-reference/partners-openapi.json get /api/v2/kyc/mappers","href":"/partners-api-reference/kyc/get-kyc-metadata-mappings"},{"title":"Get Verification Level 3 Gaps","deprecated":null,"version":null,"openapi":"/api-reference/partners-openapi.json get /api/v2/kyc/verification-level-gaps","href":"/partners-api-reference/kyc/get-verification-level-3-gaps"}]},{"group":"Email Verification","pages":[{"title":"Send email verification code","deprecated":null,"version":null,"openapi":"/api-reference/partners-openapi.json post /api/v1/users/email/verifications","href":"/partners-api-reference/email-verification/send-email-verification-code"},{"title":"Verify email with OTP code","deprecated":null,"version":null,"openapi":"/api-reference/partners-openapi.json post /api/v1/users/email/verifications/confirmations","href":"/partners-api-reference/email-verification/verify-email-with-otp-code"},{"title":"Direct email verification (trusted partner)","deprecated":null,"version":null,"openapi":"/api-reference/partners-openapi.json post /api/v1/users/email/verifications/direct-confirmations","href":"/partners-api-reference/email-verification/direct-email-verification-trusted-partner"}]},{"group":"Phone Verification","pages":[{"title":"Initiate phone verification","deprecated":null,"version":null,"openapi":"/api-reference/partners-openapi.json post /api/v1/users/phone/verifications","href":"/partners-api-reference/phone-verification/initiate-phone-verification"},{"title":"Verify phone with verification code","deprecated":null,"version":null,"openapi":"/api-reference/partners-openapi.json post /api/v1/users/phone/verifications/confirmations","href":"/partners-api-reference/phone-verification/verify-phone-with-verification-code"},{"title":"Direct phone verification (trusted partner)","deprecated":null,"version":null,"openapi":"/api-reference/partners-openapi.json post /api/v1/users/phone/verifications/direct-confirmations","href":"/partners-api-reference/phone-verification/direct-phone-verification-trusted-partner"}]},{"group":"Verification","pages":[{"title":"Submit trusted partner verification","deprecated":null,"version":null,"openapi":"/api-reference/partners-openapi.json post /api/v1/users/verification","href":"/partners-api-reference/verification/submit-trusted-partner-verification"}]},{"group":"Trusted Partner","pages":[{"title":"Direct email verification (trusted partner)","deprecated":null,"version":null,"openapi":"/api-reference/partners-openapi.json post /api/v1/users/email/verifications/direct-confirmations","href":"/partners-api-reference/email-verification/direct-email-verification-trusted-partner"},{"title":"Direct phone verification (trusted partner)","deprecated":null,"version":null,"openapi":"/api-reference/partners-openapi.json post /api/v1/users/phone/verifications/direct-confirmations","href":"/partners-api-reference/phone-verification/direct-phone-verification-trusted-partner"},{"title":"Submit trusted partner verification","deprecated":null,"version":null,"openapi":"/api-reference/partners-openapi.json post /api/v1/users/verification","href":"/partners-api-reference/verification/submit-trusted-partner-verification"}]}]},{"group":"Connect an existing account","pages":[{"group":"Sub-Accounts","pages":[{"title":"Create Account","deprecated":null,"version":null,"openapi":"/api-reference/partners-openapi.json post /api/v1/sub-accounts","href":"/partners-api-reference/sub-accounts/create-account"},{"title":"Delete Accounts","deprecated":null,"version":null,"openapi":"/api-reference/partners-openapi.json delete /api/v1/sub-accounts","href":"/partners-api-reference/sub-accounts/delete-accounts"}]}]},{"group":"Money","pages":[{"group":"Cash Accounts","pages":[{"title":"Create a cash account","deprecated":null,"version":null,"openapi":"/api-reference/partners-openapi.json post /api/v1/money/accounts/cash","href":"/partners-api-reference/cash-accounts/create-a-cash-account"},{"title":"Get user cash accounts","deprecated":null,"version":null,"openapi":"/api-reference/partners-openapi.json get /api/v1/money/accounts/cash","href":"/partners-api-reference/cash-accounts/get-user-cash-accounts"},{"title":"Get cash account creation eligibility","deprecated":null,"version":null,"openapi":"/api-reference/partners-openapi.json get /api/v1/money/accounts/cash/eligibility","href":"/partners-api-reference/cash-accounts/get-cash-account-creation-eligibility"},{"title":"Get cash account creation status","deprecated":null,"version":null,"openapi":"/api-reference/partners-openapi.json get /api/v1/money/accounts/cash/status","href":"/partners-api-reference/cash-accounts/get-cash-account-creation-status"},{"title":"Get cash account by id","deprecated":null,"version":null,"openapi":"/api-reference/partners-openapi.json get /api/v1/money/accounts/cash/{accountId}","href":"/partners-api-reference/cash-accounts/get-cash-account-by-id"}]},{"group":"FTD","pages":[{"title":"Get account-specific first-time deposit(s)","deprecated":null,"version":null,"openapi":"/api-reference/partners-openapi.json get /api/v1/money/accounts/{accountType}/first-time-deposit","href":"/partners-api-reference/ftd/get-account-specific-first-time-deposits"},{"title":"Notify deposit from partner (async)","deprecated":null,"version":null,"openapi":"/api-reference/partners-openapi.json post /api/v1/money/deposit/notify","href":"/partners-api-reference/ftd/notify-deposit-from-partner-async"},{"title":"Get global first-time deposit","deprecated":null,"version":null,"openapi":"/api-reference/partners-openapi.json get /api/v1/money/first-time-deposit","href":"/partners-api-reference/ftd/get-global-first-time-deposit"}]},{"group":"Crypto Deposit","pages":[{"title":"Crypto deposit eligibility","deprecated":null,"version":null,"openapi":"/api-reference/partners-openapi.json get /api/v1/money/deposit/crypto/eligibility","href":"/partners-api-reference/crypto-deposit/crypto-deposit-eligibility"},{"title":"Initiate a crypto deposit intent","deprecated":null,"version":null,"openapi":"/api-reference/partners-openapi.json post /api/v1/money/deposit/crypto/intent","href":"/partners-api-reference/crypto-deposit/initiate-a-crypto-deposit-intent"},{"title":"Lookup crypto deposit by request reference ID","deprecated":null,"version":null,"openapi":"/api-reference/partners-openapi.json get /api/v1/money/deposit/crypto:lookup","href":"/partners-api-reference/crypto-deposit/lookup-crypto-deposit-by-request-reference-id"}]},{"group":"Crypto Withdrawals","pages":[{"title":"Submit trading account withdrawal","deprecated":null,"version":null,"openapi":"/api-reference/partners-openapi.json post /api/v1/money/withdraw/crypto/accounts/trading","href":"/partners-api-reference/crypto-withdrawals/submit-trading-account-withdrawal"},{"title":"Trading account withdrawal approval process eligibility","deprecated":null,"version":null,"openapi":"/api-reference/partners-openapi.json get /api/v1/money/withdraw/crypto/accounts/trading/approval-process-eligibility","href":"/partners-api-reference/crypto-withdrawals/trading-account-withdrawal-approval-process-eligibility"},{"title":"Trading account withdrawal eligibility","deprecated":null,"version":null,"openapi":"/api-reference/partners-openapi.json get /api/v1/money/withdraw/crypto/accounts/trading/eligibility","href":"/partners-api-reference/crypto-withdrawals/trading-account-withdrawal-eligibility"},{"title":"Trading account withdrawal status","deprecated":null,"version":null,"openapi":"/api-reference/partners-openapi.json get /api/v1/money/withdraw/crypto/accounts/trading/status","href":"/partners-api-reference/crypto-withdrawals/trading-account-withdrawal-status"}]}]},{"group":"Operations","pages":[{"group":"OPS","pages":[{"title":"Initiate GDPR user deletion","deprecated":null,"version":null,"openapi":"/api-reference/partners-openapi.json delete /api/v1/gdpr/users","href":"/partners-api-reference/ops/initiate-gdpr-user-deletion"},{"title":"Get application identifiers dictionary","deprecated":null,"version":null,"openapi":"/api-reference/partners-openapi.json get /api/v1/kyc/dictionary/documents/applicationIdentifier","href":"/partners-api-reference/ops/get-application-identifiers-dictionary"},{"title":"Get document sides dictionary","deprecated":null,"version":null,"openapi":"/api-reference/partners-openapi.json get /api/v1/kyc/dictionary/documents/side","href":"/partners-api-reference/ops/get-document-sides-dictionary"},{"title":"Get document subtypes dictionary","deprecated":null,"version":null,"openapi":"/api-reference/partners-openapi.json get /api/v1/kyc/dictionary/documents/subType","href":"/partners-api-reference/ops/get-document-subtypes-dictionary"},{"title":"Get document types dictionary","deprecated":null,"version":null,"openapi":"/api-reference/partners-openapi.json get /api/v1/kyc/dictionary/documents/type","href":"/partners-api-reference/ops/get-document-types-dictionary"},{"title":"Get EV statuses dictionary","deprecated":null,"version":null,"openapi":"/api-reference/partners-openapi.json get /api/v1/kyc/dictionary/ev/status","href":"/partners-api-reference/ops/get-ev-statuses-dictionary"},{"title":"Get screening statuses dictionary","deprecated":null,"version":null,"openapi":"/api-reference/partners-openapi.json get /api/v1/kyc/dictionary/screening/status","href":"/partners-api-reference/ops/get-screening-statuses-dictionary"},{"title":"Upload document","deprecated":null,"version":null,"openapi":"/api-reference/partners-openapi.json post /api/v1/kyc/document","href":"/partners-api-reference/ops/upload-document"},{"title":"Download document","deprecated":null,"version":null,"openapi":"/api-reference/partners-openapi.json get /api/v1/kyc/document/{documentId}","href":"/partners-api-reference/ops/download-document"},{"title":"Get customer documents","deprecated":null,"version":null,"openapi":"/api-reference/partners-openapi.json get /api/v1/kyc/documents","href":"/partners-api-reference/ops/get-customer-documents"},{"title":"Add document classification","deprecated":null,"version":null,"openapi":"/api-reference/partners-openapi.json post /api/v1/kyc/documents/{documentId}/classifications","href":"/partners-api-reference/ops/add-document-classification"},{"title":"Get electronic verification status","deprecated":null,"version":null,"openapi":"/api-reference/partners-openapi.json get /api/v1/kyc/ev","href":"/partners-api-reference/ops/get-electronic-verification-status"},{"title":"Send user to electronic verification","deprecated":null,"version":null,"openapi":"/api-reference/partners-openapi.json post /api/v1/kyc/ev","href":"/partners-api-reference/ops/send-user-to-electronic-verification"},{"title":"Get screening status","deprecated":null,"version":null,"openapi":"/api-reference/partners-openapi.json get /api/v1/kyc/screening","href":"/partners-api-reference/ops/get-screening-status"},{"title":"Send user to screening","deprecated":null,"version":null,"openapi":"/api-reference/partners-openapi.json post /api/v1/kyc/screening","href":"/partners-api-reference/ops/send-user-to-screening"}]}]}]},{"group":"Changelog","pages":[{"title":"Partners API Changelog","href":"/partners/changelog"}]}]}]},"basePath":"","title":"Update KYC Personal Details - etoro API Docs","deploymentId":"dpl_DyXGnKeCjZyA3sUdfMJ7FjkdBefg","buildId":"dpl_DyXGnKeCjZyA3sUdfMJ7FjkdBefg","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-CiUHMMOm.js","snippetPresets-BgfXU7Bw.js","utils-DWvOwgy_.js","style-to-object-BY3JEAdk.js","utils-BN7RXSMJ.js","v4-DIgz8zy6.js","addUniqueKeysToSchema-CFw8bq89.js","conditional-requirements-CFM0id0Q.js","cloneDeep-CAwdfOU2.js","_Uint8Array-BJr8e-ZL.js","isObject-FP1Yky1u.js","ApiExamples-XX0UgMZK.js","usePlaygroundInputsStore-DXDFSa1V.js","shallow-CdX5aREi.js","isEqual-CoOaxexF.js","CodeSnippets-Cg2wpzWm.js","CodeSnippet-D_HwgQO_.js","getApiPlaygroundDisplay-CmCoerhe.js","Page-CVJ-f_k1.js","DynamicMarkdown-CQM9Bhbv.js","SectionHeading-DpbrP8nQ.js","icon-BPCgijHy.js","MethodPill-GQ8DuY0c.js","getPastedJson-Cb5mT31m.js","Check2Icon-a7bUI6e8.js","axios-CsQoIw0U.js","Markdown-CX2QY19L.js","AssistantPageLink-CY3bFglh.js","dist-Dl6_zDnT.js","lib-DMeTj1gb.js","lib-B8HbPgcC.js","katex-Dbtb6Wk7.js","html-void-elements-mCSPHezU.js","marked.esm-CZWythHk.js"]}