Page identifier for the current result page. Null for the first page (the parent search itself). For subsequent pages, this is the page_id returned by POST /v1/search/{id}/find-more.
Page identifier for the next result page. Use as the page_id query parameter on GET /v1/search/{id}?page_id={next_page} to retrieve the next page. Null if no next page exists.
Whether more results may be available via POST /v1/search/{id}/find-more. Searches return up to 30 results at a time.
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Happenstance","description":"Happenstance API Documentation","colors":{"primary":"#16a34a","light":"#16a34a","dark":"#16a34a"},"logo":{"light":"https://mintcdn.com/happenstance/YSbudQ8_lua9CNAo/logo/happenstance.png?fit=max\u0026auto=format\u0026n=YSbudQ8_lua9CNAo\u0026q=85\u0026s=a2c2c708eb248e6bea6607330505d0f9","dark":"https://mintcdn.com/happenstance/YSbudQ8_lua9CNAo/logo/happenstance.png?fit=max\u0026auto=format\u0026n=YSbudQ8_lua9CNAo\u0026q=85\u0026s=a2c2c708eb248e6bea6607330505d0f9"},"favicon":"https://mintcdn.com/happenstance/YSbudQ8_lua9CNAo/favicon.ico?fit=max\u0026auto=format\u0026n=YSbudQ8_lua9CNAo\u0026q=85\u0026s=473cc44090dbce2ce1585f7bf108bc4b","api":{"playground":{"display":"interactive"},"examples":{"languages":["curl","python","javascript"]}},"background":{"color":{"dark":"#191a1a"}},"navbar":{"links":[{"href":"https://discord.gg/4YV5Sxd534","label":"Community"},{"href":"https://github.com/happenstance-ai/cookbook","label":"Cookbook"}],"primary":{"type":"button","label":"Home","href":"https://happenstance.ai"}},"errors":{"404":{"redirect":false,"title":"Not Found"}},"contextual":{"options":["copy","view","chatgpt","claude"],"display":"header"},"styling":{"latex":false},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"happenstance","hasAudioNarration":false,"actualSubdomain":"happenstance","customDomains":["developer.happenstance.ai"],"gitSource":{"type":"github","owner":"happenstance-ai","repo":"developer-docs","deployBranch":"main","contentDirectory":"","isPrivate":true,"mountPath":"","label":""},"chroma":{"liveDeploymentHistoryId":"6adb99c08b194079f4a33b08","collectionId":"0f7ec737-09d5-4e48-a55d-2c29b564802c","schemaVersion":"v3","latestBuiltDeploymentHistoryId":"6adb99c08b194079f4a33b08"},"entitlements":{},"buildId":"6adb99c08b194079f4a33b08","clientVersion":"0.0.3971","searchFilterCounts":[{"language":"default","tag":"Connect","count":26},{"language":"default","tag":"API","count":20},{"language":"default","tag":"API Reference","count":17}]},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":false,"enableAskAiSearchBar":true},"basePath":"","hasChatPermissions":false,"hasWebMcpPermissions":false,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-v7-file-tree","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"pause-universal-search-reconcile","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"per-site-search-delta","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-private-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-nav-generations","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"byok-sep-25","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"vite-origin","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-agent-model-picker","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-updated-9-15","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"isAtlas":false,"googleFontsInlined":false},"customCss":[],"page":{"pagePath":"api-reference/get-search","slug":"/api-reference/get-search","pageMetadata":{"title":"Get Search","description":"Get search results.\n\nReturns the status and results of a search request.\nOptionally provide a page_id to retrieve a specific page of results.","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/search/{search_id}","href":"/api-reference/get-search","autogeneratedByOpenApi":true},"description":{"compiledSource":"\"use strict\";\nconst {Fragment: _Fragment, jsx: _jsx, jsxs: _jsxs} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsxs(_Fragment, {\n children: [_jsx(_components.p, {\n children: \"Get search results.\"\n }), \"\\n\", _jsx(_components.p, {\n children: \"Returns the status and results of a search request.\\nOptionally provide a page_id to retrieve a specific page of results.\"\n })]\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){return _jsx(_Fragment,{})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"Get Search","description":"Get search results.\n\nReturns the status and results of a search request.\nOptionally provide a page_id to retrieve a specific page of results.","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/search/{search_id}","href":"/api-reference/get-search","autogeneratedByOpenApi":true}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":[],"openApiReferenceData":{"operation":{"summary":"Get Search","description":"Get search results.\n\nReturns the status and results of a search request.\nOptionally provide a page_id to retrieve a specific page of results.","operationId":"get_search_v1_search__search_id__get","security":["75653f28-611a-4c53-8fef-b91b1acd8da6"],"parameters":["27fdfaf1-be91-4f92-b577-26c8f610bd9b","c700e658-5d95-4783-a235-1b0f159c0f82"],"responses":{"200":"90fb5ff1-33bb-473b-b21e-5e4621f45922","400":"b9a51d91-de22-4e1f-ba11-ee944b0666f4","401":"1cae9561-411a-4dd0-8677-f3c5492cacb2","402":"1645bfa2-3b90-4131-b555-3a929b352e10","403":"1b875b2d-d495-4081-ab27-a251016d3b9f","404":"9e9ab036-c40d-459d-bff8-b2f54d0e07a7","410":"b401aa89-413a-441a-b214-d66ef58acc93","422":"e8315bda-1d9e-420e-a88c-4307db550b49","500":"35521f4c-cd8f-4af0-865c-b91918a6d9a1","503":"d02b75de-d623-4e87-84b1-0ba4490af1df"},"method":"get","type":"path","servers":["3928d332-2975-4017-a644-c4e0c2212c48"],"path":"/v1/search/{search_id}","baseUrlOptions":["https://api.happenstance.ai"],"title":"Get Search","codeSamples":[],"requestExampleLanguages":["bash","python","javascript"],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{"27fdfaf1-be91-4f92-b577-26c8f610bd9b":{"name":"search_id","in":"path","required":true,"schema":{"type":"string","title":"Search Id","isRequired":true,"uniqueKey":"","typeLabel":"string"}},"c700e658-5d95-4783-a235-1b0f159c0f82":{"name":"page_id","in":"query","required":false,"schema":{"oneOf":[{"type":"string","title":"Page Id","uniqueKey":"oneOf.0","typeLabel":"string"},{"type":"null","title":"Page Id","uniqueKey":"oneOf.1","typeLabel":"null"}],"isRequired":false,"uniqueKey":"","typeLabel":"string | null"}}},"responses":{"90fb5ff1-33bb-473b-b21e-5e4621f45922":{"description":"Successful Response","content":{"application/json":{"schema":{"properties":{"id":{"type":"string","title":"Id","description":"Unique identifier for the search request","isRequired":true,"uniqueKey":"id","typeLabel":"string"},"url":{"type":"string","title":"Url","description":"URL to view the search results on Happenstance (points to parent search for continued searches)","isRequired":true,"uniqueKey":"url","typeLabel":"string"},"status":{"type":"string","title":"Status","description":"Status of the search (RUNNING, COMPLETED, FAILED)","isRequired":true,"uniqueKey":"status","typeLabel":"string"},"text":{"type":"string","title":"Text","description":"Original search query text","isRequired":true,"uniqueKey":"text","typeLabel":"string"},"created_at":{"type":"string","title":"Created At","description":"Timestamp when search was created (ISO 8601 format)","isRequired":true,"uniqueKey":"created_at","typeLabel":"string"},"updated_at":{"type":"string","title":"Updated At","description":"Timestamp when search was last updated (ISO 8601 format)","isRequired":true,"uniqueKey":"updated_at","typeLabel":"string"},"group_ids":{"items":{"type":"string","uniqueKey":"group_ids.items.[INDEX]","typeLabel":"string"},"type":"array","title":"Group Ids","description":"List of group IDs that were searched","uniqueKey":"group_ids","typeLabel":"string[]"},"include_friends_connections":{"type":"boolean","title":"Include Friends Connections","description":"Whether the search included friends' connections","default":false,"uniqueKey":"include_friends_connections","typeLabel":"boolean"},"include_my_connections":{"type":"boolean","title":"Include My Connections","description":"Whether the search included the user's own connections","default":false,"uniqueKey":"include_my_connections","typeLabel":"boolean"},"mutuals":{"oneOf":[{"type":"array","items":{"properties":{"index":{"type":"integer","title":"Index","description":"Index of this mutual in the mutuals array","isRequired":true,"uniqueKey":"mutuals.oneOf.0.items.[INDEX].index","typeLabel":"integer"},"id":{"type":"string","title":"Id","description":"Unique identifier for the mutual connection","isRequired":true,"uniqueKey":"mutuals.oneOf.0.items.[INDEX].id","typeLabel":"string"},"name":{"type":"string","title":"Name","description":"Name of the mutual connection","isRequired":true,"uniqueKey":"mutuals.oneOf.0.items.[INDEX].name","typeLabel":"string"},"happenstance_url":{"type":"string","title":"Happenstance Url","description":"URL to the mutual's Happenstance profile","isRequired":true,"uniqueKey":"mutuals.oneOf.0.items.[INDEX].happenstance_url","typeLabel":"string"}},"additionalProperties":false,"type":"object","required":["index","id","name","happenstance_url"],"title":"SearchMutualV1","description":"A mutual connection who can introduce you to search results (normalized, top-level)","uniqueKey":"mutuals.oneOf.0.items.[INDEX]","typeLabel":"SearchMutualV1 · object"},"title":"Mutuals","description":"All unique mutual connections across results. Results reference these by index.","uniqueKey":"mutuals.oneOf.0","typeLabel":"SearchMutualV1 · object[]"},{"type":"null","title":"Mutuals","description":"All unique mutual connections across results. Results reference these by index.","uniqueKey":"mutuals.oneOf.1","typeLabel":"null"}],"uniqueKey":"mutuals","typeLabel":"SearchMutualV1 · object[] | null"},"traits":{"oneOf":[{"type":"array","items":{"properties":{"index":{"type":"integer","title":"Index","description":"Index of this trait in the traits array","isRequired":true,"uniqueKey":"traits.oneOf.0.items.[INDEX].index","typeLabel":"integer"},"header":{"type":"string","title":"Header","description":"Short label for the trait (e.g., 'Undergrad')","isRequired":true,"uniqueKey":"traits.oneOf.0.items.[INDEX].header","typeLabel":"string"},"description":{"oneOf":[{"type":"string","title":"Description","description":"Full trait description explaining what was evaluated","uniqueKey":"traits.oneOf.0.items.[INDEX].description.oneOf.0","typeLabel":"string"},{"type":"null","title":"Description","description":"Full trait description explaining what was evaluated","uniqueKey":"traits.oneOf.0.items.[INDEX].description.oneOf.1","typeLabel":"null"}],"uniqueKey":"traits.oneOf.0.items.[INDEX].description","typeLabel":"string | null"}},"additionalProperties":false,"type":"object","required":["index","header"],"title":"SearchTraitV1","description":"A trait definition (normalized, top-level)","uniqueKey":"traits.oneOf.0.items.[INDEX]","typeLabel":"SearchTraitV1 · object"},"title":"Traits","description":"All trait definitions for this search. Results reference these by index.","uniqueKey":"traits.oneOf.0","typeLabel":"SearchTraitV1 · object[]"},{"type":"null","title":"Traits","description":"All trait definitions for this search. Results reference these by index.","uniqueKey":"traits.oneOf.1","typeLabel":"null"}],"uniqueKey":"traits","typeLabel":"SearchTraitV1 · object[] | null"},"results":{"oneOf":[{"type":"array","items":{"properties":{"id":{"type":"string","title":"Id","description":"Unique identifier for the person","isRequired":true,"uniqueKey":"results.oneOf.0.items.[INDEX].id","typeLabel":"string"},"name":{"type":"string","title":"Name","description":"Person's name","isRequired":true,"uniqueKey":"results.oneOf.0.items.[INDEX].name","typeLabel":"string"},"weighted_traits_score":{"type":"number","title":"Weighted Traits Score","description":"Overall relevance score based on trait evaluations. Calculated as sum of trait scores minus penalties for traits scored zero. Can be negative.","isRequired":true,"uniqueKey":"results.oneOf.0.items.[INDEX].weighted_traits_score","typeLabel":"number"},"socials":{"properties":{"happenstance_url":{"type":"string","title":"Happenstance Url","description":"URL to the person's Happenstance profile","isRequired":true,"uniqueKey":"results.oneOf.0.items.[INDEX].socials.happenstance_url","typeLabel":"string"},"linkedin_url":{"oneOf":[{"type":"string","title":"Linkedin Url","description":"LinkedIn profile URL","uniqueKey":"results.oneOf.0.items.[INDEX].socials.linkedin_url.oneOf.0","typeLabel":"string"},{"type":"null","title":"Linkedin Url","description":"LinkedIn profile URL","uniqueKey":"results.oneOf.0.items.[INDEX].socials.linkedin_url.oneOf.1","typeLabel":"null"}],"uniqueKey":"results.oneOf.0.items.[INDEX].socials.linkedin_url","typeLabel":"string | null"},"twitter_url":{"oneOf":[{"type":"string","title":"Twitter Url","description":"Twitter/X profile URL","uniqueKey":"results.oneOf.0.items.[INDEX].socials.twitter_url.oneOf.0","typeLabel":"string"},{"type":"null","title":"Twitter Url","description":"Twitter/X profile URL","uniqueKey":"results.oneOf.0.items.[INDEX].socials.twitter_url.oneOf.1","typeLabel":"null"}],"uniqueKey":"results.oneOf.0.items.[INDEX].socials.twitter_url","typeLabel":"string | null"},"instagram_url":{"oneOf":[{"type":"string","title":"Instagram Url","description":"Instagram profile URL","uniqueKey":"results.oneOf.0.items.[INDEX].socials.instagram_url.oneOf.0","typeLabel":"string"},{"type":"null","title":"Instagram Url","description":"Instagram profile URL","uniqueKey":"results.oneOf.0.items.[INDEX].socials.instagram_url.oneOf.1","typeLabel":"null"}],"uniqueKey":"results.oneOf.0.items.[INDEX].socials.instagram_url","typeLabel":"string | null"}},"additionalProperties":false,"type":"object","required":["happenstance_url"],"title":"SocialsV1","description":"Profile URLs","isRequired":true,"uniqueKey":"results.oneOf.0.items.[INDEX].socials","typeLabel":"SocialsV1 · object"},"current_title":{"oneOf":[{"type":"string","title":"Current Title","description":"Current job title","uniqueKey":"results.oneOf.0.items.[INDEX].current_title.oneOf.0","typeLabel":"string"},{"type":"null","title":"Current Title","description":"Current job title","uniqueKey":"results.oneOf.0.items.[INDEX].current_title.oneOf.1","typeLabel":"null"}],"uniqueKey":"results.oneOf.0.items.[INDEX].current_title","typeLabel":"string | null"},"current_company":{"oneOf":[{"type":"string","title":"Current Company","description":"Current company","uniqueKey":"results.oneOf.0.items.[INDEX].current_company.oneOf.0","typeLabel":"string"},{"type":"null","title":"Current Company","description":"Current company","uniqueKey":"results.oneOf.0.items.[INDEX].current_company.oneOf.1","typeLabel":"null"}],"uniqueKey":"results.oneOf.0.items.[INDEX].current_company","typeLabel":"string | null"},"summary":{"oneOf":[{"type":"string","title":"Summary","description":"AI-generated summary of why this person matches","uniqueKey":"results.oneOf.0.items.[INDEX].summary.oneOf.0","typeLabel":"string"},{"type":"null","title":"Summary","description":"AI-generated summary of why this person matches","uniqueKey":"results.oneOf.0.items.[INDEX].summary.oneOf.1","typeLabel":"null"}],"uniqueKey":"results.oneOf.0.items.[INDEX].summary","typeLabel":"string | null"},"mutuals":{"oneOf":[{"type":"array","items":{"properties":{"index":{"type":"integer","title":"Index","description":"Index into the top-level mutuals array","isRequired":true,"uniqueKey":"results.oneOf.0.items.[INDEX].mutuals.oneOf.0.items.[INDEX].index","typeLabel":"integer"},"affinity_score":{"oneOf":[{"type":"number","title":"Affinity Score","description":"Affinity score indicating connection strength between the mutual and this person. Higher values indicate stronger connections.","uniqueKey":"results.oneOf.0.items.[INDEX].mutuals.oneOf.0.items.[INDEX].affinity_score.oneOf.0","typeLabel":"number"},{"type":"null","title":"Affinity Score","description":"Affinity score indicating connection strength between the mutual and this person. Higher values indicate stronger connections.","uniqueKey":"results.oneOf.0.items.[INDEX].mutuals.oneOf.0.items.[INDEX].affinity_score.oneOf.1","typeLabel":"null"}],"uniqueKey":"results.oneOf.0.items.[INDEX].mutuals.oneOf.0.items.[INDEX].affinity_score","typeLabel":"number | null"}},"additionalProperties":false,"type":"object","required":["index"],"title":"SearchMutualRefV1","description":"Reference to a mutual with result-specific affinity score","uniqueKey":"results.oneOf.0.items.[INDEX].mutuals.oneOf.0.items.[INDEX]","typeLabel":"SearchMutualRefV1 · object"},"title":"Mutuals","description":"References to mutual connections (indices into top-level mutuals array)","uniqueKey":"results.oneOf.0.items.[INDEX].mutuals.oneOf.0","typeLabel":"SearchMutualRefV1 · object[]"},{"type":"null","title":"Mutuals","description":"References to mutual connections (indices into top-level mutuals array)","uniqueKey":"results.oneOf.0.items.[INDEX].mutuals.oneOf.1","typeLabel":"null"}],"uniqueKey":"results.oneOf.0.items.[INDEX].mutuals","typeLabel":"SearchMutualRefV1 · object[] | null"},"traits":{"oneOf":[{"type":"array","items":{"properties":{"index":{"type":"integer","title":"Index","description":"Index into the top-level traits array","isRequired":true,"uniqueKey":"results.oneOf.0.items.[INDEX].traits.oneOf.0.items.[INDEX].index","typeLabel":"integer"},"score":{"type":"number","title":"Score","description":"Score for this trait (0, 0.5, or 1)","isRequired":true,"uniqueKey":"results.oneOf.0.items.[INDEX].traits.oneOf.0.items.[INDEX].score","typeLabel":"number"},"evidence":{"oneOf":[{"type":"string","title":"Evidence","description":"Supporting quote or citation from the person's profile","uniqueKey":"results.oneOf.0.items.[INDEX].traits.oneOf.0.items.[INDEX].evidence.oneOf.0","typeLabel":"string"},{"type":"null","title":"Evidence","description":"Supporting quote or citation from the person's profile","uniqueKey":"results.oneOf.0.items.[INDEX].traits.oneOf.0.items.[INDEX].evidence.oneOf.1","typeLabel":"null"}],"uniqueKey":"results.oneOf.0.items.[INDEX].traits.oneOf.0.items.[INDEX].evidence","typeLabel":"string | null"}},"additionalProperties":false,"type":"object","required":["index","score"],"title":"SearchTraitScoreV1","description":"Reference to a trait with result-specific score and evidence","uniqueKey":"results.oneOf.0.items.[INDEX].traits.oneOf.0.items.[INDEX]","typeLabel":"SearchTraitScoreV1 · object"},"title":"Traits","description":"Trait scores for this person (indices into top-level traits array)","uniqueKey":"results.oneOf.0.items.[INDEX].traits.oneOf.0","typeLabel":"SearchTraitScoreV1 · object[]"},{"type":"null","title":"Traits","description":"Trait scores for this person (indices into top-level traits array)","uniqueKey":"results.oneOf.0.items.[INDEX].traits.oneOf.1","typeLabel":"null"}],"uniqueKey":"results.oneOf.0.items.[INDEX].traits","typeLabel":"SearchTraitScoreV1 · object[] | null"}},"additionalProperties":false,"type":"object","required":["id","name","weighted_traits_score","socials"],"title":"SearchPersonV1","description":"Individual search result representing a person","uniqueKey":"results.oneOf.0.items.[INDEX]","typeLabel":"SearchPersonV1 · object"},"title":"Results","description":"Search results (only populated when status is COMPLETED)","uniqueKey":"results.oneOf.0","typeLabel":"SearchPersonV1 · object[]"},{"type":"null","title":"Results","description":"Search results (only populated when status is COMPLETED)","uniqueKey":"results.oneOf.1","typeLabel":"null"}],"uniqueKey":"results","typeLabel":"SearchPersonV1 · object[] | null"},"page_id":{"oneOf":[{"type":"string","title":"Page Id","description":"Page identifier for the current result page. Null for the first page (the parent search itself). For subsequent pages, this is the page_id returned by POST /v1/search/{id}/find-more.","uniqueKey":"page_id.oneOf.0","typeLabel":"string"},{"type":"null","title":"Page Id","description":"Page identifier for the current result page. Null for the first page (the parent search itself). For subsequent pages, this is the page_id returned by POST /v1/search/{id}/find-more.","uniqueKey":"page_id.oneOf.1","typeLabel":"null"}],"uniqueKey":"page_id","typeLabel":"string | null"},"next_page":{"oneOf":[{"type":"string","title":"Next Page","description":"Page identifier for the next result page. Use as the page_id query parameter on GET /v1/search/{id}?page_id={next_page} to retrieve the next page. Null if no next page exists.","uniqueKey":"next_page.oneOf.0","typeLabel":"string"},{"type":"null","title":"Next Page","description":"Page identifier for the next result page. Use as the page_id query parameter on GET /v1/search/{id}?page_id={next_page} to retrieve the next page. Null if no next page exists.","uniqueKey":"next_page.oneOf.1","typeLabel":"null"}],"uniqueKey":"next_page","typeLabel":"string | null"},"has_more":{"type":"boolean","title":"Has More","description":"Whether more results may be available via POST /v1/search/{id}/find-more. Searches return up to 30 results at a time.","default":false,"uniqueKey":"has_more","typeLabel":"boolean"}},"additionalProperties":false,"type":"object","required":["id","url","status","text","created_at","updated_at"],"title":"GetSearchResponseV1","description":"Response from GET /v1/search/{id} - retrieving search status and results.","uniqueKey":"","typeLabel":"GetSearchResponseV1 · object"},"examples":{"Example":{"title":"Example","value":{"id":"\u003cstring>","url":"\u003cstring>","status":"\u003cstring>","text":"\u003cstring>","created_at":"\u003cstring>","updated_at":"\u003cstring>","group_ids":["\u003cstring>"],"include_friends_connections":false,"include_my_connections":false,"mutuals":[{"index":123,"id":"\u003cstring>","name":"\u003cstring>","happenstance_url":"\u003cstring>"}],"traits":[{"index":123,"header":"\u003cstring>","description":"\u003cstring>"}],"results":[{"id":"\u003cstring>","name":"\u003cstring>","weighted_traits_score":123,"socials":{"happenstance_url":"\u003cstring>","linkedin_url":"\u003cstring>","twitter_url":"\u003cstring>","instagram_url":"\u003cstring>"},"current_title":"\u003cstring>","current_company":"\u003cstring>","summary":"\u003cstring>","mutuals":[{"index":123,"affinity_score":123}],"traits":[{"index":123,"score":123,"evidence":"\u003cstring>"}]}],"page_id":"\u003cstring>","next_page":"\u003cstring>","has_more":false}}},"exampleType":"generated"}},"headers":{"Link":{"description":"RFC 8288 Web Linking header for HATEOAS. Contains URIs to related resources.","schema":{"type":"string"},"example":"\u003c/v1/research/abc123>; rel=\"self\""}},"exampleType":"generated"},"b9a51d91-de22-4e1f-ba11-ee944b0666f4":{"description":"Bad Request","content":{"application/json":{"schema":{"properties":{"title":{"type":"string","title":"Title","description":"A short, human-readable summary of the problem","isRequired":true,"uniqueKey":"title","typeLabel":"string"},"status":{"type":"integer","title":"Status","description":"The HTTP status code","isRequired":true,"uniqueKey":"status","typeLabel":"integer"},"type":{"type":"string","title":"Type","description":"A URI reference that identifies the problem type","default":"https://developer.happenstance.ai/api-reference/introduction#error-response-format","uniqueKey":"type","typeLabel":"string"},"detail":{"oneOf":[{"type":"string","title":"Detail","description":"A human-readable explanation specific to this occurrence","uniqueKey":"detail.oneOf.0","typeLabel":"string"},{"type":"null","title":"Detail","description":"A human-readable explanation specific to this occurrence","uniqueKey":"detail.oneOf.1","typeLabel":"null"}],"uniqueKey":"detail","typeLabel":"string | null"},"instance":{"oneOf":[{"type":"string","title":"Instance","description":"A URI reference that identifies the specific occurrence of the problem","uniqueKey":"instance.oneOf.0","typeLabel":"string"},{"type":"null","title":"Instance","description":"A URI reference that identifies the specific occurrence of the problem","uniqueKey":"instance.oneOf.1","typeLabel":"null"}],"uniqueKey":"instance","typeLabel":"string | null"}},"additionalProperties":false,"type":"object","required":["title","status"],"title":"ProblemDetailV1","description":"RFC 7807 Problem Details for HTTP APIs","uniqueKey":"","typeLabel":"ProblemDetailV1 · object"},"examples":{"Example":{"title":"Example","value":{"title":"\u003cstring>","status":123,"type":"https://developer.happenstance.ai/api-reference/introduction#error-response-format","detail":"\u003cstring>","instance":"\u003cstring>"}}},"exampleType":"generated"}},"exampleType":"generated"},"1cae9561-411a-4dd0-8677-f3c5492cacb2":{"description":"Unauthorized","content":{"application/json":{"schema":{"properties":{"title":{"type":"string","title":"Title","description":"A short, human-readable summary of the problem","isRequired":true,"uniqueKey":"title","typeLabel":"string"},"status":{"type":"integer","title":"Status","description":"The HTTP status code","isRequired":true,"uniqueKey":"status","typeLabel":"integer"},"type":{"type":"string","title":"Type","description":"A URI reference that identifies the problem type","default":"https://developer.happenstance.ai/api-reference/introduction#error-response-format","uniqueKey":"type","typeLabel":"string"},"detail":{"oneOf":[{"type":"string","title":"Detail","description":"A human-readable explanation specific to this occurrence","uniqueKey":"detail.oneOf.0","typeLabel":"string"},{"type":"null","title":"Detail","description":"A human-readable explanation specific to this occurrence","uniqueKey":"detail.oneOf.1","typeLabel":"null"}],"uniqueKey":"detail","typeLabel":"string | null"},"instance":{"oneOf":[{"type":"string","title":"Instance","description":"A URI reference that identifies the specific occurrence of the problem","uniqueKey":"instance.oneOf.0","typeLabel":"string"},{"type":"null","title":"Instance","description":"A URI reference that identifies the specific occurrence of the problem","uniqueKey":"instance.oneOf.1","typeLabel":"null"}],"uniqueKey":"instance","typeLabel":"string | null"}},"additionalProperties":false,"type":"object","required":["title","status"],"title":"ProblemDetailV1","description":"RFC 7807 Problem Details for HTTP APIs","uniqueKey":"","typeLabel":"ProblemDetailV1 · object"},"examples":{"Example":{"title":"Example","value":{"title":"\u003cstring>","status":123,"type":"https://developer.happenstance.ai/api-reference/introduction#error-response-format","detail":"\u003cstring>","instance":"\u003cstring>"}}},"exampleType":"generated"}},"exampleType":"generated"},"1645bfa2-3b90-4131-b555-3a929b352e10":{"description":"Payment Required","content":{"application/json":{"schema":{"properties":{"title":{"type":"string","title":"Title","description":"A short, human-readable summary of the problem","isRequired":true,"uniqueKey":"title","typeLabel":"string"},"status":{"type":"integer","title":"Status","description":"The HTTP status code","isRequired":true,"uniqueKey":"status","typeLabel":"integer"},"type":{"type":"string","title":"Type","description":"A URI reference that identifies the problem type","default":"https://developer.happenstance.ai/api-reference/introduction#error-response-format","uniqueKey":"type","typeLabel":"string"},"detail":{"oneOf":[{"type":"string","title":"Detail","description":"A human-readable explanation specific to this occurrence","uniqueKey":"detail.oneOf.0","typeLabel":"string"},{"type":"null","title":"Detail","description":"A human-readable explanation specific to this occurrence","uniqueKey":"detail.oneOf.1","typeLabel":"null"}],"uniqueKey":"detail","typeLabel":"string | null"},"instance":{"oneOf":[{"type":"string","title":"Instance","description":"A URI reference that identifies the specific occurrence of the problem","uniqueKey":"instance.oneOf.0","typeLabel":"string"},{"type":"null","title":"Instance","description":"A URI reference that identifies the specific occurrence of the problem","uniqueKey":"instance.oneOf.1","typeLabel":"null"}],"uniqueKey":"instance","typeLabel":"string | null"}},"additionalProperties":false,"type":"object","required":["title","status"],"title":"ProblemDetailV1","description":"RFC 7807 Problem Details for HTTP APIs","uniqueKey":"","typeLabel":"ProblemDetailV1 · object"},"examples":{"Example":{"title":"Example","value":{"title":"\u003cstring>","status":123,"type":"https://developer.happenstance.ai/api-reference/introduction#error-response-format","detail":"\u003cstring>","instance":"\u003cstring>"}}},"exampleType":"generated"}},"exampleType":"generated"},"1b875b2d-d495-4081-ab27-a251016d3b9f":{"description":"Forbidden","content":{"application/json":{"schema":{"properties":{"title":{"type":"string","title":"Title","description":"A short, human-readable summary of the problem","isRequired":true,"uniqueKey":"title","typeLabel":"string"},"status":{"type":"integer","title":"Status","description":"The HTTP status code","isRequired":true,"uniqueKey":"status","typeLabel":"integer"},"type":{"type":"string","title":"Type","description":"A URI reference that identifies the problem type","default":"https://developer.happenstance.ai/api-reference/introduction#error-response-format","uniqueKey":"type","typeLabel":"string"},"detail":{"oneOf":[{"type":"string","title":"Detail","description":"A human-readable explanation specific to this occurrence","uniqueKey":"detail.oneOf.0","typeLabel":"string"},{"type":"null","title":"Detail","description":"A human-readable explanation specific to this occurrence","uniqueKey":"detail.oneOf.1","typeLabel":"null"}],"uniqueKey":"detail","typeLabel":"string | null"},"instance":{"oneOf":[{"type":"string","title":"Instance","description":"A URI reference that identifies the specific occurrence of the problem","uniqueKey":"instance.oneOf.0","typeLabel":"string"},{"type":"null","title":"Instance","description":"A URI reference that identifies the specific occurrence of the problem","uniqueKey":"instance.oneOf.1","typeLabel":"null"}],"uniqueKey":"instance","typeLabel":"string | null"}},"additionalProperties":false,"type":"object","required":["title","status"],"title":"ProblemDetailV1","description":"RFC 7807 Problem Details for HTTP APIs","uniqueKey":"","typeLabel":"ProblemDetailV1 · object"},"examples":{"Example":{"title":"Example","value":{"title":"\u003cstring>","status":123,"type":"https://developer.happenstance.ai/api-reference/introduction#error-response-format","detail":"\u003cstring>","instance":"\u003cstring>"}}},"exampleType":"generated"}},"exampleType":"generated"},"9e9ab036-c40d-459d-bff8-b2f54d0e07a7":{"description":"Not Found","content":{"application/json":{"schema":{"properties":{"title":{"type":"string","title":"Title","description":"A short, human-readable summary of the problem","isRequired":true,"uniqueKey":"title","typeLabel":"string"},"status":{"type":"integer","title":"Status","description":"The HTTP status code","isRequired":true,"uniqueKey":"status","typeLabel":"integer"},"type":{"type":"string","title":"Type","description":"A URI reference that identifies the problem type","default":"https://developer.happenstance.ai/api-reference/introduction#error-response-format","uniqueKey":"type","typeLabel":"string"},"detail":{"oneOf":[{"type":"string","title":"Detail","description":"A human-readable explanation specific to this occurrence","uniqueKey":"detail.oneOf.0","typeLabel":"string"},{"type":"null","title":"Detail","description":"A human-readable explanation specific to this occurrence","uniqueKey":"detail.oneOf.1","typeLabel":"null"}],"uniqueKey":"detail","typeLabel":"string | null"},"instance":{"oneOf":[{"type":"string","title":"Instance","description":"A URI reference that identifies the specific occurrence of the problem","uniqueKey":"instance.oneOf.0","typeLabel":"string"},{"type":"null","title":"Instance","description":"A URI reference that identifies the specific occurrence of the problem","uniqueKey":"instance.oneOf.1","typeLabel":"null"}],"uniqueKey":"instance","typeLabel":"string | null"}},"additionalProperties":false,"type":"object","required":["title","status"],"title":"ProblemDetailV1","description":"RFC 7807 Problem Details for HTTP APIs","uniqueKey":"","typeLabel":"ProblemDetailV1 · object"},"examples":{"Example":{"title":"Example","value":{"title":"\u003cstring>","status":123,"type":"https://developer.happenstance.ai/api-reference/introduction#error-response-format","detail":"\u003cstring>","instance":"\u003cstring>"}}},"exampleType":"generated"}},"exampleType":"generated"},"b401aa89-413a-441a-b214-d66ef58acc93":{"description":"Gone","content":{"application/json":{"schema":{"properties":{"title":{"type":"string","title":"Title","description":"A short, human-readable summary of the problem","isRequired":true,"uniqueKey":"title","typeLabel":"string"},"status":{"type":"integer","title":"Status","description":"The HTTP status code","isRequired":true,"uniqueKey":"status","typeLabel":"integer"},"type":{"type":"string","title":"Type","description":"A URI reference that identifies the problem type","default":"https://developer.happenstance.ai/api-reference/introduction#error-response-format","uniqueKey":"type","typeLabel":"string"},"detail":{"oneOf":[{"type":"string","title":"Detail","description":"A human-readable explanation specific to this occurrence","uniqueKey":"detail.oneOf.0","typeLabel":"string"},{"type":"null","title":"Detail","description":"A human-readable explanation specific to this occurrence","uniqueKey":"detail.oneOf.1","typeLabel":"null"}],"uniqueKey":"detail","typeLabel":"string | null"},"instance":{"oneOf":[{"type":"string","title":"Instance","description":"A URI reference that identifies the specific occurrence of the problem","uniqueKey":"instance.oneOf.0","typeLabel":"string"},{"type":"null","title":"Instance","description":"A URI reference that identifies the specific occurrence of the problem","uniqueKey":"instance.oneOf.1","typeLabel":"null"}],"uniqueKey":"instance","typeLabel":"string | null"}},"additionalProperties":false,"type":"object","required":["title","status"],"title":"ProblemDetailV1","description":"RFC 7807 Problem Details for HTTP APIs","uniqueKey":"","typeLabel":"ProblemDetailV1 · object"},"examples":{"Example":{"title":"Example","value":{"title":"\u003cstring>","status":123,"type":"https://developer.happenstance.ai/api-reference/introduction#error-response-format","detail":"\u003cstring>","instance":"\u003cstring>"}}},"exampleType":"generated"}},"exampleType":"generated"},"e8315bda-1d9e-420e-a88c-4307db550b49":{"description":"Validation Error","content":{"application/json":{"schema":{"properties":{"title":{"type":"string","title":"Title","description":"A short, human-readable summary of the problem","isRequired":true,"uniqueKey":"title","typeLabel":"string"},"status":{"type":"integer","title":"Status","description":"The HTTP status code","isRequired":true,"uniqueKey":"status","typeLabel":"integer"},"type":{"type":"string","title":"Type","description":"A URI reference that identifies the problem type","default":"https://developer.happenstance.ai/api-reference/introduction#error-response-format","uniqueKey":"type","typeLabel":"string"},"detail":{"oneOf":[{"type":"string","title":"Detail","description":"A human-readable explanation specific to this occurrence","uniqueKey":"detail.oneOf.0","typeLabel":"string"},{"type":"null","title":"Detail","description":"A human-readable explanation specific to this occurrence","uniqueKey":"detail.oneOf.1","typeLabel":"null"}],"uniqueKey":"detail","typeLabel":"string | null"},"instance":{"oneOf":[{"type":"string","title":"Instance","description":"A URI reference that identifies the specific occurrence of the problem","uniqueKey":"instance.oneOf.0","typeLabel":"string"},{"type":"null","title":"Instance","description":"A URI reference that identifies the specific occurrence of the problem","uniqueKey":"instance.oneOf.1","typeLabel":"null"}],"uniqueKey":"instance","typeLabel":"string | null"}},"additionalProperties":false,"type":"object","required":["title","status"],"title":"ProblemDetailV1","description":"RFC 7807 Problem Details for HTTP APIs","uniqueKey":"","typeLabel":"ProblemDetailV1 · object"},"examples":{"Example":{"title":"Example","value":{"title":"\u003cstring>","status":123,"type":"https://developer.happenstance.ai/api-reference/introduction#error-response-format","detail":"\u003cstring>","instance":"\u003cstring>"}}},"exampleType":"generated"}},"exampleType":"generated"},"35521f4c-cd8f-4af0-865c-b91918a6d9a1":{"description":"Internal Server Error","content":{"application/json":{"schema":{"properties":{"title":{"type":"string","title":"Title","description":"A short, human-readable summary of the problem","isRequired":true,"uniqueKey":"title","typeLabel":"string"},"status":{"type":"integer","title":"Status","description":"The HTTP status code","isRequired":true,"uniqueKey":"status","typeLabel":"integer"},"type":{"type":"string","title":"Type","description":"A URI reference that identifies the problem type","default":"https://developer.happenstance.ai/api-reference/introduction#error-response-format","uniqueKey":"type","typeLabel":"string"},"detail":{"oneOf":[{"type":"string","title":"Detail","description":"A human-readable explanation specific to this occurrence","uniqueKey":"detail.oneOf.0","typeLabel":"string"},{"type":"null","title":"Detail","description":"A human-readable explanation specific to this occurrence","uniqueKey":"detail.oneOf.1","typeLabel":"null"}],"uniqueKey":"detail","typeLabel":"string | null"},"instance":{"oneOf":[{"type":"string","title":"Instance","description":"A URI reference that identifies the specific occurrence of the problem","uniqueKey":"instance.oneOf.0","typeLabel":"string"},{"type":"null","title":"Instance","description":"A URI reference that identifies the specific occurrence of the problem","uniqueKey":"instance.oneOf.1","typeLabel":"null"}],"uniqueKey":"instance","typeLabel":"string | null"}},"additionalProperties":false,"type":"object","required":["title","status"],"title":"ProblemDetailV1","description":"RFC 7807 Problem Details for HTTP APIs","uniqueKey":"","typeLabel":"ProblemDetailV1 · object"},"examples":{"Example":{"title":"Example","value":{"title":"\u003cstring>","status":123,"type":"https://developer.happenstance.ai/api-reference/introduction#error-response-format","detail":"\u003cstring>","instance":"\u003cstring>"}}},"exampleType":"generated"}},"exampleType":"generated"},"d02b75de-d623-4e87-84b1-0ba4490af1df":{"description":"Service Unavailable","content":{"application/json":{"schema":{"properties":{"title":{"type":"string","title":"Title","description":"A short, human-readable summary of the problem","isRequired":true,"uniqueKey":"title","typeLabel":"string"},"status":{"type":"integer","title":"Status","description":"The HTTP status code","isRequired":true,"uniqueKey":"status","typeLabel":"integer"},"type":{"type":"string","title":"Type","description":"A URI reference that identifies the problem type","default":"https://developer.happenstance.ai/api-reference/introduction#error-response-format","uniqueKey":"type","typeLabel":"string"},"detail":{"oneOf":[{"type":"string","title":"Detail","description":"A human-readable explanation specific to this occurrence","uniqueKey":"detail.oneOf.0","typeLabel":"string"},{"type":"null","title":"Detail","description":"A human-readable explanation specific to this occurrence","uniqueKey":"detail.oneOf.1","typeLabel":"null"}],"uniqueKey":"detail","typeLabel":"string | null"},"instance":{"oneOf":[{"type":"string","title":"Instance","description":"A URI reference that identifies the specific occurrence of the problem","uniqueKey":"instance.oneOf.0","typeLabel":"string"},{"type":"null","title":"Instance","description":"A URI reference that identifies the specific occurrence of the problem","uniqueKey":"instance.oneOf.1","typeLabel":"null"}],"uniqueKey":"instance","typeLabel":"string | null"}},"additionalProperties":false,"type":"object","required":["title","status"],"title":"ProblemDetailV1","description":"RFC 7807 Problem Details for HTTP APIs","uniqueKey":"","typeLabel":"ProblemDetailV1 · object"},"examples":{"Example":{"title":"Example","value":{"title":"\u003cstring>","status":123,"type":"https://developer.happenstance.ai/api-reference/introduction#error-response-format","detail":"\u003cstring>","instance":"\u003cstring>"}}},"exampleType":"generated"}},"exampleType":"generated"}},"security":{"75653f28-611a-4c53-8fef-b91b1acd8da6":{"HTTPBearer":{"type":"http","scheme":"bearer","scopes":[],"schemeName":"HTTPBearer"}}},"servers":{"3928d332-2975-4017-a644-c4e0c2212c48":{"url":"https://api.happenstance.ai","description":"Production"}},"processedSecurityOptions":[{"schemes":[{"scheme":{"type":"http","scheme":"bearer","scopes":[],"schemeName":"HTTPBearer"},"schema":{"title":"Bearer Auth","type":"string","isRequired":true,"description":"Bearer authentication header of the form `Bearer \u003ctoken>`, where `\u003ctoken>` is your auth token.","format":"bearer","typeLabel":"string\u003cbearer>","deprecated":false},"schemeName":"HTTPBearer","name":"Authorization"}],"title":"HTTPBearer"}]},"originalFileLocation":"openapi.json"},"subdomain":"happenstance","siteName":"Happenstance","title":"Get Search - Happenstance","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-10-23T17:26:19.893Z","originalFileLocation":"api-reference/get-search.mdx"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=null;if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"system\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"description\" content=\"Get search results. Returns the status and results of a search request. Optionally provide a page_id to retrieve a specific page of results.\">\u003cmeta data-mint-head name=\"application-name\" content=\"Happenstance\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/happenstance/lRTBz52T_gIZj_2l/_generated/favicon/android-chrome-192x192.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"/mintlify-assets/_mintlify/favicons/happenstance/lRTBz52T_gIZj_2l/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/happenstance/lRTBz52T_gIZj_2l/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/happenstance/lRTBz52T_gIZj_2l/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/happenstance/lRTBz52T_gIZj_2l/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/happenstance/lRTBz52T_gIZj_2l/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/happenstance/lRTBz52T_gIZj_2l/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/happenstance/lRTBz52T_gIZj_2l/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/happenstance/lRTBz52T_gIZj_2l/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Get Search - Happenstance\">\u003cmeta data-mint-head property=\"og:description\" content=\"Get search results. Returns the status and results of a search request. Optionally provide a page_id to retrieve a specific page of results.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Happenstance\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://developer.happenstance.ai/api-reference/get-search\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://happenstance.mintlify.app/_mintlify/api/og/v2?division=API+Reference\u0026amp;title=Get+Search\u0026amp;description=Get+search+results.%0A%0AReturns+the+status+and+results+of+a+search+request.%0AOptionally+provide+a+page_id+to+retrieve+a+specific+page+of+results.\u0026amp;theme=e9cbf0a039f894b97da272a2\u0026amp;signature=bec0696dd55fe543a926dcf33fb31ad7205c88abb583b7cea705543a7690f058\">\u003cmeta data-mint-head property=\"og:image:width\" content=\"1200\">\u003cmeta data-mint-head property=\"og:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"twitter:card\" content=\"summary_large_image\">\u003cmeta data-mint-head name=\"twitter:title\" content=\"Get Search - Happenstance\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Get search results. Returns the status and results of a search request. Optionally provide a page_id to retrieve a specific page of results.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://happenstance.mintlify.app/_mintlify/api/og/v2?division=API+Reference\u0026amp;title=Get+Search\u0026amp;description=Get+search+results.%0A%0AReturns+the+status+and+results+of+a+search+request.%0AOptionally+provide+a+page_id+to+retrieve+a+specific+page+of+results.\u0026amp;theme=e9cbf0a039f894b97da272a2\u0026amp;signature=bec0696dd55fe543a926dcf33fb31ad7205c88abb583b7cea705543a7690f058\">\u003cmeta data-mint-head name=\"twitter:image:width\" content=\"1200\">\u003cmeta data-mint-head name=\"twitter:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"msapplication-config\" content=\"/mintlify-assets/_mintlify/favicons/happenstance/lRTBz52T_gIZj_2l/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Happenstance\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#16a34a\">\u003clink data-mint-head rel=\"canonical\" href=\"https://developer.happenstance.ai/api-reference/get-search\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/api-reference/get-search.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://developer.happenstance.ai/#organization\",\"name\":\"Happenstance\",\"url\":\"https://developer.happenstance.ai\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/happenstance/YSbudQ8_lua9CNAo/logo/happenstance.png?fit=max\u0026auto=format\u0026n=YSbudQ8_lua9CNAo\u0026q=85\u0026s=a2c2c708eb248e6bea6607330505d0f9\"}},{\"@type\":\"WebSite\",\"@id\":\"https://developer.happenstance.ai#website\",\"name\":\"Happenstance\",\"url\":\"https://developer.happenstance.ai\",\"publisher\":{\"@id\":\"https://developer.happenstance.ai/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://developer.happenstance.ai/api-reference/get-search#webpage\",\"url\":\"https://developer.happenstance.ai/api-reference/get-search\",\"name\":\"Get Search\",\"description\":\"Get search results. Returns the status and results of a search request. Optionally provide a page_id to retrieve a specific page of results.\",\"dateModified\":\"2026-10-23T17:26:19.893Z\",\"isPartOf\":{\"@id\":\"https://developer.happenstance.ai#website\"},\"breadcrumb\":{\"@id\":\"https://developer.happenstance.ai/api-reference/get-search#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://developer.happenstance.ai/api-reference/get-search#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Connect\",\"item\":\"https://developer.happenstance.ai/mcp/chatgpt\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"API\",\"item\":\"https://developer.happenstance.ai/quickstart\"},{\"@type\":\"ListItem\",\"position\":3,\"name\":\"API Reference\",\"item\":\"https://developer.happenstance.ai/api-reference/create-search\"},{\"@type\":\"ListItem\",\"position\":4,\"name\":\"Get Search\",\"item\":\"https://developer.happenstance.ai/api-reference/get-search\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://developer.happenstance.ai/api-reference/get-search#apireference\",\"headline\":\"Get Search\",\"name\":\"Get Search\",\"description\":\"Get search results. Returns the status and results of a search request. Optionally provide a page_id to retrieve a specific page of results.\",\"url\":\"https://developer.happenstance.ai/api-reference/get-search\",\"mainEntityOfPage\":{\"@id\":\"https://developer.happenstance.ai/api-reference/get-search#webpage\"},\"dateModified\":\"2026-10-23T17:26:19.893Z\",\"publisher\":{\"@id\":\"https://developer.happenstance.ai/#organization\"},\"isPartOf\":{\"@id\":\"https://developer.happenstance.ai#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Happenstance\",\"creator\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","siteName":"Happenstance","nav":{"global":null,"groups":[{"group":"Connect","pages":[{"title":"ChatGPT","href":"/mcp/chatgpt"},{"title":"Claude","href":"/mcp/claude"},{"title":"Claude Code","href":"/mcp/claude-code"},{"title":"MCP","href":"/mcp/connect"},{"title":"CLI","href":"/cli/install"},{"title":"OpenClaw","href":"/mcp/openclaw"},{"group":"API","pages":[{"title":"Quickstart","href":"/quickstart"},{"title":"The Basics","href":"/api-reference/introduction"},{"title":"Changelog","href":"/changelog"},{"group":"API Reference","pages":[{"title":"Create Search","description":"Search for people within specified groups and/or within a user's connections.\n\nUse @mentions in your search query to filter results to a specific person's\nconnections (e.g., \"engineers @Jane Smith knows\"). Use the /v1/groups/{group_id}\nendpoint to look up member names for @mentions.\n\nRequires sufficient credits. Returns 402 Payment Required if not enough credits.\nReturns 429 Too Many Requests if you have 10 or more search requests currently running.","deprecated":null,"version":null,"openapi":"/openapi.json post /v1/search","href":"/api-reference/create-search"},{"title":"Get Search","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/search/{search_id}","href":"/api-reference/get-search"},{"title":"Find More Search","description":"Find more results for a search.\n\nCreates a new search that excludes all people from previous results in the search chain.\nUses the same query and settings as the original search.\nCan only be called on the parent search (searches without a parent_search_id).\n\nRequires sufficient credits. Returns 402 Payment Required if not enough credits.\nReturns 429 Too Many Requests if you have 10 or more search requests currently running.","deprecated":null,"version":null,"openapi":"/openapi.json post /v1/search/{search_id}/find-more","href":"/api-reference/find-more-search"},{"title":"Create Research","deprecated":null,"version":null,"openapi":"/openapi.json post /v1/research","href":"/api-reference/create-research"},{"title":"Get Research","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/research/{research_id}","href":"/api-reference/get-research"},{"title":"Get Current User Profile","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/users/me","href":"/api-reference/get-current-user-profile"},{"title":"Get Groups","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/groups","href":"/api-reference/get-groups"},{"title":"Get Group","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/groups/{group_id}","href":"/api-reference/get-group"},{"title":"Get Usage","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/usage","href":"/api-reference/get-usage"},{"title":"List Chats","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/chat","href":"/api-reference/list-chats"},{"title":"Create Chat","deprecated":null,"version":null,"openapi":"/openapi.json post /v1/chat","href":"/api-reference/create-chat"},{"title":"Get Chat","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/chat/{chat_id}","href":"/api-reference/get-chat"},{"title":"Send Chat Message","deprecated":null,"version":null,"openapi":"/openapi.json post /v1/chat/{chat_id}/messages","href":"/api-reference/send-chat-message"},{"title":"Get Chat Turn","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/chat/{chat_id}/turns/{turn_id}","href":"/api-reference/get-chat-turn"},{"title":"Cancel Chat Turn","deprecated":null,"version":null,"openapi":"/openapi.json post /v1/chat/{chat_id}/turns/{turn_id}/cancel","href":"/api-reference/cancel-chat-turn"},{"title":"Get Chat People","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/chat/{chat_id}/people","href":"/api-reference/get-chat-people"},{"title":"Get Chat Drafts","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/chat/{chat_id}/drafts","href":"/api-reference/get-chat-drafts"}]}]}]}]},"title":"Get Search - Happenstance","buildId":"dpl_DFJrtvUi8HS5F9nkooKuDJsuD5BM","deploymentId":"dpl_DFJrtvUi8HS5F9nkooKuDJsuD5BM","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-rfhihCWU.js","utils-BmH1XFxk.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-BcNsxPKB.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-BAES3tkd.js","snippetPresets-DCMQBKLP.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","ApiExamples-D6l_bzE9.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-BOktbnNh.js","shallow-BCs8SgM7.js","getApiPlaygroundDisplay-DEmW5bJB.js","CodeSnippet-CpZOpB9C.js","CodeSnippets-BOBDqibl.js","Page-D5fEM6aW.js","getPastedJson-DH2JBvmr.js","icon-BBJH-kKh.js","MethodPill-D2Sd5NLC.js","DuplicateIcon-CGgfL2qN.js","createIcon-BKudBBzi.js","DynamicMarkdown-85clUA0i.js","SectionHeading-D0JiMgDx.js","axios-vUo_bRtp.js","Markdown-Cfiy0xZO.js","clsx-rL8ZCCw4.js","lib--scc4DXi.js","lib-B8HbPgcC.js","html-void-elements-mCSPHezU.js","dist-aeztFa9U.js","katex-YMM-FMeD.js","marked.esm-CZWythHk.js","AssistantPageLink-BywkCr5C.js"]}