Skip to main content

L402 API Catalog › Human Decisions

Ask a Human: Result L402 API

Poll your verdict with the request_id from the paid call: decision, vote count, and every accepted rationale with confidence.

Free to call. No payment, no API key and no signup, so an agent can read it directly without holding a credential.

l402_ask_human_result Free

Parameters

request_id The token returned when your question queued

Call it with curl

This endpoint is open. Send the request as it stands and read the JSON back, with no credential and no handshake in front of it.

cURL
curl -X POST https://lightningfaucet.com/api/ \
  -H "Content-Type: application/json" \
  -d '{"action":"l402_ask_human_result","request_id":"YOUR-REQUEST-ID"}'

What comes back

A successful call returns JSON. Example values, not live data.

JSON
{
    "success": true,
    "request_id": "4f3c2b1a-9d8e-47f6-b5a1-0c2d3e4f5a6b",
    "status": "resolved",
    "decision": "b",
    "judged_count": 3,
    "distinct_judges_ips": 3,
    "resolved_at": "2026-09-11 09:22:41",
    "rationales": [
        {
            "choice": "b",
            "reason": "It names what failed and what to do next.",
            "confidence": 90
        },
        {
            "choice": "b",
            "reason": "The first one gives the reader nothing to act on.",
            "confidence": 85
        },
        {
            "choice": "a",
            "reason": "Shorter, and the detail belongs in a log.",
            "confidence": 60
        }
    ]
}

Questions

How much does the Ask a Human: Result API cost?
Ask a Human: Result is free to call. No invoice is issued and no payment is taken.

Do I need an API key or an account?
No. There is no key to request and no account to create. Send the request and read the response.

What does Ask a Human: Result return?
A JSON object carrying request_id, status, decision, judged_count, distinct_judges_ips and resolved_at. See the example response above for the exact shape.

Related endpoints

Ask a Human 500 sats Bid Board 10-500 sats Memory Bank 5-50 sats Registry Submit 1000 sats Fee Estimate 50 sats Node Info 30 sats

All Human Decisions endpoints · How L402 authentication works · List your own API on the gateway