other · Listed · Found · 17 endpoints · Gateway-eligible
Happenstance API
Happenstance API
The Happenstance API provides programmatic access to person research and network search functionality. ## Authentication All API endpoints require authenticat
Indexed from this operator's public /.well-known/x402.json. Found is not operator-owned and is not attested. Claim or opt out.
Agent Read · Cleared Index
ROUTE
Route when you need other at published x402 prices.
confidence
78%
source
signal
Index before you pay. Same payload for agents:
GET /api/cleared/agent-read?slug=happenstance-api-7xmh
When to call
- Need other via x402 and want Cleared-indexed payTo with a live scorecard.
- The Happenstance API provides programmatic access to person research and network search functionality. ## Authentication All API endpoints require authenticat
Risks
- Found — not operator-owned; claim status unknown.
- No Cleared settlement receipt on file yet.
- No Gateway traffic yet — market share unproven.
Price posture
17 endpoints — confirm price on manifest before pay.
Category · Gateway
other · no Gateway routes yet — early / unproven on Cleared market share.
Endpoint hints
POST /v1/searchSearch for people within specified groups and/or within a user's connections. Use @mentions in your search query to filter results to a specific person's conne
GET /v1/search/{search_id}Get search results. Returns the status and results of a search request. Optionally provide a page_id to retrieve a specific page of results.
POST /v1/search/{search_id}/find-moreFind more results for a search. Creates a new search that excludes all people from previous results in the search chain. Uses the same query and settings as th
POST /v1/researchStart a new person research request. Include as many details as possible about the person in the description field (full name, company, title, location, social
GET /v1/research/{research_id}Get the status of a research request.
GET /v1/users/meGet the current user's profile.
GET /v1/groupsGET /v1/groups at $Metered.
GET /v1/groups/{group_id}Get details of a specific group including its members. Member names can be used as @mentions in search queries to filter results to that person's connections (
Evidence (Cleared)
- → Intake verified · Gateway-eligible
- → Trust 70/100 · pass · tier listed
- → Protocol mpp
- → Manifest reachable · schema valid
- → Found listing — indexed from public x402.json, not operator-attested.
Endpoints
Create Search
$MeteredPOST https://happenstance.ai/v1/searchSearch for people within specified groups and/or within a user's connections. Use @mentions in your search query to filter results to a specific person's connections (e.g., "engineers @Jane Smith knows"). Use the /v1/groups/{group_id} endpoint to look up member names for @mentions. Requires sufficient credits. Returns 402 Payment Required if not enough credits. Returns 429 Too Many Requests if you have 10 or more search requests currently running.
Get Search
$MeteredGET https://happenstance.ai/v1/search/{search_id}Get search results. Returns the status and results of a search request. Optionally provide a page_id to retrieve a specific page of results.
Find More Search
$MeteredPOST https://happenstance.ai/v1/search/{search_id}/find-moreFind more results for a search. Creates a new search that excludes all people from previous results in the search chain. Uses the same query and settings as the original search. Can only be called on the parent search (searches without a parent_search_id). Requires sufficient credits. Returns 402 Payment Required if not enough credits. Returns 429 Too Many Requests if you have 10 or more search requests currently running.
Create Research
$MeteredPOST https://happenstance.ai/v1/researchStart a new person research request. Include as many details as possible about the person in the description field (full name, company, title, location, social media handles, etc.) for best results. Requires sufficient credits. Returns 402 Payment Required if not enough credits. Returns 429 Too Many Requests if you have 10 or more research requests currently running.
Get Research
$MeteredGET https://happenstance.ai/v1/research/{research_id}Get the status of a research request.
Get Current User Profile
$MeteredGET https://happenstance.ai/v1/users/meGet the current user's profile.
Get Groups
$MeteredGET https://happenstance.ai/v1/groupsGet Group
$MeteredGET https://happenstance.ai/v1/groups/{group_id}Get details of a specific group including its members. Member names can be used as @mentions in search queries to filter results to that person's connections (e.g., "engineers @Jane Smith knows").
Get Usage
$MeteredGET https://happenstance.ai/v1/usageGet credit balance, purchase history, usage history, and Auto Reload settings for the authenticated user.
List Chats
$MeteredGET https://happenstance.ai/v1/chatThe user's chats, most recently active first: the ones started through the API, which take messages, and the ones started in the Happenstance app, which can be read.
Create Chat
$MeteredPOST https://happenstance.ai/v1/chatStart a chat with Happenstance Chat, optionally with its first message. Chat searches the user's network (their connections, their friends' and their groups'), researches people and drafts outreach, over as many turns as the conversation needs. A message returns at once with a turn id: poll GET /v1/chat/{chat_id}/turns/{turn_id} until the turn's status is completed, then read the people and drafts. Each turn is charged when it finishes. Returns 402 when the balance is below 3 credits.
Get Chat
$MeteredGET https://happenstance.ai/v1/chat/{chat_id}The whole chat: its messages (Chat's as markdown), its turns, the searches it ran, and the notes Chat keeps on the user's goal and preferences (memory) and on older turns.
Send Chat Message
$MeteredPOST https://happenstance.ai/v1/chat/{chat_id}/messagesSend a message to a chat started through the API. Returns at once with the turn to poll. A message sent while a turn is still working joins that turn (joined: true): Chat takes it into the work in progress, and the turn's reply and charge cover both messages. When a turn ends with stop_reason needs_input, Chat waits on the questions in its reply.questions: send answers (by question index and option label), a message that answers them in words, or both. The answer starts the next turn (answered: true). Returns 402 when the balance is below 3 credits for this message and for each turn still running, 409 for a chat started in the app.
Get Chat Turn
$MeteredGET https://happenstance.ai/v1/chat/{chat_id}/turns/{turn_id}A turn: its status, Chat's reply so far (markdown), the searches it ran, and its usage and charge once finished. Poll every 5 seconds for the first minute, then every 10; turns with searches usually take 1 to 3 minutes. Not rate limited. `latest` reads the chat's newest turn; the response's `id` names it.
Cancel Chat Turn
$MeteredPOST https://happenstance.ai/v1/chat/{chat_id}/turns/{turn_id}/cancelStop a running turn, as the Stop button in the app does. Chat keeps what it wrote, its searches stop, and the turn ends cancelled, charged for the work done. A finished turn is returned as it is. `latest` stops whatever the chat is working on.
Get Chat People
$MeteredGET https://happenstance.ai/v1/chat/{chat_id}/peopleEveryone Chat showed in the chat, one row per person with their cards merged: title, company, location, LinkedIn, how the user is connected (directly, and through which mutuals, with connection strength), and why Chat picked them. In order of first appearance; with turn_id, the people of that turn.
Get Chat Drafts
$MeteredGET https://happenstance.ai/v1/chat/{chat_id}/draftsThe message drafts Chat wrote in the chat. Happenstance never sends them; the caller may, with the user's own email, LinkedIn or other tools.
Checks
reachable
valid
2026-11-19T09:32:37.945Z
No settlement evidence found in chain signals.
Gateway routing
Score ≥70/100 — Cleared attestation pass. Route via Gateway before pay.
Claim to manage this card — or go straight to Cleared attestation ($49/mo).
Claim listing