{"uid":"cap__r_ojsvw7LEjQw21cf_TS","slug":"x402-gateway-verify-worldid-4f4eb890","name":"x402-gateway: verify_worldid","description":"x402-gateway tool: verify_worldid — Verify a World ID 4.0 proof via the Worldcoin Developer Portal API. Generates an RP signature server-side, then proxies the full IDKit proof to developer.world.org. Returns { valid, nullifier, worldcoin_response }.","url":"https://x402.freeq.one/tools/verify_worldid","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"proof":{"type":"object","description":"IDKit proof payload: { protocol_version, responses, action?, session_id? }"},"action":{"type":"string","description":"Action string (must match what IDKit used). Required for uniqueness proofs, omitted for session proofs."},"environment":{"enum":["production","staging"],"type":"string","description":"Worldcoin environment. Defaults to production."}}},"responseSchema":{"type":"json","example":{"result":{}}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.005","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.005/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.005","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.005","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_6Y-L7_p2NFk9VWO3IpjHt","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.005","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Verifies a World ID 4.0 proof by proxying through the Worldcoin Developer Portal API with server-side RP signature generation, returning validity, nullifier, and raw Worldcoin response.","exampleAgentPrompt":"Verify this World ID 4.0 proof for me — here's the IDKit proof payload from the user's World App session, and I need to know if it's valid and get back the nullifier hash.","exampleUseCases":[{"title":"Sybil-resistant airdrop gating","prompt":"I'm running a token airdrop and want to make sure each real human can only claim once — verify this World ID proof from a claimant and return their nullifier so I can check for duplicates."},{"title":"One-person-one-vote dApp authentication","prompt":"A user just submitted their World ID proof in my voting dApp. Can you verify the proof is valid and give me the nullifier hash so I can register their vote without allowing double-voting?"},{"title":"Human verification for AI agent access","prompt":"Before granting this user access to my AI service, verify their World ID 4.0 proof to confirm they're a real human and not a bot — return whether it's valid and the nullifier."}],"resultDescription":"Returns a JSON object with three fields: `valid` (boolean indicating if the proof passed verification), `nullifier` (the unique nullifier hash for this user+action pair, usable for deduplication), and `worldcoin_response` (the full raw response from the Worldcoin Developer Portal API).","failureModes":["Invalid or malformed IDKit proof payload returns valid=false","Expired proof (World ID proofs have short validity windows) returns rejection","Incorrect app_id or action mismatch causes Developer Portal rejection","Network errors reaching developer.world.org cause 5xx responses","Missing required proof fields in body cause schema validation errors","Reused nullifier (proof already verified) may return invalid depending on app settings"],"whenToPreferThis":"Use this endpoint when you need server-side World ID 4.0 proof verification without setting up your own Worldcoin Developer Portal integration or managing RP signing keys. Ideal for agents and dApps that receive IDKit proofs from users and need to verify proof-of-personhood in a pay-per-call model without account setup. Prefer this over self-hosted verification when you want zero infrastructure overhead and are already using the x402 payment protocol.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T19:36:50.015Z","isFirstParty":false}