VerifyAuthPartner ConsoleSDK

Human verification and private auth infrastructure for modern apps.

Add hosted human verification, private human sessions, signed callbacks, and partner-scoped identity flows without handling identity documents, biometric data, or raw proof data.

Live verification

Verify human

Ready

Partner app

Checked

Human Gateway

Checked

World ID proof

Checked

Verified human

Ready

Current status

Verification completed

Response

{
  "success": true,
  "verified_human": true,
  "verification_level": "orb",
  "unique_for_partner": true
}

Human Gateway verifies humanity inside a partner project context.

Hosted Verify

Run one-time human checks through hosted pages, partner-scoped actions, and signed verification results.

Hosted Auth

Let users sign in as verified humans with private sessions, logout, session tracking, and partner-scoped user records.

Operational console

Manage projects, actions, callbacks, sessions, partner users, audit events, and billing readiness from Partner Console.

How it works

A gateway between your app, World ID, and your partner operations.

01

Create a project

Set up a partner workspace, project, and action for your app inside Human Gateway.

02

Choose Verify or Auth

Use Hosted Verify for one-time checks or Hosted Auth when your app needs private human sessions.

03

Let users prove humanity

Users complete the World ID flow without exposing identity documents or raw proof signals to your app.

04

Receive signed results

Use callbacks, hosted redirects, or the SDK to receive verified human results and session state.

Privacy model

Partner-scoped identity without cross-app exposure.

Human Gateway converts World ID proofs into partner-scoped verification, auth session and user records. Partners receive the operational signals they need without receiving raw nullifiers, identity documents or biometric data.

Partner-scoped response

verified_humantrue
unique_for_partnertrue
raw_nullifiernot exposed

Partner-scoped by design

Each partner receives its own human reference, verification history and session context.

No raw identity signals

Partners do not receive raw World ID nullifiers, identity documents or biometric data.

Operational records only

HG keeps the minimum records needed for sessions, callbacks, auditability and abuse prevention.

Developers

Start hosted. Move to SDK when your product is ready.

Use hosted Verify/Auth pages to validate your integration quickly. Then move to the SDK and signed callbacks when you need embedded flows, server-side verification and production-grade session handling.

Hosted Verify
Hosted Auth
SDK
Signed callbacks
Partner Console
Audit logs

Install SDK

npm install @human-gateway/sdk

Initialize verification

import { HumanGateway } from "@human-gateway/sdk";

const hg = new HumanGateway({
  projectId: process.env.NEXT_PUBLIC_HG_PROJECT_ID!,
  environment: "production",
});

const verificationResult = await hg.verify({
  actionKey: process.env.NEXT_PUBLIC_HG_VERIFY_ACTION_KEY!,
});

if (verificationResult.verified_human) {
  // Update UI immediately.
  // Persist durable state after a valid signed callback.
}

Partner-scoped response

{
  "success": true,
  "verified_human": true,
  "verification_level": "orb",
  "unique_for_partner": true,
  "already_verified": false,
  "project_id": "project_xxx"
}

Use cases

Built for products where one real human should matter.

Human Gateway helps partners add privacy-preserving human checks, private auth sessions and operational controls to flows that are vulnerable to bots, sybils or duplicate participation.

Communities & social platforms

Reduce duplicate accounts, spam and fake engagement while keeping user identity private.

Rewards, airdrops & campaigns

Gate participation behind unique-human checks to reduce sybil abuse in high-incentive flows.

Marketplaces & reputation

Add verified-human status to accounts, listings or sensitive actions without collecting identity documents.

Voting & governance

Support one-human-one-action mechanics for polls, governance, access decisions or community votes.

Gaming & anti-bot flows

Reduce bot farming, multi-account abuse and fake participation in competitive or reward-based ecosystems.

Developer platforms & beta access

Protect waitlists, APIs, trials and partner onboarding with private human verification and session controls.

Early partner access

Bring private human verification into your product.

Human Gateway is onboarding selected early partners that need hosted Verify, private Auth, signed callbacks and partner-scoped human identity infrastructure.