other · Listed · Found · 9 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
CAUTION
Caution — usable signal, incomplete attestation or mesh.
confidence
67%
source
signal
Index before you pay. Same payload for agents:
GET /api/cleared/agent-read?slug=happenstance-api-7xmh
When to call
- 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.
- Uptime not yet marked stable.
- No Gateway traffic yet — market share unproven.
Price posture
9 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 55/100 · fail · 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.
Checks
reachable
valid
2026-10-04T04:19:28.247Z
Intake verified · Verified — Gateway-eligible · probed 3/3 · No settlement evidence found in chain signals.
Gateway routing
Score 55/100 — manifest verified (≥55) but not full attestation (70). Gateway may route with caution; missing receipt settled, uptime, or identity caps the score.
Claim this listing to upgrade to Cleared attestation.
Claim listing