Authentication

Two authentication methods, depending on how you access HumanJudge data.

Personal Access Token (PAT)

For the Python SDK and direct API calls. Your token starts with gj_pat_.

How to get your token

  1. 1

    Go to Pulse Check

    Sign in and navigate to the Pulse Check hub.

  2. 2

    Find "Your API token" section

    At the bottom of the page.

  3. 3

    Click Generate

    Copy and save your token immediately — it won't be shown again. If you lose it, click Regenerate to create a new one (the old token is deactivated).

Using your token

Python SDK 
from grandjury import GJClient
gj = GJClient(token="gj_pat_...")
HTTP Header 
Authorization: Bearer gj_pat_...
Environment variable 
export HUMANJUDGE_API_TOKEN=gj_pat_...

# SDK picks it up automatically
gj = GJClient()  # no token arg needed

OAuth

For ChatGPT, Claude Desktop, and Claude Code integrations. OAuth is handled automatically — you sign in with your HumanJudge account when prompted.

✓

ChatGPT

OAuth triggers when you first use the AI Quality Check GPT. Click "Sign in" and authorize.

✓

Claude Desktop

OAuth triggers when you click "Connect" on the custom connector. Your browser opens for sign-in.

✓

Claude Code

OAuth triggers when you click "needs auth" on the HumanJudge MCP server. Your browser opens for sign-in.

Access levels

What you can access depends on your authentication:

Endpoint No auth Authenticated
Leaderboard ✓ Public ✓
Latest claims ✓ Public ✓
Vote-level data — ✓
Search / content check ✓ Public ✓

Need help?

Questions about authentication? Email support@humanjudge.com