Verifies World ID 4.0 proofs and legacy 3.0 proofs. Forward the complete IDKit result without remapping response identifiers or constructing a legacy verification_level. Use rp_id (rp_...) when possible; app_id (app_...) is still accepted for backward compatibility.
{"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":""},"chroma":{"liveDeploymentHistoryId":"6ae464f2812f7e980ce4e091","collectionId":"2bc4b7ae-6655-4b97-837f-af76076964e4","schemaVersion":"v3","latestBuiltDeploymentHistoryId":"6ae464f2812f7e980ce4e091"},"feedback":{"thumbs":true,"issues":true},"entitlements":{"AI_CHAT":{"status":"ENABLED"},"WEB_MCP":{"status":"ENABLED"},"NARRATION":{"status":"ENABLED"}},"buildId":"6ae464f2812f7e980ce4e091","clientVersion":"0.0.4045","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":"World ID Gateway","count":11},{"language":"default","tag":"Further Reading","count":10}]},"assistantConfig":{},"basePath":"","hasChatPermissions":true,"hasWebMcpPermissions":true,"toggles":[],"googleFontsInlined":false},"customCss":[{"filePath":"tailwind.css","content":"@tailwind base;@tailwind components;@tailwind utilities;@layer base{html{font-family:\"World Pro MVP\",ui-sans-serif,system-ui,-apple-system,\"Segoe UI\",Roboto,\"Helvetica Neue\",Arial,\"Noto Sans\",\"Apple Color Emoji\",\"Segoe UI Emoji\",\"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,.08)!important;color:#f3f2f0!important}.dark img[src*=\"/icons/credentials/human-emblem.svg\"]{filter:invert(1)}.prose a:not([class]),.prose a:not([class]):focus,.prose a:not([class]):hover{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}select,select option{color:inherit}:root select option{background-color:#fff;color:#0f172a}.dark select option{background-color:#0b1220;color:#e5e7eb}#navbar .nav-tabs{align-items:center;gap:0!important}#navbar .nav-tabs-item{height:32px!important;padding:6px 10px;border-radius:42px;color:#181818!important;transition:background-color .15s ease}#navbar .nav-tabs-item:hover{color:#181818!important;background-color:#f3f2f0}#navbar .nav-tabs-item[data-active=true]{padding:6px 14px;text-shadow:none}#navbar .nav-tabs-item[data-active=true],#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,.15)}.dark #navbar .nav-tabs-item{color:#f3f2f0!important}.dark #navbar .nav-tabs-item:hover{color:#f3f2f0!important;background-color:rgba(255,255,255,.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:#18191b;--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,#navbar #search-bar-entry span.text-xs{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:#fff;border:1px solid #e1dfda;border-radius:18px;box-shadow:0 15px 20px -5px rgba(0,0,0,.03)}.dark #navbar>div.max-w-8xl{background-color:#18191b;border-color:rgba(255,255,255,.12)}#navbar div.lg\\:px-12,#navbar div.lg\\:px-12>div,#navbar>div.max-w-8xl>div,#navbar>div.max-w-8xl>div>div.relative{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 #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 .text-xs,#navbar #assistant-entry kbd,#navbar div.lg\\:px-12>div>div.justify-end{display:none!important}.dark #navbar #assistant-entry{background-color:#18191b!important;border-color:rgba(255,255,255,.15)!important;color:#f3f2f0!important}}.quickstart-code .code-block{margin-top:.5rem!important;margin-bottom:.75rem!important}.quickstart-code .code-block .code-block-background,.quickstart-code .code-block .code-block-background pre.shiki{background:0 0!important;background-color:transparent!important}#footer.advanced-footer .nav-logo,#footer.advanced-footer div[class*=\"min-w-[140px]\"],#navbar #theme-preference-menu-trigger,.quickstart-code .code-block [data-fade-overlay=true],body>div.z-999.cursor-grab.touch-none[role=status],div[data-assistant-bar]{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 .15s ease}.product-card:hover .product-card-tile{background-color:#edece9}.dark .product-card-tile{background-color:#18191b}.dark .landing-carousel-arrow:hover,.dark .product-card:hover .product-card-tile{background-color:#202124}.product-card-title{color:#181818}.dark .product-card-title{color:#fff}.product-card-desc{color:#75726f}.dark .product-card-desc{color:#9ea2a6}.dark .product-card-icon{filter:invert(1)}.landing-section-title{font-size:48px;line-height:1.15;letter-spacing:-.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:#9ea2a6}@media (max-width:600px){.landing-section-title{font-size:32px;letter-spacing:-.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:#fff;border:1px solid #e1dfda;color:#181818;transition:background-color .15s ease}.landing-carousel-arrow:hover{background-color:#f3f2f0}.dark .landing-carousel-arrow{background-color:#18191b;border-color:rgba(255,255,255,.15);color:#f3f2f0}.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,.12)}.landing-update-title{font-size:24px;line-height:1.3;letter-spacing:-.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:#9ea2a6}.landing-hero{color:#2d2c2c}.dark .landing-hero,.dark .landing-link{color:#f3f2f0}.landing-link{color:#181818}.landing-link svg{fill:#181818}.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:#fff}.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 #footer.advanced-footer a.select-none::after,.dark .landing-footer-link,.dark .landing-footer-links,.dark .landing-hero-title{color:#f3f2f0}.landing-footer-links{color:#181818}#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 a.select-none::after{content:\"™ 2026 World\";font-size:16px;line-height:1.4;font-weight:300;color:#181818;white-space:nowrap}@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>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:-.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}.landing-hero-sub{margin-top:24px;max-width:487px;font-size:24px;line-height:1.35;letter-spacing:-.24px;font-weight:300;color:#75726f}.dark .landing-hero-sub{color:#9ea2a6}@media (max-width:600px){.landing-hero-title{font-size:40px;letter-spacing:-.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":"api-reference/developer-portal/verify","slug":"/api-reference/developer-portal/verify","pageMetadata":{"title":"Verify","description":"Verifies World ID 4.0 proofs and legacy 3.0 proofs. Forward the complete IDKit result without remapping response identifiers or constructing a legacy `verification_level`. Use `rp_id` (`rp_...`) when possible; `app_id` (`app_...`) is still accepted for backward compatibility.","deprecated":null,"version":null,"sidebarTitle":"Verify","openapi":"/openapi/developer-portal.json post /api/v4/verify/{rp_id}","href":"/api-reference/developer-portal/verify","autogeneratedByOpenApi":true},"description":{"compiledSource":"\"use strict\";\nconst {jsx: _jsx, jsxs: _jsxs} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n code: \"code\",\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsxs(_components.p, {\n children: [\"Verifies World ID 4.0 proofs and legacy 3.0 proofs. Forward the complete IDKit result without remapping response identifiers or constructing a legacy \", _jsx(_components.code, {\n children: \"verification_level\"\n }), \". Use \", _jsx(_components.code, {\n children: \"rp_id\"\n }), \" (\", _jsx(_components.code, {\n children: \"rp_...\"\n }), \") when possible; \", _jsx(_components.code, {\n children: \"app_id\"\n }), \" (\", _jsx(_components.code, {\n children: \"app_...\"\n }), \") is still accepted for backward compatibility.\"]\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":{"codeStyling":"system","config":{},"pageMetadata":{"title":"Verify","description":"Verifies World ID 4.0 proofs and legacy 3.0 proofs. Forward the complete IDKit result without remapping response identifiers or constructing a legacy `verification_level`. Use `rp_id` (`rp_...`) when possible; `app_id` (`app_...`) is still accepted for backward compatibility.","deprecated":null,"version":null,"sidebarTitle":"Verify","openapi":"/openapi/developer-portal.json post /api/v4/verify/{rp_id}","href":"/api-reference/developer-portal/verify","autogeneratedByOpenApi":true}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":[],"openApiReferenceData":{"operation":{"summary":"Verify","description":"Verifies World ID 4.0 proofs and legacy 3.0 proofs. Forward the complete IDKit result without remapping response identifiers or constructing a legacy `verification_level`. Use `rp_id` (`rp_...`) when possible; `app_id` (`app_...`) is still accepted for backward compatibility.","x-mint":{"href":"/api-reference/developer-portal/verify"},"parameters":["050f66f2-f53d-49cb-a1d6-ced8d6a3fbc2"],"requestBody":"1a2e9036-4c00-436b-bbc3-8e7758d479e0","responses":{"200":"f6789c52-8be3-48ff-923c-03620929232e","400":"3147406e-9f30-4be6-be11-c2841b4c5f32","404":"b960a473-5799-4c58-a5f8-539ba2f7fcc4"},"method":"post","type":"path","servers":["187ea648-4b9f-4bce-a6e5-4b47dacc9935","1abe78f7-9beb-42e2-b721-e2672e526fed","68a3608c-88a4-4b3a-b843-331ee67a5d63"],"security":[],"path":"/api/v4/verify/{rp_id}","baseUrlOptions":["https://developer.world.org","https://developer.worldcoin.org","https://staging-developer.worldcoin.org"],"title":"Verify","codeSamples":[],"requestExampleLanguages":["bash","javascript"],"requiredOnlyExamples":true,"requestExampleType":"generated","responseExampleType":"generated","prefillPlaygroundWithExample":true,"prefillPlaygroundExamples":[{"body.oneOf.0.protocol_version":"3.0","body.oneOf.0.nonce":"0xabc123","body.oneOf.0.action":"my_action","body.oneOf.0.responses.items.0.identifier":"orb","body.oneOf.0.responses.items.0.merkle_root":"0x2264a66d162d7893e12ea8e3c072c51e785bc085ad655f64c10c1a61e00f0bc2","body.oneOf.0.responses.items.0.nullifier":"0x2bf8406809dcefb1486dadc96c0a897db9bab002053054cf64272db512c6fbd8","body.oneOf.0.responses.items.0.proof":"0x1aa8b8f3b2d2de5ff452c0e1a83e29d6bf46fb83ef35dc5957121ff3d3698a1119090fb...","body.oneOf.0.responses.items.0.signal_hash":"0x00c5d2460186f7233c927e7db2dcc703c0e500b653ca82273b7bfad8045d85a4","body.oneOf.0.responses.items.0.max_age":304200,"body.oneOf.0.environment":"production"},{"body.oneOf.1.protocol_version":"4.0","body.oneOf.1.nonce":"0xabc123","body.oneOf.1.action":"my_action","body.oneOf.1.responses.items.0.identifier":"proof_of_human","body.oneOf.1.responses.items.0.issuer_schema_id":1,"body.oneOf.1.responses.items.0.nullifier":"0x2bf8406809dcefb1486dadc96c0a897db9bab002053054cf64272db512c6fbd8","body.oneOf.1.responses.items.0.expires_at_min":49012345,"body.oneOf.1.responses.items.0.proof.items.0":"0x111","body.oneOf.1.responses.items.0.proof.items.1":"0x222","body.oneOf.1.responses.items.0.proof.items.2":"0x333","body.oneOf.1.responses.items.0.proof.items.3":"0x444","body.oneOf.1.responses.items.0.proof.items.4":"0x555","body.oneOf.1.responses.items.0.signal_hash":"0x0"},{"body.oneOf.1.protocol_version":"4.0","body.oneOf.1.nonce":"0xabc123","body.oneOf.1.action":"selfie-check-2026-09-02","body.oneOf.1.responses.items.0.identifier":"selfie","body.oneOf.1.responses.items.0.issuer_schema_id":11,"body.oneOf.1.responses.items.0.nullifier":"0x2bf8406809dcefb1486dadc96c0a897db9bab002053054cf64272db512c6fbd8","body.oneOf.1.responses.items.0.expires_at_min":1788302888,"body.oneOf.1.responses.items.0.proof.items.0":"0x111","body.oneOf.1.responses.items.0.proof.items.1":"0x222","body.oneOf.1.responses.items.0.proof.items.2":"0x333","body.oneOf.1.responses.items.0.proof.items.3":"0x444","body.oneOf.1.responses.items.0.proof.items.4":"0x555","body.oneOf.1.responses.items.0.signal_hash":"0x0","body.oneOf.1.responses.items.0.sybil_score":10,"body.oneOf.1.integrity_bundle.version":2,"body.oneOf.1.integrity_bundle.signature_format":"apple_app_attest","body.oneOf.1.integrity_bundle.timestamp":1788302923,"body.oneOf.1.integrity_bundle.signature":"a1b2c3d4","body.oneOf.1.integrity_bundle.jwt":"eyJ..."},{"body.oneOf.2.protocol_version":"4.0","body.oneOf.2.nonce":"0xabc123","body.oneOf.2.session_id":"session_5f3a9c2e...8d1b0a","body.oneOf.2.responses.items.0.identifier":"proof_of_human","body.oneOf.2.responses.items.0.issuer_schema_id":1,"body.oneOf.2.responses.items.0.session_nullifier.items.0":"0xaaa","body.oneOf.2.responses.items.0.session_nullifier.items.1":"0xbbb","body.oneOf.2.responses.items.0.expires_at_min":49012345,"body.oneOf.2.responses.items.0.proof.items.0":"0x111","body.oneOf.2.responses.items.0.proof.items.1":"0x222","body.oneOf.2.responses.items.0.proof.items.2":"0x333","body.oneOf.2.responses.items.0.proof.items.3":"0x444","body.oneOf.2.responses.items.0.proof.items.4":"0x555"}]},"dependencies":{"parameters":{"050f66f2-f53d-49cb-a1d6-ced8d6a3fbc2":{"name":"rp_id","in":"path","required":true,"schema":{"type":"string","isRequired":true,"description":"RP ID (`rp_...`) is recommended. App ID (`app_...`) is also accepted for backward compatibility.","uniqueKey":"","typeLabel":"string"},"description":"RP ID (`rp_...`) is recommended. App ID (`app_...`) is also accepted for backward compatibility."}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"oneOf":[{"type":"object","title":"Legacy Proofs (v3)","description":"Choose one request type.","required":["protocol_version","nonce","action","responses"],"properties":{"protocol_version":{"type":"string","enum":["3.0"],"isRequired":true,"uniqueKey":"oneOf.0.protocol_version","typeLabel":"enum\u003cstring>"},"nonce":{"type":"string","isRequired":true,"uniqueKey":"oneOf.0.nonce","typeLabel":"string"},"action":{"type":"string","isRequired":true,"uniqueKey":"oneOf.0.action","typeLabel":"string"},"responses":{"type":"array","minItems":1,"items":{"type":"object","required":["identifier","proof","merkle_root","nullifier"],"properties":{"identifier":{"type":"string","description":"Credential identifier returned by IDKit (for example, `orb` or `selfie`). Use `selfie` for Selfie Check; the historical `face` value remains accepted as a backward-compatible alias.","isRequired":true,"uniqueKey":"oneOf.0.responses.items.[INDEX].identifier","typeLabel":"string"},"merkle_root":{"type":"string","isRequired":true,"uniqueKey":"oneOf.0.responses.items.[INDEX].merkle_root","typeLabel":"string"},"nullifier":{"type":"string","isRequired":true,"uniqueKey":"oneOf.0.responses.items.[INDEX].nullifier","typeLabel":"string"},"proof":{"type":"string","isRequired":true,"uniqueKey":"oneOf.0.responses.items.[INDEX].proof","typeLabel":"string"},"signal_hash":{"type":"string","default":"0x00c5d2460186f7233c927e7db2dcc703c0e500b653ca82273b7bfad8045d85a4","uniqueKey":"oneOf.0.responses.items.[INDEX].signal_hash","typeLabel":"string"},"max_age":{"type":"integer","minimum":3600,"maximum":604800,"uniqueKey":"oneOf.0.responses.items.[INDEX].max_age","typeLabel":"integer"}},"uniqueKey":"oneOf.0.responses.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"oneOf.0.responses","typeLabel":"object[]"},"action_description":{"type":"string","uniqueKey":"oneOf.0.action_description","typeLabel":"string"},"environment":{"type":"string","enum":["production","staging","sandbox"],"default":"production","uniqueKey":"oneOf.0.environment","typeLabel":"enum\u003cstring>"},"integrity_bundle":{"type":"object","required":["version","signature_format","timestamp","signature","jwt"],"description":"World ID App integrity attestation. Selfie Check responses with `issuer_schema_id: 11` require version 2, which covers the disclosed `sybil_score`.","properties":{"version":{"type":"integer","enum":[1,2],"isRequired":true,"uniqueKey":"oneOf.0.integrity_bundle.version","typeLabel":"enum\u003cinteger>"},"signature_format":{"type":"string","enum":["apple_app_attest","android_keystore"],"isRequired":true,"uniqueKey":"oneOf.0.integrity_bundle.signature_format","typeLabel":"enum\u003cstring>"},"timestamp":{"type":"integer","minimum":0,"isRequired":true,"uniqueKey":"oneOf.0.integrity_bundle.timestamp","typeLabel":"integer"},"signature":{"type":"string","description":"Hex-encoded device signature.","isRequired":true,"uniqueKey":"oneOf.0.integrity_bundle.signature","typeLabel":"string"},"jwt":{"type":"string","description":"Attestation Gateway JWT used to verify the signing key.","isRequired":true,"uniqueKey":"oneOf.0.integrity_bundle.jwt","typeLabel":"string"}},"uniqueKey":"oneOf.0.integrity_bundle","typeLabel":"object"},"user_presence_completed":{"type":"boolean","description":"Whether World App completed the requested user-presence check. IDKit includes this field only when `require_user_presence` was true in the request.","uniqueKey":"oneOf.0.user_presence_completed","typeLabel":"boolean"}},"uniqueKey":"oneOf.0","typeLabel":"Legacy Proofs (v3) · object"},{"type":"object","title":"Uniqueness Proofs","description":"Choose one request type.","required":["protocol_version","nonce","action","responses"],"properties":{"protocol_version":{"type":"string","enum":["4.0"],"isRequired":true,"uniqueKey":"oneOf.1.protocol_version","typeLabel":"enum\u003cstring>"},"nonce":{"type":"string","isRequired":true,"uniqueKey":"oneOf.1.nonce","typeLabel":"string"},"action":{"type":"string","isRequired":true,"uniqueKey":"oneOf.1.action","typeLabel":"string"},"responses":{"type":"array","minItems":1,"items":{"type":"object","required":["identifier","issuer_schema_id","nullifier","expires_at_min","proof"],"properties":{"identifier":{"type":"string","isRequired":true,"uniqueKey":"oneOf.1.responses.items.[INDEX].identifier","typeLabel":"string"},"issuer_schema_id":{"type":"integer","isRequired":true,"uniqueKey":"oneOf.1.responses.items.[INDEX].issuer_schema_id","typeLabel":"integer"},"nullifier":{"type":"string","isRequired":true,"uniqueKey":"oneOf.1.responses.items.[INDEX].nullifier","typeLabel":"string"},"expires_at_min":{"type":"integer","isRequired":true,"uniqueKey":"oneOf.1.responses.items.[INDEX].expires_at_min","typeLabel":"integer"},"proof":{"type":"array","minItems":5,"maxItems":5,"items":{"type":"string","uniqueKey":"oneOf.1.responses.items.[INDEX].proof.items.[INDEX]","typeLabel":"string"},"description":"Exactly 5 hex elements (4 compressed proof elements + Merkle root).","isRequired":true,"uniqueKey":"oneOf.1.responses.items.[INDEX].proof","typeLabel":"string[]"},"signal_hash":{"type":"string","default":"0x0","uniqueKey":"oneOf.1.responses.items.[INDEX].signal_hash","typeLabel":"string"},"sybil_score":{"type":"integer","minimum":0,"description":"Versioned Selfie Check risk signal represented as an integer. Required only when `issuer_schema_id` is 11.","uniqueKey":"oneOf.1.responses.items.[INDEX].sybil_score","typeLabel":"integer"}},"uniqueKey":"oneOf.1.responses.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"oneOf.1.responses","typeLabel":"object[]"},"action_description":{"type":"string","uniqueKey":"oneOf.1.action_description","typeLabel":"string"},"environment":{"type":"string","enum":["production","staging","sandbox"],"default":"production","uniqueKey":"oneOf.1.environment","typeLabel":"enum\u003cstring>"},"integrity_bundle":{"type":"object","description":"Required with version 2 when any response item is a Selfie Check credential (`issuer_schema_id: 11`).","required":["version","signature_format","timestamp","signature","jwt"],"properties":{"version":{"type":"integer","enum":[1,2],"isRequired":true,"uniqueKey":"oneOf.1.integrity_bundle.version","typeLabel":"enum\u003cinteger>"},"signature_format":{"type":"string","enum":["apple_app_attest","android_keystore"],"isRequired":true,"uniqueKey":"oneOf.1.integrity_bundle.signature_format","typeLabel":"enum\u003cstring>"},"timestamp":{"type":"integer","minimum":0,"isRequired":true,"uniqueKey":"oneOf.1.integrity_bundle.timestamp","typeLabel":"integer"},"signature":{"type":"string","description":"Hex-encoded device signature.","isRequired":true,"uniqueKey":"oneOf.1.integrity_bundle.signature","typeLabel":"string"},"jwt":{"type":"string","description":"Attestation Gateway JWT used to verify the signing key.","isRequired":true,"uniqueKey":"oneOf.1.integrity_bundle.jwt","typeLabel":"string"}},"uniqueKey":"oneOf.1.integrity_bundle","typeLabel":"object"},"user_presence_completed":{"type":"boolean","description":"Whether World App completed the requested user-presence check. IDKit includes this field only when `require_user_presence` was true in the request.","uniqueKey":"oneOf.1.user_presence_completed","typeLabel":"boolean"}},"uniqueKey":"oneOf.1","typeLabel":"Uniqueness Proofs · object"},{"type":"object","title":"Session Proofs","description":"Choose one request type.","required":["protocol_version","nonce","session_id","responses"],"properties":{"protocol_version":{"type":"string","enum":["4.0"],"isRequired":true,"uniqueKey":"oneOf.2.protocol_version","typeLabel":"enum\u003cstring>"},"nonce":{"type":"string","isRequired":true,"uniqueKey":"oneOf.2.nonce","typeLabel":"string"},"session_id":{"type":"string","description":"Opaque session ID in the format session_\u003c128 hex characters>.","example":"session_5f3a9c2e...8d1b0a","isRequired":true,"uniqueKey":"oneOf.2.session_id","typeLabel":"string"},"responses":{"type":"array","minItems":1,"items":{"type":"object","required":["identifier","issuer_schema_id","session_nullifier","expires_at_min","proof"],"properties":{"identifier":{"type":"string","isRequired":true,"uniqueKey":"oneOf.2.responses.items.[INDEX].identifier","typeLabel":"string"},"issuer_schema_id":{"type":"integer","isRequired":true,"uniqueKey":"oneOf.2.responses.items.[INDEX].issuer_schema_id","typeLabel":"integer"},"session_nullifier":{"type":"array","minItems":2,"maxItems":2,"items":{"type":"string","uniqueKey":"oneOf.2.responses.items.[INDEX].session_nullifier.items.[INDEX]","typeLabel":"string"},"description":"Tuple `[nullifier, action]`.","isRequired":true,"uniqueKey":"oneOf.2.responses.items.[INDEX].session_nullifier","typeLabel":"string[]"},"expires_at_min":{"type":"integer","isRequired":true,"uniqueKey":"oneOf.2.responses.items.[INDEX].expires_at_min","typeLabel":"integer"},"proof":{"type":"array","minItems":5,"maxItems":5,"items":{"type":"string","uniqueKey":"oneOf.2.responses.items.[INDEX].proof.items.[INDEX]","typeLabel":"string"},"isRequired":true,"uniqueKey":"oneOf.2.responses.items.[INDEX].proof","typeLabel":"string[]"},"signal_hash":{"type":"string","default":"0x0","uniqueKey":"oneOf.2.responses.items.[INDEX].signal_hash","typeLabel":"string"},"sybil_score":{"type":"integer","minimum":0,"description":"Versioned Selfie Check risk signal represented as an integer. Required only when `issuer_schema_id` is 11.","uniqueKey":"oneOf.2.responses.items.[INDEX].sybil_score","typeLabel":"integer"}},"uniqueKey":"oneOf.2.responses.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"oneOf.2.responses","typeLabel":"object[]"},"environment":{"type":"string","enum":["production","staging","sandbox"],"default":"production","uniqueKey":"oneOf.2.environment","typeLabel":"enum\u003cstring>"},"integrity_bundle":{"type":"object","description":"Required with version 2 when any response item is a Selfie Check credential (`issuer_schema_id: 11`).","required":["version","signature_format","timestamp","signature","jwt"],"properties":{"version":{"type":"integer","enum":[1,2],"isRequired":true,"uniqueKey":"oneOf.2.integrity_bundle.version","typeLabel":"enum\u003cinteger>"},"signature_format":{"type":"string","enum":["apple_app_attest","android_keystore"],"isRequired":true,"uniqueKey":"oneOf.2.integrity_bundle.signature_format","typeLabel":"enum\u003cstring>"},"timestamp":{"type":"integer","minimum":0,"isRequired":true,"uniqueKey":"oneOf.2.integrity_bundle.timestamp","typeLabel":"integer"},"signature":{"type":"string","description":"Hex-encoded device signature.","isRequired":true,"uniqueKey":"oneOf.2.integrity_bundle.signature","typeLabel":"string"},"jwt":{"type":"string","description":"Attestation Gateway JWT used to verify the signing key.","isRequired":true,"uniqueKey":"oneOf.2.integrity_bundle.jwt","typeLabel":"string"}},"uniqueKey":"oneOf.2.integrity_bundle","typeLabel":"object"},"user_presence_completed":{"type":"boolean","description":"Whether World App completed the requested user-presence check. IDKit includes this field only when `require_user_presence` was true in the request.","uniqueKey":"oneOf.2.user_presence_completed","typeLabel":"boolean"}},"uniqueKey":"oneOf.2","typeLabel":"Session Proofs · object"}],"uniqueKey":"","typeLabel":"Legacy Proofs (v3) · object | Uniqueness Proofs · object | Session Proofs · object"},"examples":{"uniqueness_v3":{"title":"uniqueness_v3","value":{"protocol_version":"3.0","nonce":"0xabc123","action":"my_action","responses":[{"identifier":"orb","merkle_root":"0x2264a66d162d7893e12ea8e3c072c51e785bc085ad655f64c10c1a61e00f0bc2","nullifier":"0x2bf8406809dcefb1486dadc96c0a897db9bab002053054cf64272db512c6fbd8","proof":"0x1aa8b8f3b2d2de5ff452c0e1a83e29d6bf46fb83ef35dc5957121ff3d3698a1119090fb...","signal_hash":"0x00c5d2460186f7233c927e7db2dcc703c0e500b653ca82273b7bfad8045d85a4","max_age":304200}],"environment":"production"}},"uniqueness_v4":{"title":"uniqueness_v4","value":{"protocol_version":"4.0","nonce":"0xabc123","action":"my_action","responses":[{"identifier":"proof_of_human","issuer_schema_id":1,"nullifier":"0x2bf8406809dcefb1486dadc96c0a897db9bab002053054cf64272db512c6fbd8","expires_at_min":49012345,"proof":["0x111","0x222","0x333","0x444","0x555"],"signal_hash":"0x0"}]}},"selfie_check_v4":{"title":"selfie_check_v4","value":{"protocol_version":"4.0","nonce":"0xabc123","action":"selfie-check-2026-09-02","integrity_bundle":{"version":2,"signature_format":"apple_app_attest","timestamp":1788302923,"signature":"a1b2c3d4","jwt":"eyJ..."},"responses":[{"identifier":"selfie","issuer_schema_id":11,"nullifier":"0x2bf8406809dcefb1486dadc96c0a897db9bab002053054cf64272db512c6fbd8","expires_at_min":1788302888,"proof":["0x111","0x222","0x333","0x444","0x555"],"signal_hash":"0x0","sybil_score":10}]}},"session_v4":{"title":"session_v4","value":{"protocol_version":"4.0","nonce":"0xabc123","session_id":"session_5f3a9c2e...8d1b0a","responses":[{"identifier":"proof_of_human","issuer_schema_id":1,"session_nullifier":["0xaaa","0xbbb"],"expires_at_min":49012345,"proof":["0x111","0x222","0x333","0x444","0x555"]}]}}},"exampleType":"examples"}},"exampleType":"examples"},"responses":{"f6789c52-8be3-48ff-923c-03620929232e":{"description":"At least one proof verified successfully","content":{"application/json":{"schema":{"type":"object","required":["success","results"],"properties":{"success":{"type":"boolean","enum":[true],"isRequired":true,"uniqueKey":"success","typeLabel":"enum\u003cboolean>"},"results":{"type":"array","items":{"type":"object","properties":{"identifier":{"type":"string","uniqueKey":"results.items.[INDEX].identifier","typeLabel":"string"},"success":{"type":"boolean","uniqueKey":"results.items.[INDEX].success","typeLabel":"boolean"},"nullifier":{"type":"string","uniqueKey":"results.items.[INDEX].nullifier","typeLabel":"string"},"code":{"type":"string","uniqueKey":"results.items.[INDEX].code","typeLabel":"string"},"detail":{"type":"string","uniqueKey":"results.items.[INDEX].detail","typeLabel":"string"}},"uniqueKey":"results.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"results","typeLabel":"object[]"},"action":{"type":"string","uniqueKey":"action","typeLabel":"string"},"nullifier":{"type":"string","uniqueKey":"nullifier","typeLabel":"string"},"created_at":{"type":"string","format":"date-time","uniqueKey":"created_at","typeLabel":"string\u003cdate-time>"},"environment":{"type":"string","enum":["production","staging","sandbox"],"uniqueKey":"environment","typeLabel":"enum\u003cstring>"},"session_id":{"type":"string","description":"Opaque session ID in the format session_\u003c128 hex characters>.","example":"session_5f3a9c2e...8d1b0a","uniqueKey":"session_id","typeLabel":"string"},"message":{"type":"string","uniqueKey":"message","typeLabel":"string"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"success":true,"results":[{"identifier":"\u003cstring>","success":true,"nullifier":"\u003cstring>","code":"\u003cstring>","detail":"\u003cstring>"}],"action":"\u003cstring>","nullifier":"\u003cstring>","created_at":"2023-11-07T05:31:56Z","environment":"production","session_id":"session_5f3a9c2e...8d1b0a","message":"\u003cstring>"}}},"exampleType":"generated"}},"exampleType":"generated"},"3147406e-9f30-4be6-be11-c2841b4c5f32":{"description":"Validation or verification error","content":{"application/json":{"schema":{"type":"object","required":["success","code","detail"],"properties":{"success":{"type":"boolean","enum":[false],"isRequired":true,"uniqueKey":"success","typeLabel":"enum\u003cboolean>"},"code":{"type":"string","isRequired":true,"uniqueKey":"code","typeLabel":"string"},"detail":{"type":"string","isRequired":true,"uniqueKey":"detail","typeLabel":"string"},"results":{"type":"array","items":{"type":"object","properties":{"identifier":{"type":"string","uniqueKey":"results.items.[INDEX].identifier","typeLabel":"string"},"success":{"type":"boolean","uniqueKey":"results.items.[INDEX].success","typeLabel":"boolean"},"nullifier":{"type":"string","uniqueKey":"results.items.[INDEX].nullifier","typeLabel":"string"},"code":{"type":"string","uniqueKey":"results.items.[INDEX].code","typeLabel":"string"},"detail":{"type":"string","uniqueKey":"results.items.[INDEX].detail","typeLabel":"string"}},"uniqueKey":"results.items.[INDEX]","typeLabel":"object"},"uniqueKey":"results","typeLabel":"object[]"}},"uniqueKey":"","typeLabel":"object"},"examples":{"app_not_migrated":{"title":"app_not_migrated","value":{"success":false,"code":"app_not_migrated","detail":"This app has not been migrated to World ID 4.0. Please use the v2 verify endpoint."}},"all_verifications_failed":{"title":"all_verifications_failed","value":{"success":false,"code":"all_verifications_failed","detail":"All proof verifications failed.","results":[{"identifier":"orb","success":false,"code":"verification_error","detail":"On-chain proof verification failed."}]}}},"exampleType":"examples"}},"exampleType":"examples"},"b960a473-5799-4c58-a5f8-539ba2f7fcc4":{"description":"App not found or no longer active","content":{"application/json":{"schema":{"type":"object","required":["success","code","detail"],"properties":{"success":{"type":"boolean","enum":[false],"isRequired":true,"uniqueKey":"success","typeLabel":"enum\u003cboolean>"},"code":{"type":"string","isRequired":true,"uniqueKey":"code","typeLabel":"string"},"detail":{"type":"string","isRequired":true,"uniqueKey":"detail","typeLabel":"string"},"results":{"type":"array","items":{"type":"object","properties":{"identifier":{"type":"string","uniqueKey":"results.items.[INDEX].identifier","typeLabel":"string"},"success":{"type":"boolean","uniqueKey":"results.items.[INDEX].success","typeLabel":"boolean"},"nullifier":{"type":"string","uniqueKey":"results.items.[INDEX].nullifier","typeLabel":"string"},"code":{"type":"string","uniqueKey":"results.items.[INDEX].code","typeLabel":"string"},"detail":{"type":"string","uniqueKey":"results.items.[INDEX].detail","typeLabel":"string"}},"uniqueKey":"results.items.[INDEX]","typeLabel":"object"},"uniqueKey":"results","typeLabel":"object[]"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"success":false,"code":"\u003cstring>","detail":"\u003cstring>","results":[{"identifier":"\u003cstring>","success":true,"nullifier":"\u003cstring>","code":"\u003cstring>","detail":"\u003cstring>"}]}}},"exampleType":"generated"}},"exampleType":"generated"}},"security":{},"servers":{"187ea648-4b9f-4bce-a6e5-4b47dacc9935":{"url":"https://developer.world.org","description":"Primary"},"1abe78f7-9beb-42e2-b721-e2672e526fed":{"url":"https://developer.worldcoin.org","description":"Legacy domain"},"68a3608c-88a4-4b3a-b843-331ee67a5d63":{"url":"https://staging-developer.worldcoin.org","description":"Staging domain"}}},"originalFileLocation":"openapi/developer-portal.json"},"subdomain":"tfh","siteName":"World Documentation","title":"World Developer Docs","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-09-24T00:11:49.234Z","originalFileLocation":"api-reference/developer-portal/verify.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=\"Verifies World ID 4.0 proofs and legacy 3.0 proofs. Forward the complete IDKit result without remapping response identifiers or constructing a legacy verification_level. Use rp_id (rp_...) when possible; app_id (app_...) is still accepted for backward compatibility.\">\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/api-reference/developer-portal/verify\">\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/api-reference/developer-portal/verify\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/api-reference/developer-portal/verify.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/api-reference/developer-portal/verify#webpage\",\"url\":\"https://docs.world.org/api-reference/developer-portal/verify\",\"name\":\"Verify\",\"description\":\"Verifies World ID 4.0 proofs and legacy 3.0 proofs. Forward the complete IDKit result without remapping response identifiers or constructing a legacy verification_level. Use rp_id (rp_...) when possible; app_id (app_...) is still accepted for backward compatibility.\",\"dateModified\":\"2026-09-24T00:11:49.234Z\",\"isPartOf\":{\"@id\":\"https://docs.world.org#website\"},\"breadcrumb\":{\"@id\":\"https://docs.world.org/api-reference/developer-portal/verify#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.world.org/api-reference/developer-portal/verify#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"World Documentation\",\"item\":\"https://docs.world.org\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Verify\",\"item\":\"https://docs.world.org/api-reference/developer-portal/verify\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.world.org/api-reference/developer-portal/verify#apireference\",\"headline\":\"Verify\",\"name\":\"Verify\",\"description\":\"Verifies World ID 4.0 proofs and legacy 3.0 proofs. Forward the complete IDKit result without remapping response identifiers or constructing a legacy verification_level. Use rp_id (rp_...) when possible; app_id (app_...) is still accepted for backward compatibility.\",\"url\":\"https://docs.world.org/api-reference/developer-portal/verify\",\"mainEntityOfPage\":{\"@id\":\"https://docs.world.org/api-reference/developer-portal/verify#webpage\"},\"image\":\"https://raw.githubusercontent.com/worldcoin/developer-docs/main/images/docs/docs-meta.png\",\"dateModified\":\"2026-09-24T00:11:49.234Z\",\"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\",\"creator\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","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":"Mini Apps","pages":[{"title":"Mini Apps","href":"/mini-apps"}]},{"tab":"Agents","pages":[{"title":"Agents","href":"/agents/agent-kit/integrate"}]},{"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)","description":"Verify a World ID proof for a Cloud action.","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","href":"/world-id/reference/issuer-1"},{"title":"Unique Document Issuer","href":"/world-id/reference/issuer-9303"}]}]},{"tab":"MCP","pages":[{"title":"MCP","href":"/model-context-protocol"}]},{"tab":"Resources","menu":[{"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"}]},{"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","buildId":"dpl_36EDyZCDfRuoUD9af5CH4M1bqY2h","deploymentId":"dpl_36EDyZCDfRuoUD9af5CH4M1bqY2h","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-DCDCdBVX.js","utils-ME8dDnLe.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-0e84ACsd.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-wgRBj-ia.js","snippetPresets-C11Sgb-o.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","ApiExamples-C0lapOpP.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-ZeRQV8fF.js","shallow-BupWh095.js","getApiPlaygroundDisplay-BnYQO2Ss.js","CodeSnippet-RKKOc8c_.js","CodeSnippets-Drf_m8wS.js","Page-Bevw23-4.js","getPastedJson-u6QiPzNZ.js","icon-Bb-CBSxO.js","MethodPill-F7l5AI7V.js","DuplicateIcon-IiAXkdSg.js","createIcon-FliI8EBc.js","DynamicMarkdown-B62XqCSI.js","SectionHeading-Dj31pT03.js","axios-vUo_bRtp.js","Markdown-BOgQCTwD.js","clsx-BIWXJmsZ.js","lib-DuNMoZ05.js","lib-B8HbPgcC.js","html-void-elements-mCSPHezU.js","dist-DKZWslLH.js","katex-YMM-FMeD.js","marked.esm-CZWythHk.js","AssistantPageLink-UDqbR6xh.js"]}