Unique Document Issuer endpoints and internal documentation.
The Unique Document issuer exposes endpoints for issuing and migrating credentials. For product-level credential semantics, Sybil-resistance guarantees, and validity details, see Proof of Attributes.
The base URL is environment-specific. Contact your World ID point of contact for
environment endpoints and access.
Migration
This endpoint is intended for World ID v3 holders to obtain v4 credentials. It is not a general re-issuance endpoint for v4 holders.
POST
/v2/migrate
Content-Type:application/json
Request
Headers
Header
Required
Description
x-zkp-proof string
yes
Base64-encoded JSON containing the ZKP proof and identity commitment.
attestation-gateway-token string
yes
Attestation gateway token for device integrity verification.
Body fields
Field
Required
Description
identityCommitment string
yes
The holder’s identity commitment (decimal or hex with 0x
prefix). Must match the ZKP header.
sub string
yes
World ID 4.0 blinded subject identifier (hex with 0x
prefix, 256-bit). Must match previous migrations for this identity.
credential object
yes
Flow-specific credential data (see below). The client decrypts PCP data
locally before submission.
Credential fields
Passport / eID
MNC (My Number Card)
The credential object contains data extracted and decrypted from the user’s Personal Custody Package (PCP) by the client.
Field
Description
credential.sod string
Base64-encoded SOD (Security Object Document) in DER format from
the identity document.
credential.verification_metadata string
Base64-encoded verification metadata from the original document
check.
{ "result": { "credential": "<base64-encoded World ID v4 credential>" }}
Error responses
Status
Error
Description
400
invalid_data
Request payload is malformed or missing required fields.
400
sub_mismatch
sub does not match the one used in previous migrations for this identity.
400
document_expired
The identity document has expired and cannot be used for migration.
401
unauthorized
Authentication failed.
404
not_found
No matching enrollment record found for this credential.
Planned Endpoints
Enrollment Coming soon
Details coming soon.
Re-issuance Coming soon
Details coming soon.
Implementation Notes
This is advanced documentation about the internal workings of the credential and is not relevant for RP integration.
Associated Data
The associated data of this credential contains different data groups found in the original document. More information coming soon.
Associated Data Commitment
To ensure the associated data has guaranteed integrity and can be re-used in the future for credential re-issuance, the commitment is computed as follows:
For ICAO-9303 documents, the message digest of the EF.SOD signature is used. The message digest is obtained from SignedData.SignerInfos[0].SignedAttrs where the signed attribute for the digest is identified by the Object Identifier 1.2.840.113549.1.9.4. This digest is then hashed with the blake3 hashing function from the raw bytes. Finally, the blake3 hash is converted to a field element with modulo reduction.
Information on MNC documents coming soon.
Was this page helpful?
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"World Documentation","colors":{"primary":"#007CFB","light":"#4B5563","dark":"#000000"},"logo":{"light":"https://mintcdn.com/tfh/qWu-FiJulvyUF2-J/logo/world-developers.svg?fit=max\u0026auto=format\u0026n=qWu-FiJulvyUF2-J\u0026q=85\u0026s=4019b92f6b5143abe368c7e608bac5e2","dark":"https://mintcdn.com/tfh/qWu-FiJulvyUF2-J/logo/world-developers-white.svg?fit=max\u0026auto=format\u0026n=qWu-FiJulvyUF2-J\u0026q=85\u0026s=12c968192e5d61404ba02e494368cee7"},"favicon":"https://mintcdn.com/tfh/QgV5KXRTJlR7G1Sc/favicon.ico?fit=max\u0026auto=format\u0026n=QgV5KXRTJlR7G1Sc\u0026q=85\u0026s=35ec0697e348f319bf61974f6ab09777","api":{"playground":{"display":"interactive"},"examples":{"defaults":"required","languages":["curl","javascript"],"prefill":true}},"background":{"color":{"light":"#F9F9F8"}},"footer":{"socials":{"x":"https://x.com/worldnetwork","github":"https://github.com/worldcoin","discord":"https://world.org/discord"},"links":[{"items":[{"label":"About World","href":"https://world.org"},{"label":"Developers","href":"https://world.org/developers"},{"label":"Whitepaper","href":"https://whitepaper.world.org"},{"label":"Open Source","href":"https://github.com/worldcoin"},{"label":"Ecosystem","href":"https://world.org/ecosystem"},{"label":"Careers","href":"https://world.org/careers"}]}]},"seo":{"metatags":{"canonical":"https://docs.world.org","description":"Developer documentation for building with World ID, Mini Apps, and World Chain.","og:title":"World Developer Docs","og:description":"Build with World ID, Mini Apps, and World Chain.","og:image":"https://raw.githubusercontent.com/worldcoin/developer-docs/main/images/docs/docs-meta.png","og:image:type":"image/png","og:type":"website","og:site_name":"World Documentation","og:locale":"en_US","twitter:card":"summary_large_image","twitter:image":"https://raw.githubusercontent.com/worldcoin/developer-docs/main/images/docs/docs-meta.png","twitter:site":"@worldcoin","theme-color":"#000000","referrer":"origin-when-cross-origin"},"indexing":"all"},"fonts":{"heading":{"family":"World Pro MVP","weight":600,"source":"fonts/WorldProMVPVF-v2.woff2","format":"woff2"},"body":{"family":"World Pro MVP","weight":300,"source":"fonts/WorldProMVPVF-v2.woff2","format":"woff2"}},"styling":{"codeblocks":"system","latex":true},"contextual":{"options":["copy","view","chatgpt","claude","perplexity","mcp","cursor","vscode"],"display":"header"},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"tfh","hasAudioNarration":false,"actualSubdomain":"tfh","customDomains":["docs.world.org"],"gitSource":{"type":"github","owner":"worldcoin","repo":"developer-docs","deployBranch":"main","contentDirectory":"","isPrivate":true,"mountPath":"","label":""},"feedback":{"thumbs":true,"issues":true},"entitlements":{"AI_CHAT":{"status":"ENABLED"},"WEB_MCP":{"status":"ENABLED"},"NARRATION":{"status":"ENABLED"}},"buildId":"6afcb1aa443d5da9b6b94600","clientVersion":"0.0.4205","searchFilterCounts":[{"language":"default","tag":"Mini Apps","count":49},{"language":"default","tag":"API Reference","count":31},{"language":"default","tag":"World ID","count":28},{"language":"default","tag":"World Chain","count":27},{"language":"default","tag":"Technical Reference","count":16},{"language":"default","tag":"IDKit","count":16},{"language":"default","tag":"Commands","count":15},{"language":"default","tag":"Developer Portal","count":12},{"language":"default","tag":"Agent Pass","count":11},{"language":"default","tag":"World ID Gateway","count":11}]},"assistantConfig":{},"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":"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":"control","enabled":true,"payload":{"type":"string","value":"control"},"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":"tailwind.css","content":"@tailwind base;@tailwind components;@tailwind utilities;@layer base{html{font-family:\"World Pro MVP\",\n ui-sans-serif,\n system-ui,\n -apple-system,\n \"Segoe UI\",\n Roboto,\n \"Helvetica Neue\",\n Arial,\n \"Noto Sans\",\n \"Apple Color Emoji\",\n \"Segoe UI Emoji\",\n \"Segoe UI Symbol\"}}@layer components{#sidebar-content li[data-active=\"true\"]>a{background-color:#F3F2F0!important;color:#181818!important;border-radius:6px!important;text-shadow:none!important}.dark #sidebar-content li[data-active=\"true\"]>a{background-color:rgba(255, 255, 255, 0.08)!important;color:#F3F2F0!important}.dark img[src*=\"/icons/credentials/human-emblem.svg\"]{filter:invert(1)}.prose a:not([class]),.prose a:not([class]):hover,.prose a:not([class]):focus{color:#1989fb!important;text-decoration:none!important;background-image:none!important;border-bottom:none!important;box-shadow:none!important}.img-miniapps-template{width:220px!important;max-width:220px!important;height:auto!important}[data-component-name=\"mermaid-container\"]{container:mermaid / inline-size;display:flex;flex-direction:column}[data-component-name=\"mermaid-container\"]>.mermaid{min-width:0}[data-component-name=\"mermaid-container\"]>.mermaid>svg{max-width:100%;height:auto}@container mermaid (max-width: 40rem){[data-component-name=\"mermaid-container\"]>.mermaid{order:0;width:100%;overflow-x:auto;overscroll-behavior-x:contain}[data-component-name=\"mermaid-container\"]>.mermaid>svg{max-width:none}[data-component-name=\"mermaid-container\"]>[data-component-name=\"mermaid-controls-wrapper\"]{position:static!important;order:1;align-self:flex-end;margin-block:0.75rem 0.25rem;opacity:1!important;pointer-events:auto!important}[data-component-name=\"mermaid-container\"]>[data-component-name=\"mermaid-controls-wrapper\"] button{min-width:2.75rem;min-height:2.75rem}}select,select option{color:inherit}:root select option{background-color:#ffffff;color:#0f172a}.dark select option{background-color:#0b1220;color:#e5e7eb}#navbar .nav-tabs{align-items:center;gap:0!important}#navbar .nav-tabs-item[href^=\"/agent-pass/\"],a.mobile-nav-tabs-item[href^=\"/agent-pass/\"]{display:none!important}#navbar .nav-tabs-item{height:32px!important;padding:6px 10px;border-radius:42px;color:#181818!important;transition:background-color 0.15s ease}#navbar .nav-tabs-item:hover{color:#181818!important;background-color:#F3F2F0}#navbar .nav-tabs-item[data-active=\"true\"]{padding:6px 14px;background-color:#181818;color:#F9F9F8!important;text-shadow:none}#navbar .nav-tabs-item[data-active=\"true\"]:hover{color:#F9F9F8!important;background-color:#181818}#navbar .nav-tabs-item>div.absolute{display:none}#navbar .nav-tabs>button.nav-tabs-item:first-of-type{margin-left:17px}#navbar .nav-tabs>button.nav-tabs-item:first-of-type::before{content:\"\";position:absolute;left:-9px;top:50%;transform:translateY(-50%);width:1px;height:24px;background-color:#E1DFDA}.dark #navbar .nav-tabs>button.nav-tabs-item:first-of-type::before{background-color:rgba(255, 255, 255, 0.15)}.dark #navbar .nav-tabs-item{color:#F3F2F0!important}.dark #navbar .nav-tabs-item:hover{color:#F3F2F0!important;background-color:rgba(255, 255, 255, 0.08)}.dark #navbar .nav-tabs-item[data-active=\"true\"],.dark #navbar .nav-tabs-item[data-active=\"true\"]:hover{background-color:#F3F2F0;color:#181818!important}#navbar #search-bar-entry{border-radius:20px;background-color:#F9F9F8;box-shadow:none;--tw-ring-color: #E1DFDA;color:#181818}.dark #navbar #search-bar-entry{background-color:rgb(24, 25, 27);--tw-ring-color: rgba(255, 255, 255, 0.15);color:#F3F2F0}#topbar-cta-button a>span.absolute{border-radius:20px}#navbar{container-type:inline-size}div:has(>#navbar){container-type:inline-size}@container (min-width: 1440px){#navbar #navbar-transition{display:none}#navbar{margin-top:24px}#navbar>div.max-w-8xl{display:flex;align-items:center;column-gap:16px;width:calc(100% - 7.3cqw);max-width:1602px!important;height:84px;margin:0 auto;padding:0 25px 0 33px;background-color:#FFFFFF;border:1px solid #E1DFDA;border-radius:18px;box-shadow:0px 15px 20px -5px rgba(0, 0, 0, 0.03)}.dark #navbar>div.max-w-8xl{background-color:rgb(24, 25, 27);border-color:rgba(255, 255, 255, 0.12)}#navbar>div.max-w-8xl>div,#navbar>div.max-w-8xl>div>div.relative,#navbar div.lg\\:px-12,#navbar div.lg\\:px-12>div{display:contents!important}#navbar div.lg\\:px-12>div>div.flex-1:first-child{order:1;flex:0 0 auto!important}#navbar .nav-tabs-item{white-space:nowrap}#navbar .max-w-8xl>div>div.px-12{order:2;position:static;width:max-content;flex-shrink:0;height:auto!important;padding:0!important;margin-left:auto}#navbar div.lg\\:px-12 div.z-20{order:3;flex:0 0 auto!important;margin-left:auto}#navbar div.lg\\:px-12 .nav-logo{height:17.5px!important}#navbar #search-bar-entry{width:auto!important;height:34px!important;padding:6px 14px!important;border-radius:20px;box-shadow:none}#navbar #search-bar-entry span.text-xs{display:none}#navbar #assistant-entry{height:34px!important;padding:6px 14px!important;border-radius:20px!important;background-color:#F9F9F8!important;border:1px solid #E1DFDA!important;box-shadow:none!important;color:#181818!important}#navbar #assistant-entry kbd,#navbar #assistant-entry .text-xs{display:none!important}.dark #navbar #assistant-entry{background-color:rgb(24, 25, 27)!important;border-color:rgba(255, 255, 255, 0.15)!important;color:#F3F2F0!important}#navbar div.lg\\:px-12>div>div.justify-end{display:none!important}}#navbar #theme-preference-menu-trigger{display:none!important}.quickstart-code .code-block{margin-top:0.5rem!important;margin-bottom:0.75rem!important}.quickstart-code .code-block .code-block-background,.quickstart-code .code-block .code-block-background pre.shiki{background:transparent!important;background-color:transparent!important}.quickstart-code .code-block [data-fade-overlay=\"true\"]{display:none!important}div[data-assistant-bar]{display:none!important}body>div.z-999.cursor-grab.touch-none[role=\"status\"]{display:none!important}a.product-card{display:flex;align-items:flex-start;gap:24px;text-decoration:none}.product-card-tile{display:flex;align-items:center;justify-content:center;width:105px;height:112px;border-radius:24px;background-color:#F3F2F0;flex-shrink:0;transition:background-color 0.15s ease}.product-card:hover .product-card-tile{background-color:#EDECE9}.dark .product-card-tile{background-color:rgb(24, 25, 27)}.dark .product-card:hover .product-card-tile{background-color:rgb(32, 33, 36)}.product-card-title{color:#181818}.dark .product-card-title{color:#FFFFFF}.product-card-desc{color:#75726F}.dark .product-card-desc{color:rgb(158, 162, 166)}.dark .product-card-icon{filter:invert(1)}.landing-section-title{font-size:48px;line-height:1.15;letter-spacing:-0.96px;font-weight:300;color:#181818}.dark .landing-section-title{color:#F3F2F0}.landing-section-sub{margin-top:12px;font-size:18px;line-height:1.4;font-weight:300;color:#75726F}.dark .landing-section-sub{color:rgb(158, 162, 166)}@media (max-width: 600px){.landing-section-title{font-size:32px;letter-spacing:-0.64px}}.landing-story-card{width:calc((100% - 96px) / 2 - 12px);aspect-ratio:4 / 3}@media (min-width: 901px){.landing-stories-track{margin-right:-96px}}@media (max-width: 900px){.landing-story-card{width:85%}}.landing-stories-track{scrollbar-width:none}.landing-stories-track::-webkit-scrollbar{display:none}.landing-carousel-arrow{background-color:#FFFFFF;border:1px solid #E1DFDA;color:#181818;transition:background-color 0.15s ease}.landing-carousel-arrow:hover{background-color:#F3F2F0}.dark .landing-carousel-arrow{background-color:rgb(24, 25, 27);border-color:rgba(255, 255, 255, 0.15);color:#F3F2F0}.dark .landing-carousel-arrow:hover{background-color:rgb(32, 33, 36)}.landing-update{display:block;padding:40px 0;border-top:1px solid #E1DFDA;text-decoration:none}.landing-update:last-child{border-bottom:1px solid #E1DFDA}.dark .landing-update{border-color:rgba(255, 255, 255, 0.12)}.landing-update-title{font-size:24px;line-height:1.3;letter-spacing:-0.24px;font-weight:300;color:#181818}.landing-update:hover .landing-update-title{text-decoration:underline;text-underline-offset:4px}.dark .landing-update-title{color:#F3F2F0}.landing-update-desc{margin:12px 0 0;max-width:886px;font-size:16px;line-height:1.5;font-weight:300;color:#75726F}.dark .landing-update-desc{color:rgb(158, 162, 166)}.landing-hero{color:#2D2C2C}.dark .landing-hero{color:#F3F2F0}.landing-link{color:#181818}.landing-link svg{fill:#181818}.dark .landing-link{color:#F3F2F0}.dark .landing-link svg{fill:#F3F2F0}.landing-footer{padding:0}.landing-footer-inner{max-width:1728px;margin:0 auto;padding:0 96px 64px;display:flex;flex-direction:column;gap:64px}.landing-newsletter{background-color:#F3F2F0;border-radius:16px;padding:128px 40px}.dark .landing-newsletter{background-color:#161618}.landing-newsletter-title{color:#181818}.dark .landing-newsletter-title{color:#F3F2F0}.landing-email-field{background-color:#FFFFFF}.dark .landing-email-field{background-color:#2D2C2C}.landing-email-input{color:#2D2C2C}.landing-email-input::placeholder{color:#9D9B96}.dark .landing-email-input{color:#F3F2F0}.dark .landing-email-input::placeholder{color:#75726F}.landing-privacy-link{color:#2D2C2C!important}.dark .landing-privacy-link{color:#F3F2F0!important}.landing-footer-link{color:#181818;text-decoration:none}.landing-footer-link:hover{text-decoration:underline}.dark .landing-footer-link{color:#F3F2F0}.landing-footer-links{color:#181818}.dark .landing-footer-links{color:#F3F2F0}#footer.advanced-footer{border-top:none!important}#footer.advanced-footer>div{max-width:1728px!important}@media (min-width: 1024px){#footer.advanced-footer>div{padding:96px 96px 48px!important}}#footer.advanced-footer .nav-logo{display:none!important}#footer.advanced-footer a.select-none::after{content:\"™ 2026 World\";font-size:16px;line-height:1.4;font-weight:300;color:#181818;white-space:nowrap}.dark #footer.advanced-footer a.select-none::after{color:#F3F2F0}@media (min-width: 768px){#footer.advanced-footer .md\\:justify-center{justify-content:flex-end!important;gap:40px!important}}#footer.advanced-footer a[class*=\"max-w-36\"]{max-width:none!important;font-size:16px!important;line-height:1.4;font-weight:300;color:#181818!important}#footer.advanced-footer a[class*=\"max-w-36\"]:hover{color:#181818!important;text-decoration:underline;text-underline-offset:4px}.dark #footer.advanced-footer a[class*=\"max-w-36\"],.dark #footer.advanced-footer a[class*=\"max-w-36\"]:hover{color:#F3F2F0!important}#footer.advanced-footer div[class*=\"min-w-[140px]\"]{display:none!important}#footer.advanced-footer>div>div.h-px,#footer.advanced-footer>div>div:last-child{display:none!important}@media (max-width: 900px){.landing-footer-inner{padding:0 24px 48px;gap:48px}.landing-newsletter{padding:64px 24px}.landing-footer-links{gap:16px 40px!important}}@media (max-width: 600px){.landing-footer-inner{padding:0 16px 40px}.landing-newsletter{padding:40px 20px}.landing-newsletter-title{font-size:24px!important;letter-spacing:-0.48px!important}.landing-email-field{padding:6px 6px 6px 20px!important}.landing-email-input{font-size:18px!important}.landing-footer-links{gap:12px 32px!important}}.landing-hero-title{font-size:64px;line-height:1.1;letter-spacing:-1.28px;font-weight:300;color:#181818}.dark .landing-hero-title{color:#F3F2F0}.landing-hero-sub{margin-top:24px;max-width:487px;font-size:24px;line-height:1.35;letter-spacing:-0.24px;font-weight:300;color:#75726F}.dark .landing-hero-sub{color:rgb(158, 162, 166)}@media (max-width: 600px){.landing-hero-title{font-size:40px;letter-spacing:-0.8px}.landing-hero-sub{font-size:18px}}.landing-card-grid{display:grid;grid-template-columns:repeat(2, 1fr);column-gap:80px;row-gap:113px}@media (max-width: 900px){.landing-card-grid{grid-template-columns:1fr;row-gap:40px}.product-card-tile{width:84px;height:90px}.product-card .product-card-title{font-size:24px!important}}.landing-container{max-width:1728px;margin:0 auto;padding:60px 96px 0;width:100%;box-sizing:border-box}@media (max-width: 900px){.landing-container{padding:40px 24px 0}}@media (max-width: 600px){.landing-container{padding:32px 16px 0}}@media (min-width: 1024px){#navbar [class~=\"max-w-8xl\"],body:has(#navbar.is-not-custom) [class*=\"max-w-8xl\"]{max-width:1728px!important}#navbar .lg\\:px-12,#navbar .px-12{padding-left:96px!important;padding-right:96px!important}body:has(#navbar.is-not-custom) div[class*=\"is-not-custom]:px-4\"]{padding-left:80px!important;padding-right:80px!important}}}"}],"page":{"pagePath":"world-id/reference/issuer-9303","slug":"/world-id/reference/issuer-9303","pageMetadata":{"title":"Unique Document Issuer","description":"Unique Document Issuer endpoints and internal documentation.","og:image":"https://raw.githubusercontent.com/worldcoin/developer-docs/main/images/docs/docs-meta.png","twitter:image":"https://raw.githubusercontent.com/worldcoin/developer-docs/main/images/docs/docs-meta.png","href":"/world-id/reference/issuer-9303"},"description":{"compiledSource":"\"use strict\";\nconst {jsx: _jsx} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsx(_components.p, {\n children: \"Unique Document Issuer endpoints and internal documentation.\"\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,jsxs:_jsxs}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){const _components={a:`a`,code:`code`,li:`li`,ol:`ol`,p:`p`,pre:`pre`,span:`span`,strong:`strong`,tbody:`tbody`,td:`td`,th:`th`,thead:`thead`,tr:`tr`,..._provideComponents(),...props.components},{Badge,CodeBlock,Heading,Note,ParamField,Tab,Table,Tabs,Warning}=_components;if(!Badge)_missingMdxReference(`Badge`,true);if(!CodeBlock)_missingMdxReference(`CodeBlock`,true);if(!Heading)_missingMdxReference(`Heading`,true);if(!Note)_missingMdxReference(`Note`,true);if(!ParamField)_missingMdxReference(`ParamField`,true);if(!Tab)_missingMdxReference(`Tab`,true);if(!Table)_missingMdxReference(`Table`,true);if(!Tabs)_missingMdxReference(`Tabs`,true);if(!Warning)_missingMdxReference(`Warning`,true);return _jsxs(_Fragment,{children:[_jsxs(_components.p,{children:[`The Unique Document issuer exposes endpoints for issuing and migrating credentials. For product-level credential semantics, Sybil-resistance guarantees, and validity details, see `,_jsx(_components.a,{href:`/world-id/credentials/9303`,children:`Proof of Attributes`}),`.`]}),`\n`,_jsx(Note,{children:_jsx(_components.p,{children:`The base URL is environment-specific. Contact your World ID point of contact for\nenvironment endpoints and access.`})}),`\n`,_jsx(Heading,{level:`2`,id:`migration`,children:`Migration`}),`\n`,_jsx(Warning,{children:_jsx(_components.p,{children:`This endpoint is intended for World ID v3 holders to obtain v4 credentials. It is not a general re-issuance endpoint for v4 holders.`})}),`\n`,_jsx(ParamField,{path:`method`,type:`POST`,id:`param-method`,children:_jsx(_components.p,{children:`/v2/migrate`})}),`\n`,_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Content-Type:`}),` `,_jsx(_components.code,{children:`application/json`})]}),`\n`,_jsx(Heading,{level:`3`,id:`request`,children:`Request`}),`\n`,_jsx(Heading,{level:`4`,id:`headers`,children:`Headers`}),`\n`,_jsxs(`table`,{children:[_jsx(`thead`,{children:_jsxs(`tr`,{children:[_jsx(`th`,{className:`mint-whitespace-nowrap`,children:`Header`}),_jsx(`th`,{children:`Required`}),_jsx(`th`,{children:`Description`})]})}),_jsxs(`tbody`,{children:[_jsxs(`tr`,{children:[_jsxs(`td`,{className:`mint-whitespace-nowrap`,children:[_jsx(`code`,{children:`x-zkp-proof`}),_jsx(`br`,{}),_jsx(`code`,{children:`string`})]}),_jsx(`td`,{children:`yes`}),_jsx(`td`,{children:`Base64-encoded JSON containing the ZKP proof and identity commitment.`})]}),_jsxs(`tr`,{children:[_jsxs(`td`,{className:`mint-whitespace-nowrap`,children:[_jsx(`code`,{children:`attestation-gateway-token`}),_jsx(`br`,{}),_jsx(`code`,{children:`string`})]}),_jsx(`td`,{children:`yes`}),_jsx(`td`,{children:`Attestation gateway token for device integrity verification.`})]})]})]}),`\n`,_jsx(Heading,{level:`4`,id:`body-fields`,children:`Body fields`}),`\n`,_jsxs(`table`,{children:[_jsx(`thead`,{children:_jsxs(`tr`,{children:[_jsx(`th`,{className:`mint-whitespace-nowrap`,children:`Field`}),_jsx(`th`,{children:`Required`}),_jsx(`th`,{children:`Description`})]})}),_jsxs(`tbody`,{children:[_jsxs(`tr`,{children:[_jsxs(`td`,{className:`mint-whitespace-nowrap`,children:[_jsx(`code`,{children:`identityCommitment`}),_jsx(`br`,{}),_jsx(`code`,{children:`string`})]}),_jsx(`td`,{children:`yes`}),_jsx(`td`,{children:_jsxs(_components.p,{children:[`The holder’s identity commitment (decimal or hex with `,_jsx(`code`,{children:`0x`}),` `,`\nprefix). Must match the ZKP header.`]})})]}),_jsxs(`tr`,{children:[_jsxs(`td`,{className:`mint-whitespace-nowrap`,children:[_jsx(`code`,{children:`sub`}),_jsx(`br`,{}),_jsx(`code`,{children:`string`})]}),_jsx(`td`,{children:`yes`}),_jsx(`td`,{children:_jsxs(_components.p,{children:[`World ID 4.0 blinded subject identifier (hex with `,_jsx(`code`,{children:`0x`}),` `,`\nprefix, 256-bit). Must match previous migrations for this identity.`]})})]}),_jsxs(`tr`,{children:[_jsxs(`td`,{className:`mint-whitespace-nowrap`,children:[_jsx(`code`,{children:`credential`}),_jsx(`br`,{}),_jsx(`code`,{children:`object`})]}),_jsx(`td`,{children:`yes`}),_jsx(`td`,{children:_jsx(_components.p,{children:`Flow-specific credential data (see below). The client decrypts PCP data\nlocally before submission.`})})]})]})]}),`\n`,_jsx(Heading,{level:`4`,id:`credential-fields`,children:`Credential fields`}),`\n`,_jsxs(Tabs,{children:[_jsxs(Tab,{title:`Passport / eID`,id:`passport-%2F-eid`,children:[_jsxs(_components.p,{children:[`The `,_jsx(_components.code,{children:`credential`}),` object contains data extracted and decrypted from the user’s Personal Custody Package (PCP) by the client.`]}),_jsxs(`table`,{children:[_jsx(`thead`,{children:_jsxs(`tr`,{children:[_jsx(`th`,{className:`mint-whitespace-nowrap`,children:`Field`}),_jsx(`th`,{children:`Description`})]})}),_jsxs(`tbody`,{children:[_jsxs(`tr`,{children:[_jsxs(`td`,{className:`mint-whitespace-nowrap`,children:[_jsx(`code`,{children:`credential.sod`}),_jsx(`br`,{}),_jsx(`code`,{children:`string`})]}),_jsx(`td`,{children:_jsx(_components.p,{children:`Base64-encoded SOD (Security Object Document) in DER format from\nthe identity document.`})})]}),_jsxs(`tr`,{children:[_jsxs(`td`,{className:`mint-whitespace-nowrap`,children:[_jsx(`code`,{children:`credential.verification_metadata`}),_jsx(`br`,{}),_jsx(`code`,{children:`string`})]}),_jsx(`td`,{children:_jsx(_components.p,{children:`Base64-encoded verification metadata from the original document\ncheck.`})})]})]})]}),_jsx(CodeBlock,{filename:``,numberOfLines:`8`,language:`json`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`json`,children:_jsxs(_components.code,{language:`json`,numberOfLines:`8`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`{`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"identityCommitment\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"0x000000000000000000000000000000000000000000000000000000000000000c\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"sub\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"0x000000000000000000000000000000000000000000000000000000000000002a\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"credential\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: {`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"sod\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"\u003cbase64-sod-der>\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"verification_metadata\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"\u003cbase64-json>\"`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` }`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`}`})}),`\n`]})})})]}),_jsxs(Tab,{title:`MNC (My Number Card)`,id:`mnc-my-number-card`,children:[_jsxs(`table`,{children:[_jsx(`thead`,{children:_jsxs(`tr`,{children:[_jsx(`th`,{className:`mint-whitespace-nowrap`,children:`Field`}),_jsx(`th`,{children:`Description`})]})}),_jsx(`tbody`,{children:_jsxs(`tr`,{children:[_jsxs(`td`,{className:`mint-whitespace-nowrap`,children:[_jsx(`code`,{children:`credential.sd_jwt`}),_jsx(`br`,{}),_jsx(`code`,{children:`string`})]}),_jsx(`td`,{children:`SD-JWT (Selective Disclosure JWT) from the MNC verification flow.`})]})})]}),_jsx(CodeBlock,{filename:``,numberOfLines:`7`,language:`json`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`json`,children:_jsxs(_components.code,{language:`json`,numberOfLines:`7`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`{`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"identityCommitment\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"0x000000000000000000000000000000000000000000000000000000000000000c\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"sub\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"0x000000000000000000000000000000000000000000000000000000000000002a\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"credential\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: {`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"sd_jwt\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"\u003csd-jwt-string>\"`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` }`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`}`})}),`\n`]})})})]})]}),`\n`,_jsx(Heading,{level:`3`,id:`response`,children:`Response`}),`\n`,_jsx(Heading,{level:`4`,id:`success-response`,children:`Success response`}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`5`,language:`json`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`json`,children:_jsxs(_components.code,{language:`json`,numberOfLines:`5`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`{`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"result\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: {`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"credential\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"\u003cbase64-encoded World ID v4 credential>\"`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` }`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`}`})}),`\n`]})})}),`\n`,_jsx(Heading,{level:`4`,id:`error-responses`,children:`Error responses`}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Status`}),_jsx(_components.th,{children:`Error`}),_jsx(_components.th,{children:`Description`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,children:`400`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`invalid_data`})}),_jsx(_components.td,{children:`Request payload is malformed or missing required fields.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,children:`400`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`sub_mismatch`})}),_jsxs(_components.td,{children:[_jsx(_components.code,{children:`sub`}),` does not match the one used in previous migrations for this identity.`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,children:`400`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`document_expired`})}),_jsx(_components.td,{children:`The identity document has expired and cannot be used for migration.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,children:`401`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`unauthorized`})}),_jsx(_components.td,{children:`Authentication failed.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,children:`404`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`not_found`})}),_jsx(_components.td,{children:`No matching enrollment record found for this credential.`})]})]})]}),`\n`,_jsx(Heading,{level:`2`,id:`planned-endpoints`,children:`Planned Endpoints`}),`\n`,_jsxs(Heading,{level:`3`,id:`enrollment-coming-soon`,children:[`Enrollment `,_jsx(Badge,{disabled:true,icon:`lock`,color:`blue`,children:`Coming soon`})]}),`\n`,_jsx(_components.p,{children:`Details coming soon.`}),`\n`,_jsxs(Heading,{level:`3`,id:`re-issuance-coming-soon`,children:[`Re-issuance `,_jsx(Badge,{disabled:true,icon:`lock`,color:`blue`,children:`Coming soon`})]}),`\n`,_jsx(_components.p,{children:`Details coming soon.`}),`\n`,_jsx(Heading,{level:`2`,id:`implementation-notes`,children:`Implementation Notes`}),`\n`,_jsx(Note,{children:_jsx(_components.p,{children:`This is advanced documentation about the internal workings of the credential and is not relevant for RP integration.`})}),`\n`,_jsx(Heading,{level:`3`,id:`associated-data`,children:`Associated Data`}),`\n`,_jsx(_components.p,{children:`The associated data of this credential contains different data groups found in the original document. More information coming soon.`}),`\n`,_jsx(Heading,{level:`4`,id:`associated-data-commitment`,children:`Associated Data Commitment`}),`\n`,_jsx(_components.p,{children:`To ensure the associated data has guaranteed integrity and can be re-used in the future for credential re-issuance, the commitment is computed as follows:`}),`\n`,_jsxs(_components.ol,{children:[`\n`,_jsxs(_components.li,{children:[`For ICAO-9303 documents, the message digest of the `,_jsx(_components.code,{children:`EF.SOD`}),` signature is used. The message digest is obtained from `,_jsx(_components.code,{children:`SignedData.SignerInfos[0].SignedAttrs`}),` where the signed attribute for the digest is identified by the Object Identifier `,_jsx(_components.code,{children:`1.2.840.113549.1.9.4`}),`. This digest is then hashed with the `,_jsx(_components.code,{children:`blake3`}),` hashing function from the raw bytes. Finally, the `,_jsx(_components.code,{children:`blake3`}),` hash is converted to a field element with modulo reduction.`]}),`\n`,_jsx(_components.li,{children:`Information on MNC documents coming soon.`}),`\n`]})]})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent};function _missingMdxReference(id,component){throw new Error(`Expected `+(component?`component`:`object`)+\" `\"+id+\"` to be defined: you likely forgot to import, pass, or provide it.\")}","frontmatter":{},"scope":{"codeStyling":"system","config":{},"pageMetadata":{"title":"Unique Document Issuer","description":"Unique Document Issuer endpoints and internal documentation.","og:image":"https://raw.githubusercontent.com/worldcoin/developer-docs/main/images/docs/docs-meta.png","twitter:image":"https://raw.githubusercontent.com/worldcoin/developer-docs/main/images/docs/docs-meta.png","href":"/world-id/reference/issuer-9303"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[{"title":"Migration","slug":"migration","depth":2,"children":[{"title":"Request","slug":"request","depth":3,"children":[]},{"title":"Headers","slug":"headers","depth":4,"children":[]},{"title":"Body fields","slug":"body-fields","depth":4,"children":[]},{"title":"Credential fields","slug":"credential-fields","depth":4,"children":[]},{"title":"Response","slug":"response","depth":3,"children":[]},{"title":"Success response","slug":"success-response","depth":4,"children":[]},{"title":"Error responses","slug":"error-responses","depth":4,"children":[]}]},{"title":"Planned Endpoints","slug":"planned-endpoints","depth":2,"children":[{"title":"Enrollment Coming soon","slug":"enrollment-coming-soon","depth":3,"children":[]},{"title":"Re-issuance Coming soon","slug":"re-issuance-coming-soon","depth":3,"children":[]}]},{"title":"Implementation Notes","slug":"implementation-notes","depth":2,"children":[{"title":"Associated Data","slug":"associated-data","depth":3,"children":[]},{"title":"Associated Data Commitment","slug":"associated-data-commitment","depth":4,"children":[]}]}],"codeExamples":{}},"jsLinks":[],"dynamicCss":".mint-whitespace-nowrap {\n white-space: nowrap\n}","subdomain":"tfh","siteName":"World Documentation","title":"World Developer Docs","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-11-12T21:55:03.392Z","originalFileLocation":"world-id/reference/issuer-9303.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=\"Unique Document Issuer endpoints and internal documentation.\">\u003cmeta data-mint-head name=\"application-name\" content=\"World Documentation\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/tfh/SP2ajHCQBmwCHsCV/_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/tfh/SP2ajHCQBmwCHsCV/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/tfh/SP2ajHCQBmwCHsCV/_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/tfh/SP2ajHCQBmwCHsCV/_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/tfh/SP2ajHCQBmwCHsCV/_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/tfh/SP2ajHCQBmwCHsCV/_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/tfh/SP2ajHCQBmwCHsCV/_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/tfh/SP2ajHCQBmwCHsCV/_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/tfh/SP2ajHCQBmwCHsCV/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"World Developer Docs\">\u003cmeta data-mint-head property=\"og:description\" content=\"Build with World ID, Mini Apps, and World Chain.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"World Documentation\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.world.org/world-id/reference/issuer-9303\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://raw.githubusercontent.com/worldcoin/developer-docs/main/images/docs/docs-meta.png\">\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=\"World Developer Docs\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Build with World ID, Mini Apps, and World Chain.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://raw.githubusercontent.com/worldcoin/developer-docs/main/images/docs/docs-meta.png\">\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/tfh/SP2ajHCQBmwCHsCV/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"World Documentation\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#007CFB\">\u003cmeta data-mint-head name=\"og:locale\" content=\"en_US\">\u003cmeta data-mint-head name=\"og:image:type\" content=\"image/png\">\u003cmeta data-mint-head name=\"theme-color\" content=\"#000000\">\u003cmeta data-mint-head name=\"referrer\" content=\"origin-when-cross-origin\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.world.org/world-id/reference/issuer-9303\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/world-id/reference/issuer-9303.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.world.org/#organization\",\"name\":\"World Documentation\",\"url\":\"https://docs.world.org\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/tfh/qWu-FiJulvyUF2-J/logo/world-developers.svg?fit=max\u0026auto=format\u0026n=qWu-FiJulvyUF2-J\u0026q=85\u0026s=4019b92f6b5143abe368c7e608bac5e2\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.world.org#website\",\"name\":\"World Documentation\",\"url\":\"https://docs.world.org\",\"publisher\":{\"@id\":\"https://docs.world.org/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.world.org/world-id/reference/issuer-9303#webpage\",\"url\":\"https://docs.world.org/world-id/reference/issuer-9303\",\"name\":\"Unique Document Issuer\",\"description\":\"Unique Document Issuer endpoints and internal documentation.\",\"dateModified\":\"2026-11-12T21:55:03.392Z\",\"isPartOf\":{\"@id\":\"https://docs.world.org#website\"},\"breadcrumb\":{\"@id\":\"https://docs.world.org/world-id/reference/issuer-9303#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.world.org/world-id/reference/issuer-9303#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"World ID Issuers\",\"item\":\"https://docs.world.org/world-id/reference/issuer-1\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Unique Document Issuer\",\"item\":\"https://docs.world.org/world-id/reference/issuer-9303\"}]},{\"@type\":[\"Article\",\"TechArticle\"],\"@id\":\"https://docs.world.org/world-id/reference/issuer-9303#article\",\"headline\":\"Unique Document Issuer\",\"name\":\"Unique Document Issuer\",\"description\":\"Unique Document Issuer endpoints and internal documentation.\",\"url\":\"https://docs.world.org/world-id/reference/issuer-9303\",\"mainEntityOfPage\":{\"@id\":\"https://docs.world.org/world-id/reference/issuer-9303#webpage\"},\"image\":\"https://raw.githubusercontent.com/worldcoin/developer-docs/main/images/docs/docs-meta.png\",\"dateModified\":\"2026-11-12T21:55:03.392Z\",\"publisher\":{\"@id\":\"https://docs.world.org/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.world.org#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"World Documentation\",\"publisher\":{\"@type\":\"Organization\",\"name\":\"World Documentation\"},\"provider\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","agentPointerHref":"/world-id/reference/issuer-9303.md","siteName":"World Documentation","nav":{"global":null,"tabs":[{"tab":"Home","pages":[{"title":"Home","href":""}]},{"tab":"World ID","pages":[{"title":"World ID","href":"/world-id/overview"}]},{"tab":"Agent Pass","hidden":true,"searchable":true,"pages":[{"title":"Agent Pass","href":"/agent-pass/quickstart"}]},{"tab":"Mini Apps","pages":[{"title":"Mini Apps","href":"/mini-apps"}]},{"tab":"World Chain","pages":[{"title":"World Chain","href":"/world-chain"}]},{"tab":"API Reference","groups":[{"group":"Developer Portal","pages":[{"title":"Verify","deprecated":null,"version":null,"sidebarTitle":"Verify","openapi":"/openapi/developer-portal.json post /api/v4/verify/{rp_id}","href":"/api-reference/developer-portal/verify"},{"title":"Verify (Legacy)","deprecated":null,"version":null,"sidebarTitle":"Verify legacy","openapi":"/openapi/developer-portal.json post /api/v2/verify/{app_id}","href":"/api-reference/developer-portal/verify-legacy"},{"title":"Send Notification","deprecated":null,"version":null,"sidebarTitle":"Send notification","openapi":"/openapi/developer-portal.json post /api/v2/minikit/send-notification","href":"/api-reference/developer-portal/send-notification"},{"title":"Get Transaction","deprecated":null,"version":null,"sidebarTitle":"Get transaction","openapi":"/openapi/developer-portal.json get /api/v2/minikit/transaction/{transaction_id}","href":"/api-reference/developer-portal/get-transaction"},{"title":"Get User Operation","deprecated":null,"version":null,"sidebarTitle":"Get user operation","openapi":"/openapi/developer-portal.json get /api/v2/minikit/userop/{user_op_hash}","href":"/api-reference/developer-portal/get-user-operation"},{"title":"Get Transaction Debug URL","deprecated":null,"version":null,"sidebarTitle":"Get transaction debug url","openapi":"/openapi/developer-portal.json get /api/v2/minikit/transaction/debug","href":"/api-reference/developer-portal/get-transaction-debug-url"},{"title":"Get User Grant Cycle","deprecated":null,"version":null,"sidebarTitle":"Get user grant cycle","openapi":"/openapi/developer-portal.json get /api/v2/minikit/user-grant-cycle","href":"/api-reference/developer-portal/get-user-grant-cycle"},{"title":"Get Prices","deprecated":null,"version":null,"sidebarTitle":"Get prices","openapi":"/openapi/developer-portal.json get /public/v1/miniapps/prices","href":"/api-reference/developer-portal/get-prices"},{"title":"Create Incognito Action","deprecated":null,"version":null,"sidebarTitle":"Create incognito action","openapi":"/openapi/developer-portal.json post /api/v2/create-action/{app_id}","href":"/api-reference/developer-portal/create-incognito-action"},{"title":"Get Action Metadata","deprecated":null,"version":null,"sidebarTitle":"Get action metadata","openapi":"/openapi/developer-portal.json post /api/v1/precheck/{app_id}","href":"/api-reference/developer-portal/get-action-metadata"},{"title":"Get JWK Keys","deprecated":null,"version":null,"sidebarTitle":"Get jwk keys","openapi":"/openapi/developer-portal.json get /api/v1/jwks","href":"/api-reference/developer-portal/get-jwk-keys"},{"title":"GraphQL Proxy","deprecated":null,"version":null,"sidebarTitle":"Graphql proxy","openapi":"/openapi/developer-portal.json post /api/v1/graphql","href":"/api-reference/developer-portal/graphql-proxy"}]},{"group":"World ID Indexer","pages":[{"title":"Get Inclusion Proof","deprecated":null,"version":null,"openapi":"https://indexer.us.id-infra.worldcoin.dev/openapi.json post /inclusion-proof","href":"/api-reference/indexer/get-inclusion-proof"},{"title":"Get Packed Account Data","deprecated":null,"version":null,"openapi":"https://indexer.us.id-infra.worldcoin.dev/openapi.json post /packed-account","href":"/api-reference/indexer/get-packed-account-data"},{"title":"Get Signature Nonce","deprecated":null,"version":null,"openapi":"https://indexer.us.id-infra.worldcoin.dev/openapi.json post /signature-nonce","href":"/api-reference/indexer/get-signature-nonce"},{"title":"Get Authenticator Pubkeys","deprecated":null,"version":null,"openapi":"https://indexer.us.id-infra.worldcoin.dev/openapi.json post /authenticator-pubkeys","href":"/api-reference/indexer/get-authenticator-pubkeys"},{"title":"Get the pending recovery agent update for a particular World ID given its leaf index.","deprecated":null,"version":null,"openapi":"https://indexer.us.id-infra.worldcoin.dev/openapi.json post /pending-recovery-agent","href":"/api-reference/indexer/get-the-pending-recovery-agent-update-for-a-particular-world-id-given-its-leaf-index"},{"title":"Get the Recovery Agent for a particular World ID given its leaf index.","deprecated":null,"version":null,"openapi":"https://indexer.us.id-infra.worldcoin.dev/openapi.json post /recovery-agent","href":"/api-reference/indexer/get-the-recovery-agent-for-a-particular-world-id-given-its-leaf-index"}]},{"group":"World ID Gateway","pages":[{"title":"Post create account","deprecated":null,"version":null,"openapi":"https://gateway.id-infra.worldcoin.dev/openapi.json post /create-account","href":"/api-reference/gateway/post-create-account"},{"title":"Post insert authenticator","deprecated":null,"version":null,"openapi":"https://gateway.id-infra.worldcoin.dev/openapi.json post /insert-authenticator","href":"/api-reference/gateway/post-insert-authenticator"},{"title":"Post update authenticator","deprecated":null,"version":null,"openapi":"https://gateway.id-infra.worldcoin.dev/openapi.json post /update-authenticator","href":"/api-reference/gateway/post-update-authenticator"},{"title":"Post remove authenticator","deprecated":null,"version":null,"openapi":"https://gateway.id-infra.worldcoin.dev/openapi.json post /remove-authenticator","href":"/api-reference/gateway/post-remove-authenticator"},{"title":"Post recover account","deprecated":null,"version":null,"openapi":"https://gateway.id-infra.worldcoin.dev/openapi.json post /recover-account","href":"/api-reference/gateway/post-recover-account"},{"title":"Get is valid root","deprecated":null,"version":null,"openapi":"https://gateway.id-infra.worldcoin.dev/openapi.json get /is-valid-root","href":"/api-reference/gateway/get-is-valid-root"},{"title":"Get status","deprecated":null,"version":null,"openapi":"https://gateway.id-infra.worldcoin.dev/openapi.json get /status/{id}","href":"/api-reference/gateway/get-status"},{"title":"Get health","deprecated":null,"version":null,"openapi":"https://gateway.id-infra.worldcoin.dev/openapi.json get /health","href":"/api-reference/gateway/get-health"},{"title":"Post initiate recovery agent update","deprecated":null,"version":null,"openapi":"https://gateway.id-infra.worldcoin.dev/openapi.json post /initiate-recovery-agent-update","href":"/api-reference/gateway/post-initiate-recovery-agent-update"},{"title":"Post execute recovery agent update","deprecated":null,"version":null,"openapi":"https://gateway.id-infra.worldcoin.dev/openapi.json post /execute-recovery-agent-update","href":"/api-reference/gateway/post-execute-recovery-agent-update"},{"title":"Post cancel recovery agent update","deprecated":null,"version":null,"openapi":"https://gateway.id-infra.worldcoin.dev/openapi.json post /cancel-recovery-agent-update","href":"/api-reference/gateway/post-cancel-recovery-agent-update"}]},{"group":"World ID Issuers","pages":[{"title":"PoH Issuer","description":"PoH issuer endpoints, including credential refresh for v3 to v4 migration.","href":"/world-id/reference/issuer-1"},{"title":"Unique Document Issuer","href":"/world-id/reference/issuer-9303"}]}]},{"tab":"Resources","menu":[{"item":"MCP","pages":[{"title":"MCP","href":"/model-context-protocol"}]},{"item":"Developer Portal","href":"https://developer.worldcoin.org"},{"item":"World Tech Blog","href":"https://world.org/blog?blog_type=world-tech"},{"item":"Open Source","href":"https://github.com/worldcoin"},{"item":"Whitepaper","href":"https://whitepaper.world.org"},{"item":"Ecosystem","href":"https://world.org/ecosystem"}],"pages":[{"title":"Resources","href":"/model-context-protocol"}]},{"tab":"Support","menu":[{"item":"Telegram Support Channel","href":"https://t.me/worlddevelopersupport"},{"item":"Email Support","href":"mailto:developers@toolsforhumanity.com"},{"item":"Mini Apps FAQ","href":"/mini-apps/more/faq"}]}]},"basePath":"","title":"World Developer Docs","deploymentId":"dpl_FZMKUpaaKiVETbfqhoUe4sPFDTmY","buildId":"dpl_FZMKUpaaKiVETbfqhoUe4sPFDTmY","dynamics":[],"chunks":[]}