Returns the status of a lead-search run plus one server page of its delivered results (25 per page — pass ?page= for the rest). Poll it every few seconds while status is queued/processing/cancelling; a terminal status (completed/cancelled/failed) carries the final deliveredCount and creditsCharged. Results already delivered remain readable after the run finishes.
Workspace API key (loice_sk_ + 48 hex characters), created under Settings → API Keys. Sent as Authorization: Bearer loice_sk_…. Invalid, missing, or expired keys are rejected with 401 before any billable work happens.
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Loice","description":"Loice is the AI agent that finds verified leads: product guides, API reference and MCP set-up.","colors":{"primary":"#ff5a1f","light":"#ff7c46","dark":"#e14e15"},"logo":{"light":"https://mintcdn.com/loice-ai/BjcqR91eFdyMv2fQ/logo/loice-black.png?fit=max\u0026auto=format\u0026n=BjcqR91eFdyMv2fQ\u0026q=85\u0026s=bec1e804b7d2b4e6090aad41f5ec149e","dark":"https://mintcdn.com/loice-ai/BjcqR91eFdyMv2fQ/logo/loice-white.png?fit=max\u0026auto=format\u0026n=BjcqR91eFdyMv2fQ\u0026q=85\u0026s=047e3e67ec3049b5fd51a830b6d6ecf5","href":"https://app.loice.ai"},"favicon":"https://mintcdn.com/loice-ai/idv10iVf8OQiCSpv/favicon.svg?fit=max\u0026auto=format\u0026n=idv10iVf8OQiCSpv\u0026q=85\u0026s=a2b1dfa846aba2dd2708a97f2239882d","api":{"openapi":"openapi.json","playground":{"display":"interactive","proxy":false,"credentials":false},"examples":{"defaults":"required","languages":["curl","javascript","node","python"]}},"navbar":{"links":[{"href":"/connect-mcp","label":"Connect MCP"},{"href":"https://app.loice.ai/settings/account?tab=api","label":"API keys"}],"primary":{"type":"button","label":"Open Loice","href":"https://app.loice.ai"}},"footer":{"links":[{"header":"Loice","items":[{"label":"App","href":"https://app.loice.ai"},{"label":"Website","href":"https://loice.ai"},{"label":"Status","href":"https://status.loice.ai"}]}]},"contextual":{"options":["copy","view"],"display":"header"},"styling":{"latex":false},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"loice-ai","hasAudioNarration":false,"actualSubdomain":"loice-ai","customDomains":["docs.loice.ai"],"gitSource":{"type":"github","owner":"loice-ai","repo":"docs","deployBranch":"main","contentDirectory":"","isPrivate":true,"mountPath":"","label":""},"entitlements":{"AI_CHAT":{"status":"DISABLED"},"WEB_MCP":{"status":"DISABLED"},"NARRATION":{"status":"DISABLED"}},"buildId":"6af3055c2e595ebec461a1ad","clientVersion":"0.0.4094","searchFilterCounts":[{"language":"default","tag":"Documentation","count":24},{"language":"default","tag":"API reference","count":12},{"language":"default","tag":"API Reference","count":12},{"language":"default","tag":"API basics","count":8},{"language":"default","tag":"Product","count":7},{"language":"default","tag":"Account","count":4},{"language":"default","tag":"Get started","count":3},{"language":"default","tag":"Integrations","count":2}]},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":false,"enableContextualStarterQuestions":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":"custom-rbac-roles","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":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"rbac-expansion","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":"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":"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":"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":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"full-page-search","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":"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":"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":"turbopuffer-dual-write","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},{"name":"approve-review-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-metadata","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"sso-setup-deadline-banner","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-serve","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"live-agents","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[],"page":{"pagePath":"api-reference/poll-lead-search","slug":"/api-reference/poll-lead-search","pageMetadata":{"title":"Poll lead search","description":"Returns the status of a lead-search run plus one server page of its delivered results (25 per page — pass `?page=` for the rest). Poll it every few seconds while `status` is `queued`/`processing`/`cancelling`; a terminal `status` (`completed`/`cancelled`/`failed`) carries the final `deliveredCount` and `creditsCharged`. Results already delivered remain readable after the run finishes.\n\n#### Billing\n\nFree — this endpoint does not consume points.","deprecated":null,"version":null,"openapi":"/openapi.json get /api/v1/lead-search/runs/{runId}","href":"/api-reference/poll-lead-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 code: \"code\",\n h4: \"h4\",\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsxs(_Fragment, {\n children: [_jsxs(_components.p, {\n children: [\"Returns the status of a lead-search run plus one server page of its delivered results (25 per page — pass \", _jsx(_components.code, {\n children: \"?page=\"\n }), \" for the rest). Poll it every few seconds while \", _jsx(_components.code, {\n children: \"status\"\n }), \" is \", _jsx(_components.code, {\n children: \"queued\"\n }), \"/\", _jsx(_components.code, {\n children: \"processing\"\n }), \"/\", _jsx(_components.code, {\n children: \"cancelling\"\n }), \"; a terminal \", _jsx(_components.code, {\n children: \"status\"\n }), \" (\", _jsx(_components.code, {\n children: \"completed\"\n }), \"/\", _jsx(_components.code, {\n children: \"cancelled\"\n }), \"/\", _jsx(_components.code, {\n children: \"failed\"\n }), \") carries the final \", _jsx(_components.code, {\n children: \"deliveredCount\"\n }), \" and \", _jsx(_components.code, {\n children: \"creditsCharged\"\n }), \". Results already delivered remain readable after the run finishes.\"]\n }), \"\\n\", _jsx(_components.h4, {\n children: \"Billing\"\n }), \"\\n\", _jsx(_components.p, {\n children: \"Free — this endpoint does not consume points.\"\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":"Poll lead search","description":"Returns the status of a lead-search run plus one server page of its delivered results (25 per page — pass `?page=` for the rest). Poll it every few seconds while `status` is `queued`/`processing`/`cancelling`; a terminal `status` (`completed`/`cancelled`/`failed`) carries the final `deliveredCount` and `creditsCharged`. Results already delivered remain readable after the run finishes.\n\n#### Billing\n\nFree — this endpoint does not consume points.","deprecated":null,"version":null,"openapi":"/openapi.json get /api/v1/lead-search/runs/{runId}","href":"/api-reference/poll-lead-search","autogeneratedByOpenApi":true}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":[],"openApiReferenceData":{"operation":{"summary":"Poll lead search","description":"Returns the status of a lead-search run plus one server page of its delivered results (25 per page — pass `?page=` for the rest). Poll it every few seconds while `status` is `queued`/`processing`/`cancelling`; a terminal `status` (`completed`/`cancelled`/`failed`) carries the final `deliveredCount` and `creditsCharged`. Results already delivered remain readable after the run finishes.\n\n#### Billing\n\nFree — this endpoint does not consume points.","security":["7a022a61-62b7-46d5-9a4a-7ce59b7762f8"],"parameters":["d296d374-7fca-480c-aa92-8d351abe3956","17b86472-55e7-4216-afc9-9e4c76cdf8d1"],"responses":{"200":"7f7b6c04-e104-4a74-88c8-ef89ea54b24e","401":"d009b37d-4b09-42e2-85e5-3412fea46dbe","404":"9fc68da1-aafa-49eb-8858-d153b29beb51","405":"1c826784-0ef6-4bde-8da5-8af6730270e6","429":"5e0e6d47-bc86-4002-af4a-37740143db47","500":"8f6c207d-c990-4a4b-bb6e-f7b97dce1aef"},"method":"get","type":"path","servers":["695260fa-a90d-430f-9fda-0588978e186c"],"path":"/api/v1/lead-search/runs/{runId}","baseUrlOptions":["https://app.loice.ai"],"title":"Poll lead search","codeSamples":[],"requestExampleLanguages":["bash","javascript","node","python"],"requiredOnlyExamples":true,"requestExampleType":"generated","responseExampleType":"generated","disableProxy":true},"dependencies":{"parameters":{"d296d374-7fca-480c-aa92-8d351abe3956":{"schema":{"type":"string","description":"Run id from the `POST /api/v1/lead-search` response.","isRequired":true,"uniqueKey":"","typeLabel":"string"},"required":true,"description":"Run id from the `POST /api/v1/lead-search` response.","name":"runId","in":"path"},"17b86472-55e7-4216-afc9-9e4c76cdf8d1":{"schema":{"type":"integer","minimum":1,"description":"1-based results page (default 1); 25 items per page.","isRequired":false,"uniqueKey":"","typeLabel":"integer"},"required":false,"description":"1-based results page (default 1); 25 items per page.","name":"page","in":"query"}},"responses":{"7f7b6c04-e104-4a74-88c8-ef89ea54b24e":{"description":"The run’s current status and one page of its results.","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"run":{"type":"object","properties":{"id":{"type":"string","description":"Run id — poll it via `GET /api/v1/lead-search/runs/{runId}`.","isRequired":true,"uniqueKey":"data.run.id","typeLabel":"string"},"kind":{"type":"string","enum":["criteria","employees"],"description":"Always `criteria` on v1 (a criteria search). Employee Finder runs are not part of the public API and answer 404.","isRequired":true,"uniqueKey":"data.run.kind","typeLabel":"enum\u003cstring>"},"lookupMode":{"oneOf":[{"type":"string","enum":["domain","linkedin",null],"description":"Employee Finder runs only; null for a criteria run.","isRequired":true,"uniqueKey":"data.run.lookupMode.oneOf.0","typeLabel":"enum\u003cstring>"},{"type":"null","enum":["domain","linkedin",null],"description":"Employee Finder runs only; null for a criteria run.","isRequired":true,"uniqueKey":"data.run.lookupMode.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"data.run.lookupMode","typeLabel":"enum\u003cstring> | null"},"lookupInput":{"oneOf":[{"type":"string","description":"Employee Finder runs only; null for a criteria run.","isRequired":true,"uniqueKey":"data.run.lookupInput.oneOf.0","typeLabel":"string"},{"type":"null","description":"Employee Finder runs only; null for a criteria run.","isRequired":true,"uniqueKey":"data.run.lookupInput.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"data.run.lookupInput","typeLabel":"string | null"},"status":{"type":"string","enum":["queued","processing","cancelling","completed","cancelled","failed"],"description":"Lifecycle state. `queued`/`processing`/`cancelling` are active — keep polling; `completed`/`cancelled`/`failed` are terminal.","isRequired":true,"uniqueKey":"data.run.status","typeLabel":"enum\u003cstring>"},"requestedCount":{"type":"integer","description":"Leads requested for this run.","isRequired":true,"uniqueKey":"data.run.requestedCount","typeLabel":"integer"},"deliveredCount":{"type":"integer","description":"Distinct leads delivered so far — the only number billed.","isRequired":true,"uniqueKey":"data.run.deliveredCount","typeLabel":"integer"},"sourceTotalElements":{"oneOf":[{"type":"integer","description":"Total results the source reports for these criteria (set from the first fetched page); the browsable window is capped at 100 pages.","isRequired":true,"uniqueKey":"data.run.sourceTotalElements.oneOf.0","typeLabel":"integer"},{"type":"null","description":"Total results the source reports for these criteria (set from the first fetched page); the browsable window is capped at 100 pages.","isRequired":true,"uniqueKey":"data.run.sourceTotalElements.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"data.run.sourceTotalElements","typeLabel":"integer | null"},"sourceTotalPages":{"oneOf":[{"type":"integer","description":"Source-reported page count (capped at 100 by the source).","isRequired":true,"uniqueKey":"data.run.sourceTotalPages.oneOf.0","typeLabel":"integer"},{"type":"null","description":"Source-reported page count (capped at 100 by the source).","isRequired":true,"uniqueKey":"data.run.sourceTotalPages.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"data.run.sourceTotalPages","typeLabel":"integer | null"},"sourceExhausted":{"type":"boolean","description":"True when the source ran out of matches before `requestedCount`.","isRequired":true,"uniqueKey":"data.run.sourceExhausted","typeLabel":"boolean"},"sourcePages":{"type":"array","items":{"type":"object","properties":{"page":{"type":"integer","description":"Source page number.","isRequired":true,"uniqueKey":"data.run.sourcePages.items.[INDEX].page","typeLabel":"integer"},"sourceRows":{"type":"integer","description":"Rows the source returned for this page.","isRequired":true,"uniqueKey":"data.run.sourcePages.items.[INDEX].sourceRows","typeLabel":"integer"},"delivered":{"type":"integer","description":"Rows this run delivered from it (billed).","isRequired":true,"uniqueKey":"data.run.sourcePages.items.[INDEX].delivered","typeLabel":"integer"},"notAtCompany":{"type":"integer","description":"Rows whose stated employer did not match the company filter.","isRequired":true,"uniqueKey":"data.run.sourcePages.items.[INDEX].notAtCompany","typeLabel":"integer"},"titleNotStated":{"type":"integer","description":"Searches with a job-title filter: rows with no current position that states that title (for an employee search, no position at the company that states it). The source matches titles loosely. 0 otherwise.","isRequired":true,"uniqueKey":"data.run.sourcePages.items.[INDEX].titleNotStated","typeLabel":"integer"},"duplicates":{"type":"integer","description":"Rows already delivered on this page or by any earlier run of the chain.","isRequired":true,"uniqueKey":"data.run.sourcePages.items.[INDEX].duplicates","typeLabel":"integer"},"doNotContact":{"type":"integer","description":"Rows on the workspace’s do-not-contact list.","isRequired":true,"uniqueKey":"data.run.sourcePages.items.[INDEX].doNotContact","typeLabel":"integer"},"beyondRequested":{"type":"integer","description":"Rows left once the run had `requestedCount` leads.","isRequired":true,"uniqueKey":"data.run.sourcePages.items.[INDEX].beyondRequested","typeLabel":"integer"}},"required":["page","sourceRows","delivered","notAtCompany","titleNotStated","duplicates","doNotContact","beyondRequested"],"uniqueKey":"data.run.sourcePages.items.[INDEX]","typeLabel":"object"},"description":"Per source page this run fetched, counts only: what the source returned and why rows were not delivered. `sourceRows` is `delivered` plus the five reasons. Empty for runs created before this field existed.","isRequired":true,"uniqueKey":"data.run.sourcePages","typeLabel":"object[]"},"continuedFromId":{"oneOf":[{"type":"string","description":"Id of the run this one continues, when it is a continuation.","isRequired":true,"uniqueKey":"data.run.continuedFromId.oneOf.0","typeLabel":"string"},{"type":"null","description":"Id of the run this one continues, when it is a continuation.","isRequired":true,"uniqueKey":"data.run.continuedFromId.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"data.run.continuedFromId","typeLabel":"string | null"},"unitCost":{"type":"integer","description":"Points per delivered lead.","isRequired":true,"uniqueKey":"data.run.unitCost","typeLabel":"integer"},"maxCost":{"type":"integer","description":"Worst-case cost disclosed up front: `unitCost × requestedCount` (reserved at creation; the unused remainder frees at finalize).","isRequired":true,"uniqueKey":"data.run.maxCost","typeLabel":"integer"},"creditsCharged":{"oneOf":[{"type":"integer","description":"Points actually debited — set at finalize to `deliveredCount × unitCost`, null while the run is active. An empty run charges 0.","isRequired":true,"uniqueKey":"data.run.creditsCharged.oneOf.0","typeLabel":"integer"},{"type":"null","description":"Points actually debited — set at finalize to `deliveredCount × unitCost`, null while the run is active. An empty run charges 0.","isRequired":true,"uniqueKey":"data.run.creditsCharged.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"data.run.creditsCharged","typeLabel":"integer | null"},"error":{"oneOf":[{"type":"string","description":"Failure reason key when `status` is `failed` (e.g. `search-failed`).","isRequired":true,"uniqueKey":"data.run.error.oneOf.0","typeLabel":"string"},{"type":"null","description":"Failure reason key when `status` is `failed` (e.g. `search-failed`).","isRequired":true,"uniqueKey":"data.run.error.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"data.run.error","typeLabel":"string | null"},"criteria":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string","uniqueKey":"data.run.criteria.additionalProperties.items.[INDEX]","typeLabel":"string"},"uniqueKey":"data.run.criteria.additionalProperties","typeLabel":"string[]"},"description":"Echo of the normalized search criteria the run executes.","isRequired":true,"uniqueKey":"data.run.criteria","typeLabel":"object"},"createdAt":{"type":"string","description":"ISO timestamp the run was created.","isRequired":true,"uniqueKey":"data.run.createdAt","typeLabel":"string"},"startedAt":{"oneOf":[{"type":"string","description":"ISO timestamp processing began, null while queued.","isRequired":true,"uniqueKey":"data.run.startedAt.oneOf.0","typeLabel":"string"},{"type":"null","description":"ISO timestamp processing began, null while queued.","isRequired":true,"uniqueKey":"data.run.startedAt.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"data.run.startedAt","typeLabel":"string | null"},"finishedAt":{"oneOf":[{"type":"string","description":"ISO timestamp the run reached a terminal state.","isRequired":true,"uniqueKey":"data.run.finishedAt.oneOf.0","typeLabel":"string"},{"type":"null","description":"ISO timestamp the run reached a terminal state.","isRequired":true,"uniqueKey":"data.run.finishedAt.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"data.run.finishedAt","typeLabel":"string | null"}},"required":["id","kind","lookupMode","lookupInput","status","requestedCount","deliveredCount","sourceTotalElements","sourceTotalPages","sourceExhausted","sourcePages","continuedFromId","unitCost","maxCost","creditsCharged","error","criteria","createdAt","startedAt","finishedAt"],"isRequired":true,"uniqueKey":"data.run","typeLabel":"object"},"results":{"type":"object","properties":{"page":{"type":"integer","description":"The 1-based results page served.","isRequired":true,"uniqueKey":"data.results.page","typeLabel":"integer"},"pageSize":{"type":"integer","description":"Results per page (25).","isRequired":true,"uniqueKey":"data.results.pageSize","typeLabel":"integer"},"totalDelivered":{"type":"integer","description":"Total delivered results across all pages.","isRequired":true,"uniqueKey":"data.results.totalDelivered","typeLabel":"integer"},"items":{"type":"array","items":{"oneOf":[{"type":"object","required":["id","position","sourcePage","name","title","company","location","industry","linkedinUrl","publicIdentifier","photoImageUrl","revealedEmail","revealedEmailStatus","revealedEarlier","companyProfile","person"],"properties":{"id":{"type":"string","description":"Stable id of this delivered result row.","isRequired":true,"uniqueKey":"data.results.\\items.items.[INDEX].oneOf.0.id","typeLabel":"string"},"position":{"type":"integer","description":"0-based delivery position within the run.","isRequired":true,"uniqueKey":"data.results.\\items.items.[INDEX].oneOf.0.position","typeLabel":"integer"},"sourcePage":{"oneOf":[{"type":"integer","description":"Which source page delivered this lead (as-if-local paging).","isRequired":true,"uniqueKey":"data.results.\\items.items.[INDEX].oneOf.0.sourcePage.oneOf.0","typeLabel":"integer"},{"type":"null","description":"Which source page delivered this lead (as-if-local paging).","isRequired":true,"uniqueKey":"data.results.\\items.items.[INDEX].oneOf.0.sourcePage.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"data.results.\\items.items.[INDEX].oneOf.0.sourcePage","typeLabel":"integer | null"},"name":{"oneOf":[{"type":"string","description":"Deprecated — use person.fullName. Display name as the source shows it.","isRequired":true,"uniqueKey":"data.results.\\items.items.[INDEX].oneOf.0.name.oneOf.0","typeLabel":"string"},{"type":"null","description":"Deprecated — use person.fullName. Display name as the source shows it.","isRequired":true,"uniqueKey":"data.results.\\items.items.[INDEX].oneOf.0.name.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"data.results.\\items.items.[INDEX].oneOf.0.name","typeLabel":"string | null"},"title":{"oneOf":[{"type":"string","description":"Deprecated — use person.title. Current title, when stated.","isRequired":true,"uniqueKey":"data.results.\\items.items.[INDEX].oneOf.0.title.oneOf.0","typeLabel":"string"},{"type":"null","description":"Deprecated — use person.title. Current title, when stated.","isRequired":true,"uniqueKey":"data.results.\\items.items.[INDEX].oneOf.0.title.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"data.results.\\items.items.[INDEX].oneOf.0.title","typeLabel":"string | null"},"company":{"oneOf":[{"type":"string","description":"Deprecated — use companyProfile.name. Current employer as the source states it.","isRequired":true,"uniqueKey":"data.results.\\items.items.[INDEX].oneOf.0.company.oneOf.0","typeLabel":"string"},{"type":"null","description":"Deprecated — use companyProfile.name. Current employer as the source states it.","isRequired":true,"uniqueKey":"data.results.\\items.items.[INDEX].oneOf.0.company.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"data.results.\\items.items.[INDEX].oneOf.0.company","typeLabel":"string | null"},"location":{"oneOf":[{"type":"string","description":"Deprecated — use person.location.","isRequired":true,"uniqueKey":"data.results.\\items.items.[INDEX].oneOf.0.location.oneOf.0","typeLabel":"string"},{"type":"null","description":"Deprecated — use person.location.","isRequired":true,"uniqueKey":"data.results.\\items.items.[INDEX].oneOf.0.location.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"data.results.\\items.items.[INDEX].oneOf.0.location","typeLabel":"string | null"},"industry":{"oneOf":[{"type":"string","description":"Deprecated — use companyProfile.industry. Industry annotation, null until/unless annotated.","isRequired":true,"uniqueKey":"data.results.\\items.items.[INDEX].oneOf.0.industry.oneOf.0","typeLabel":"string"},{"type":"null","description":"Deprecated — use companyProfile.industry. Industry annotation, null until/unless annotated.","isRequired":true,"uniqueKey":"data.results.\\items.items.[INDEX].oneOf.0.industry.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"data.results.\\items.items.[INDEX].oneOf.0.industry","typeLabel":"string | null"},"linkedinUrl":{"type":"string","description":"Profile URL: the public profile URL when known, else the member-ID URL the source stated — feed it into `POST /api/v1/find` (linkedin mode) for a verified email.","isRequired":true,"uniqueKey":"data.results.\\items.items.[INDEX].oneOf.0.linkedinUrl","typeLabel":"string"},"publicIdentifier":{"oneOf":[{"type":"string","description":"Deprecated — use person.linkedinUrl. The public profile slug, when known.","isRequired":true,"uniqueKey":"data.results.\\items.items.[INDEX].oneOf.0.publicIdentifier.oneOf.0","typeLabel":"string"},{"type":"null","description":"Deprecated — use person.linkedinUrl. The public profile slug, when known.","isRequired":true,"uniqueKey":"data.results.\\items.items.[INDEX].oneOf.0.publicIdentifier.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"data.results.\\items.items.[INDEX].oneOf.0.publicIdentifier","typeLabel":"string | null"},"photoImageUrl":{"oneOf":[{"type":"string","description":"Deprecated — use person.avatarUrl. Owned photo address, when mirrored.","isRequired":true,"uniqueKey":"data.results.\\items.items.[INDEX].oneOf.0.photoImageUrl.oneOf.0","typeLabel":"string"},{"type":"null","description":"Deprecated — use person.avatarUrl. Owned photo address, when mirrored.","isRequired":true,"uniqueKey":"data.results.\\items.items.[INDEX].oneOf.0.photoImageUrl.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"data.results.\\items.items.[INDEX].oneOf.0.photoImageUrl","typeLabel":"string | null"},"revealedEmail":{"oneOf":[{"type":"string","description":"Email revealed for this lead, when one has been.","isRequired":true,"uniqueKey":"data.results.\\items.items.[INDEX].oneOf.0.revealedEmail.oneOf.0","typeLabel":"string"},{"type":"null","description":"Email revealed for this lead, when one has been.","isRequired":true,"uniqueKey":"data.results.\\items.items.[INDEX].oneOf.0.revealedEmail.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"data.results.\\items.items.[INDEX].oneOf.0.revealedEmail","typeLabel":"string | null"},"revealedEmailStatus":{"oneOf":[{"type":"string","isRequired":true,"uniqueKey":"data.results.\\items.items.[INDEX].oneOf.0.revealedEmailStatus.oneOf.0","typeLabel":"string"},{"type":"null","isRequired":true,"uniqueKey":"data.results.\\items.items.[INDEX].oneOf.0.revealedEmailStatus.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"data.results.\\items.items.[INDEX].oneOf.0.revealedEmailStatus","typeLabel":"string | null"},"revealedEarlier":{"type":"boolean","description":"True when `revealedEmail` / `revealedEmailStatus` is an answer your team already paid for on another result (another run, the other profile URL form, or another surface) and is shown again at no charge. A found address is shown only while its verification still confirms it; a not-found only within its shorter freshness.","isRequired":true,"uniqueKey":"data.results.\\items.items.[INDEX].oneOf.0.revealedEarlier","typeLabel":"boolean"},"companyProfile":{"type":"object","description":"The canonical Company for this lead — the same schema `POST /api/v1/company` returns. Built from our company record when we hold a fresh one, otherwise from what the result observed (then `confirmedAt` is null and unobserved keys are null).","required":["name","linkedinUrl","tagline","description","industry","employeeBand","employeeCount","followerCount","websiteUrl","websiteDomain","headquarters","hqLocality","hqRegion","hqCountry","foundedYear","companyType","specialties","logoUrl","logoImageUrl","phone","email","xUrl","facebookUrl","instagramUrl","youtubeUrl","confirmedAt"],"properties":{"name":{"oneOf":[{"type":"string","isRequired":true,"uniqueKey":"data.results.\\items.items.[INDEX].oneOf.0.companyProfile.name.oneOf.0","typeLabel":"string"},{"type":"null","isRequired":true,"uniqueKey":"data.results.\\items.items.[INDEX].oneOf.0.companyProfile.name.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"data.results.\\items.items.[INDEX].oneOf.0.companyProfile.name","typeLabel":"string | null"},"linkedinUrl":{"oneOf":[{"type":"string","isRequired":true,"uniqueKey":"data.results.\\items.items.[INDEX].oneOf.0.companyProfile.linkedinUrl.oneOf.0","typeLabel":"string"},{"type":"null","isRequired":true,"uniqueKey":"data.results.\\items.items.[INDEX].oneOf.0.companyProfile.linkedinUrl.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"data.results.\\items.items.[INDEX].oneOf.0.companyProfile.linkedinUrl","typeLabel":"string | null"},"tagline":{"oneOf":[{"type":"string","isRequired":true,"uniqueKey":"data.results.\\items.items.[INDEX].oneOf.0.companyProfile.tagline.oneOf.0","typeLabel":"string"},{"type":"null","isRequired":true,"uniqueKey":"data.results.\\items.items.[INDEX].oneOf.0.companyProfile.tagline.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"data.results.\\items.items.[INDEX].oneOf.0.companyProfile.tagline","typeLabel":"string | null"},"description":{"oneOf":[{"type":"string","isRequired":true,"uniqueKey":"data.results.\\items.items.[INDEX].oneOf.0.companyProfile.description.oneOf.0","typeLabel":"string"},{"type":"null","isRequired":true,"uniqueKey":"data.results.\\items.items.[INDEX].oneOf.0.companyProfile.description.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"data.results.\\items.items.[INDEX].oneOf.0.companyProfile.description","typeLabel":"string | null"},"industry":{"oneOf":[{"type":"string","isRequired":true,"uniqueKey":"data.results.\\items.items.[INDEX].oneOf.0.companyProfile.industry.oneOf.0","typeLabel":"string"},{"type":"null","isRequired":true,"uniqueKey":"data.results.\\items.items.[INDEX].oneOf.0.companyProfile.industry.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"data.results.\\items.items.[INDEX].oneOf.0.companyProfile.industry","typeLabel":"string | null"},"employeeBand":{"oneOf":[{"type":"string","description":"Size band as the source displays it.","isRequired":true,"uniqueKey":"data.results.\\items.items.[INDEX].oneOf.0.companyProfile.employeeBand.oneOf.0","typeLabel":"string"},{"type":"null","description":"Size band as the source displays it.","isRequired":true,"uniqueKey":"data.results.\\items.items.[INDEX].oneOf.0.companyProfile.employeeBand.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"data.results.\\items.items.[INDEX].oneOf.0.companyProfile.employeeBand","typeLabel":"string | null"},"employeeCount":{"oneOf":[{"type":"integer","description":"Exact headcount, when stated.","isRequired":true,"uniqueKey":"data.results.\\items.items.[INDEX].oneOf.0.companyProfile.employeeCount.oneOf.0","typeLabel":"integer"},{"type":"null","description":"Exact headcount, when stated.","isRequired":true,"uniqueKey":"data.results.\\items.items.[INDEX].oneOf.0.companyProfile.employeeCount.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"data.results.\\items.items.[INDEX].oneOf.0.companyProfile.employeeCount","typeLabel":"integer | null"},"followerCount":{"oneOf":[{"type":"integer","isRequired":true,"uniqueKey":"data.results.\\items.items.[INDEX].oneOf.0.companyProfile.followerCount.oneOf.0","typeLabel":"integer"},{"type":"null","isRequired":true,"uniqueKey":"data.results.\\items.items.[INDEX].oneOf.0.companyProfile.followerCount.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"data.results.\\items.items.[INDEX].oneOf.0.companyProfile.followerCount","typeLabel":"integer | null"},"websiteUrl":{"oneOf":[{"type":"string","isRequired":true,"uniqueKey":"data.results.\\items.items.[INDEX].oneOf.0.companyProfile.websiteUrl.oneOf.0","typeLabel":"string"},{"type":"null","isRequired":true,"uniqueKey":"data.results.\\items.items.[INDEX].oneOf.0.companyProfile.websiteUrl.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"data.results.\\items.items.[INDEX].oneOf.0.companyProfile.websiteUrl","typeLabel":"string | null"},"websiteDomain":{"oneOf":[{"type":"string","isRequired":true,"uniqueKey":"data.results.\\items.items.[INDEX].oneOf.0.companyProfile.websiteDomain.oneOf.0","typeLabel":"string"},{"type":"null","isRequired":true,"uniqueKey":"data.results.\\items.items.[INDEX].oneOf.0.companyProfile.websiteDomain.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"data.results.\\items.items.[INDEX].oneOf.0.companyProfile.websiteDomain","typeLabel":"string | null"},"headquarters":{"oneOf":[{"type":"string","isRequired":true,"uniqueKey":"data.results.\\items.items.[INDEX].oneOf.0.companyProfile.headquarters.oneOf.0","typeLabel":"string"},{"type":"null","isRequired":true,"uniqueKey":"data.results.\\items.items.[INDEX].oneOf.0.companyProfile.headquarters.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"data.results.\\items.items.[INDEX].oneOf.0.companyProfile.headquarters","typeLabel":"string | null"},"hqLocality":{"oneOf":[{"type":"string","isRequired":true,"uniqueKey":"data.results.\\items.items.[INDEX].oneOf.0.companyProfile.hqLocality.oneOf.0","typeLabel":"string"},{"type":"null","isRequired":true,"uniqueKey":"data.results.\\items.items.[INDEX].oneOf.0.companyProfile.hqLocality.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"data.results.\\items.items.[INDEX].oneOf.0.companyProfile.hqLocality","typeLabel":"string | null"},"hqRegion":{"oneOf":[{"type":"string","isRequired":true,"uniqueKey":"data.results.\\items.items.[INDEX].oneOf.0.companyProfile.hqRegion.oneOf.0","typeLabel":"string"},{"type":"null","isRequired":true,"uniqueKey":"data.results.\\items.items.[INDEX].oneOf.0.companyProfile.hqRegion.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"data.results.\\items.items.[INDEX].oneOf.0.companyProfile.hqRegion","typeLabel":"string | null"},"hqCountry":{"oneOf":[{"type":"string","isRequired":true,"uniqueKey":"data.results.\\items.items.[INDEX].oneOf.0.companyProfile.hqCountry.oneOf.0","typeLabel":"string"},{"type":"null","isRequired":true,"uniqueKey":"data.results.\\items.items.[INDEX].oneOf.0.companyProfile.hqCountry.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"data.results.\\items.items.[INDEX].oneOf.0.companyProfile.hqCountry","typeLabel":"string | null"},"foundedYear":{"oneOf":[{"type":"integer","isRequired":true,"uniqueKey":"data.results.\\items.items.[INDEX].oneOf.0.companyProfile.foundedYear.oneOf.0","typeLabel":"integer"},{"type":"null","isRequired":true,"uniqueKey":"data.results.\\items.items.[INDEX].oneOf.0.companyProfile.foundedYear.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"data.results.\\items.items.[INDEX].oneOf.0.companyProfile.foundedYear","typeLabel":"integer | null"},"companyType":{"oneOf":[{"type":"string","isRequired":true,"uniqueKey":"data.results.\\items.items.[INDEX].oneOf.0.companyProfile.companyType.oneOf.0","typeLabel":"string"},{"type":"null","isRequired":true,"uniqueKey":"data.results.\\items.items.[INDEX].oneOf.0.companyProfile.companyType.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"data.results.\\items.items.[INDEX].oneOf.0.companyProfile.companyType","typeLabel":"string | null"},"specialties":{"type":"array","items":{"type":"string","uniqueKey":"data.results.\\items.items.[INDEX].oneOf.0.companyProfile.specialties.items.[INDEX]","typeLabel":"string"},"isRequired":true,"uniqueKey":"data.results.\\items.items.[INDEX].oneOf.0.companyProfile.specialties","typeLabel":"string[]"},"logoUrl":{"type":"null","description":"Always null. Reserved so the shape stays stable: a provider image address is never returned (it is signed, expires, and discloses the viewer). Render `logoImageUrl`.","isRequired":true,"uniqueKey":"data.results.\\items.items.[INDEX].oneOf.0.companyProfile.logoUrl","typeLabel":"null"},"logoImageUrl":{"oneOf":[{"type":"string","description":"Our own copy of the logo (`/api/images/\u003cid>`, same authentication as this API). Null when the source states no logo or no copy is held.","isRequired":true,"uniqueKey":"data.results.\\items.items.[INDEX].oneOf.0.companyProfile.logoImageUrl.oneOf.0","typeLabel":"string"},{"type":"null","description":"Our own copy of the logo (`/api/images/\u003cid>`, same authentication as this API). Null when the source states no logo or no copy is held.","isRequired":true,"uniqueKey":"data.results.\\items.items.[INDEX].oneOf.0.companyProfile.logoImageUrl.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"data.results.\\items.items.[INDEX].oneOf.0.companyProfile.logoImageUrl","typeLabel":"string | null"},"phone":{"oneOf":[{"type":"string","description":"The company phone. Always null until phone verification is available; reserved so the shape does not change when it is.","isRequired":true,"uniqueKey":"data.results.\\items.items.[INDEX].oneOf.0.companyProfile.phone.oneOf.0","typeLabel":"string"},{"type":"null","description":"The company phone. Always null until phone verification is available; reserved so the shape does not change when it is.","isRequired":true,"uniqueKey":"data.results.\\items.items.[INDEX].oneOf.0.companyProfile.phone.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"data.results.\\items.items.[INDEX].oneOf.0.companyProfile.phone","typeLabel":"string | null"},"email":{"oneOf":[{"type":"string","description":"The company's general contact email: only a generic role address (info@, sales@, …) on the company's own domain, stated by the company, that passed email verification. Null when none is stated or it did not verify. Never a personal address.","isRequired":true,"uniqueKey":"data.results.\\items.items.[INDEX].oneOf.0.companyProfile.email.oneOf.0","typeLabel":"string"},{"type":"null","description":"The company's general contact email: only a generic role address (info@, sales@, …) on the company's own domain, stated by the company, that passed email verification. Null when none is stated or it did not verify. Never a personal address.","isRequired":true,"uniqueKey":"data.results.\\items.items.[INDEX].oneOf.0.companyProfile.email.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"data.results.\\items.items.[INDEX].oneOf.0.companyProfile.email","typeLabel":"string | null"},"xUrl":{"oneOf":[{"type":"string","description":"X (Twitter) profile the company states as its own, as `https://x.com/\u003chandle>`. Null when not stated; never constructed from the name.","isRequired":true,"uniqueKey":"data.results.\\items.items.[INDEX].oneOf.0.companyProfile.xUrl.oneOf.0","typeLabel":"string"},{"type":"null","description":"X (Twitter) profile the company states as its own, as `https://x.com/\u003chandle>`. Null when not stated; never constructed from the name.","isRequired":true,"uniqueKey":"data.results.\\items.items.[INDEX].oneOf.0.companyProfile.xUrl.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"data.results.\\items.items.[INDEX].oneOf.0.companyProfile.xUrl","typeLabel":"string | null"},"facebookUrl":{"oneOf":[{"type":"string","description":"Facebook page the company states as its own, as `https://www.facebook.com/\u003cpage>`. Null when not stated.","isRequired":true,"uniqueKey":"data.results.\\items.items.[INDEX].oneOf.0.companyProfile.facebookUrl.oneOf.0","typeLabel":"string"},{"type":"null","description":"Facebook page the company states as its own, as `https://www.facebook.com/\u003cpage>`. Null when not stated.","isRequired":true,"uniqueKey":"data.results.\\items.items.[INDEX].oneOf.0.companyProfile.facebookUrl.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"data.results.\\items.items.[INDEX].oneOf.0.companyProfile.facebookUrl","typeLabel":"string | null"},"instagramUrl":{"oneOf":[{"type":"string","description":"Instagram profile the company states as its own, as `https://www.instagram.com/\u003cuser>`. Null when not stated.","isRequired":true,"uniqueKey":"data.results.\\items.items.[INDEX].oneOf.0.companyProfile.instagramUrl.oneOf.0","typeLabel":"string"},{"type":"null","description":"Instagram profile the company states as its own, as `https://www.instagram.com/\u003cuser>`. Null when not stated.","isRequired":true,"uniqueKey":"data.results.\\items.items.[INDEX].oneOf.0.companyProfile.instagramUrl.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"data.results.\\items.items.[INDEX].oneOf.0.companyProfile.instagramUrl","typeLabel":"string | null"},"youtubeUrl":{"oneOf":[{"type":"string","description":"YouTube channel the company states as its own, as `https://www.youtube.com/` followed by `@handle`, `channel/…`, `c/…` or `user/…`. Null when not stated.","isRequired":true,"uniqueKey":"data.results.\\items.items.[INDEX].oneOf.0.companyProfile.youtubeUrl.oneOf.0","typeLabel":"string"},{"type":"null","description":"YouTube channel the company states as its own, as `https://www.youtube.com/` followed by `@handle`, `channel/…`, `c/…` or `user/…`. Null when not stated.","isRequired":true,"uniqueKey":"data.results.\\items.items.[INDEX].oneOf.0.companyProfile.youtubeUrl.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"data.results.\\items.items.[INDEX].oneOf.0.companyProfile.youtubeUrl","typeLabel":"string | null"},"confirmedAt":{"oneOf":[{"type":"string","description":"When this record was last confirmed against the source. Null when the Company is built only from what a lead or list row observed (no company record).","isRequired":true,"uniqueKey":"data.results.\\items.items.[INDEX].oneOf.0.companyProfile.confirmedAt.oneOf.0","typeLabel":"string"},{"type":"null","description":"When this record was last confirmed against the source. Null when the Company is built only from what a lead or list row observed (no company record).","isRequired":true,"uniqueKey":"data.results.\\items.items.[INDEX].oneOf.0.companyProfile.confirmedAt.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"data.results.\\items.items.[INDEX].oneOf.0.companyProfile.confirmedAt","typeLabel":"string | null"}},"isRequired":true,"uniqueKey":"data.results.\\items.items.[INDEX].oneOf.0.companyProfile","typeLabel":"object"},"person":{"oneOf":[{"type":"object","description":"THE canonical Person for this lead. `person.company` is the same object as `companyProfile`.","required":["avatarUrl","fullName","firstName","lastName","linkedinUrl","xUrl","facebookUrl","instagramUrl","telegramUrl","title","about","company","companyName","companyLinkedinUrl","companyLogoUrl","domain","industry","location","department","seniority","yearsOfExperience","employment","education","historyStatus"],"properties":{"avatarUrl":{"oneOf":[{"type":"string","description":"Owned image address (`/api/images/\u003cid>`, authenticated). Null ⇒ render initials.","isRequired":true,"uniqueKey":"data.results.\\items.items.[INDEX].oneOf.0.person.oneOf.0.avatarUrl.oneOf.0","typeLabel":"string"},{"type":"null","description":"Owned image address (`/api/images/\u003cid>`, authenticated). Null ⇒ render initials.","isRequired":true,"uniqueKey":"data.results.\\items.items.[INDEX].oneOf.0.person.oneOf.0.avatarUrl.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"data.results.\\items.items.[INDEX].oneOf.0.person.oneOf.0.avatarUrl","typeLabel":"string | null"},"fullName":{"oneOf":[{"type":"string","description":"The source's own statement of the name.","isRequired":true,"uniqueKey":"data.results.\\items.items.[INDEX].oneOf.0.person.oneOf.0.fullName.oneOf.0","typeLabel":"string"},{"type":"null","description":"The source's own statement of the name.","isRequired":true,"uniqueKey":"data.results.\\items.items.[INDEX].oneOf.0.person.oneOf.0.fullName.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"data.results.\\items.items.[INDEX].oneOf.0.person.oneOf.0.fullName","typeLabel":"string | null"},"firstName":{"oneOf":[{"type":"string","description":"The first name, as the source stated it when it stated two names; otherwise `fullName` split at read time (as written). Null when the name does not split.","isRequired":true,"uniqueKey":"data.results.\\items.items.[INDEX].oneOf.0.person.oneOf.0.firstName.oneOf.0","typeLabel":"string"},{"type":"null","description":"The first name, as the source stated it when it stated two names; otherwise `fullName` split at read time (as written). Null when the name does not split.","isRequired":true,"uniqueKey":"data.results.\\items.items.[INDEX].oneOf.0.person.oneOf.0.firstName.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"data.results.\\items.items.[INDEX].oneOf.0.person.oneOf.0.firstName","typeLabel":"string | null"},"lastName":{"oneOf":[{"type":"string","description":"The last name (the whole surname, e.g. \"van Beethoven\"), on the same rule as `firstName`.","isRequired":true,"uniqueKey":"data.results.\\items.items.[INDEX].oneOf.0.person.oneOf.0.lastName.oneOf.0","typeLabel":"string"},{"type":"null","description":"The last name (the whole surname, e.g. \"van Beethoven\"), on the same rule as `firstName`.","isRequired":true,"uniqueKey":"data.results.\\items.items.[INDEX].oneOf.0.person.oneOf.0.lastName.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"data.results.\\items.items.[INDEX].oneOf.0.person.oneOf.0.lastName","typeLabel":"string | null"},"linkedinUrl":{"type":"string","description":"Canonical profile URL — the identity. Never null. The public profile URL (`https://www.linkedin.com/in/\u003cpublic-name>`) when known, else the member-ID URL.","isRequired":true,"uniqueKey":"data.results.\\items.items.[INDEX].oneOf.0.person.oneOf.0.linkedinUrl","typeLabel":"string"},"xUrl":{"oneOf":[{"type":"string","description":"The person's own X (Twitter) profile as a source stated it, as `https://x.com/\u003chandle>`. Null when no source stated one — never derived from a name, an address or another site's username.","isRequired":true,"uniqueKey":"data.results.\\items.items.[INDEX].oneOf.0.person.oneOf.0.xUrl.oneOf.0","typeLabel":"string"},{"type":"null","description":"The person's own X (Twitter) profile as a source stated it, as `https://x.com/\u003chandle>`. Null when no source stated one — never derived from a name, an address or another site's username.","isRequired":true,"uniqueKey":"data.results.\\items.items.[INDEX].oneOf.0.person.oneOf.0.xUrl.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"data.results.\\items.items.[INDEX].oneOf.0.person.oneOf.0.xUrl","typeLabel":"string | null"},"facebookUrl":{"oneOf":[{"type":"string","description":"The person's own Facebook profile as a source stated it (`https://www.facebook.com/\u003cname>` or `…/profile.php?id=\u003cdigits>`). Null when unstated.","isRequired":true,"uniqueKey":"data.results.\\items.items.[INDEX].oneOf.0.person.oneOf.0.facebookUrl.oneOf.0","typeLabel":"string"},{"type":"null","description":"The person's own Facebook profile as a source stated it (`https://www.facebook.com/\u003cname>` or `…/profile.php?id=\u003cdigits>`). Null when unstated.","isRequired":true,"uniqueKey":"data.results.\\items.items.[INDEX].oneOf.0.person.oneOf.0.facebookUrl.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"data.results.\\items.items.[INDEX].oneOf.0.person.oneOf.0.facebookUrl","typeLabel":"string | null"},"instagramUrl":{"oneOf":[{"type":"string","description":"The person's own Instagram profile as a source stated it, as `https://www.instagram.com/\u003cuser>`. Null when unstated.","isRequired":true,"uniqueKey":"data.results.\\items.items.[INDEX].oneOf.0.person.oneOf.0.instagramUrl.oneOf.0","typeLabel":"string"},{"type":"null","description":"The person's own Instagram profile as a source stated it, as `https://www.instagram.com/\u003cuser>`. Null when unstated.","isRequired":true,"uniqueKey":"data.results.\\items.items.[INDEX].oneOf.0.person.oneOf.0.instagramUrl.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"data.results.\\items.items.[INDEX].oneOf.0.person.oneOf.0.instagramUrl","typeLabel":"string | null"},"telegramUrl":{"oneOf":[{"type":"string","description":"The person's own Telegram profile as a source stated it, as `https://t.me/\u003cusername>` (never an invite or a channel post). Null when unstated.","isRequired":true,"uniqueKey":"data.results.\\items.items.[INDEX].oneOf.0.person.oneOf.0.telegramUrl.oneOf.0","typeLabel":"string"},{"type":"null","description":"The person's own Telegram profile as a source stated it, as `https://t.me/\u003cusername>` (never an invite or a channel post). Null when unstated.","isRequired":true,"uniqueKey":"data.results.\\items.items.[INDEX].oneOf.0.person.oneOf.0.telegramUrl.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"data.results.\\items.items.[INDEX].oneOf.0.person.oneOf.0.telegramUrl","typeLabel":"string | null"},"title":{"oneOf":[{"type":"string","description":"Title of the primary current position.","isRequired":true,"uniqueKey":"data.results.\\items.items.[INDEX].oneOf.0.person.oneOf.0.title.oneOf.0","typeLabel":"string"},{"type":"null","description":"Title of the primary current position.","isRequired":true,"uniqueKey":"data.results.\\items.items.[INDEX].oneOf.0.person.oneOf.0.title.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"data.results.\\items.items.[INDEX].oneOf.0.person.oneOf.0.title","typeLabel":"string | null"},"about":{"oneOf":[{"type":"string","isRequired":true,"uniqueKey":"data.results.\\items.items.[INDEX].oneOf.0.person.oneOf.0.about.oneOf.0","typeLabel":"string"},{"type":"null","isRequired":true,"uniqueKey":"data.results.\\items.items.[INDEX].oneOf.0.person.oneOf.0.about.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"data.results.\\items.items.[INDEX].oneOf.0.person.oneOf.0.about","typeLabel":"string | null"},"company":{"type":"object","properties":{"name":{"oneOf":[{"type":"string","isRequired":true,"uniqueKey":"data.results.\\items.items.[INDEX].oneOf.0.person.oneOf.0.company.name.oneOf.0","typeLabel":"string"},{"type":"null","isRequired":true,"uniqueKey":"data.results.\\items.items.[INDEX].oneOf.0.person.oneOf.0.company.name.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"data.results.\\items.items.[INDEX].oneOf.0.person.oneOf.0.company.name","typeLabel":"string | null"},"linkedinUrl":{"oneOf":[{"type":"string","isRequired":true,"uniqueKey":"data.results.\\items.items.[INDEX].oneOf.0.person.oneOf.0.company.linkedinUrl.oneOf.0","typeLabel":"string"},{"type":"null","isRequired":true,"uniqueKey":"data.results.\\items.items.[INDEX].oneOf.0.person.oneOf.0.company.linkedinUrl.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"data.results.\\items.items.[INDEX].oneOf.0.person.oneOf.0.company.linkedinUrl","typeLabel":"string | null"},"tagline":{"oneOf":[{"type":"string","isRequired":true,"uniqueKey":"data.results.\\items.items.[INDEX].oneOf.0.person.oneOf.0.company.tagline.oneOf.0","typeLabel":"string"},{"type":"null","isRequired":true,"uniqueKey":"data.results.\\items.items.[INDEX].oneOf.0.person.oneOf.0.company.tagline.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"data.results.\\items.items.[INDEX].oneOf.0.person.oneOf.0.company.tagline","typeLabel":"string | null"},"description":{"oneOf":[{"type":"string","isRequired":true,"uniqueKey":"data.results.\\items.items.[INDEX].oneOf.0.person.oneOf.0.company.description.oneOf.0","typeLabel":"string"},{"type":"null","isRequired":true,"uniqueKey":"data.results.\\items.items.[INDEX].oneOf.0.person.oneOf.0.company.description.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"data.results.\\items.items.[INDEX].oneOf.0.person.oneOf.0.company.description","typeLabel":"string | null"},"industry":{"oneOf":[{"type":"string","isRequired":true,"uniqueKey":"data.results.\\items.items.[INDEX].oneOf.0.person.oneOf.0.company.industry.oneOf.0","typeLabel":"string"},{"type":"null","isRequired":true,"uniqueKey":"data.results.\\items.items.[INDEX].oneOf.0.person.oneOf.0.company.industry.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"data.results.\\items.items.[INDEX].oneOf.0.person.oneOf.0.company.industry","typeLabel":"string | null"},"employeeBand":{"oneOf":[{"type":"string","description":"Size band as the source displays it.","isRequired":true,"uniqueKey":"data.results.\\items.items.[INDEX].oneOf.0.person.oneOf.0.company.employeeBand.oneOf.0","typeLabel":"string"},{"type":"null","description":"Size band as the source displays it.","isRequired":true,"uniqueKey":"data.results.\\items.items.[INDEX].oneOf.0.person.oneOf.0.company.employeeBand.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"data.results.\\items.items.[INDEX].oneOf.0.person.oneOf.0.company.employeeBand","typeLabel":"string | null"},"employeeCount":{"oneOf":[{"type":"integer","description":"Exact headcount, when stated.","isRequired":true,"uniqueKey":"data.results.\\items.items.[INDEX].oneOf.0.person.oneOf.0.company.employeeCount.oneOf.0","typeLabel":"integer"},{"type":"null","description":"Exact headcount, when stated.","isRequired":true,"uniqueKey":"data.results.\\items.items.[INDEX].oneOf.0.person.oneOf.0.company.employeeCount.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"data.results.\\items.items.[INDEX].oneOf.0.person.oneOf.0.company.employeeCount","typeLabel":"integer | null"},"followerCount":{"oneOf":[{"type":"integer","isRequired":true,"uniqueKey":"data.results.\\items.items.[INDEX].oneOf.0.person.oneOf.0.company.followerCount.oneOf.0","typeLabel":"integer"},{"type":"null","isRequired":true,"uniqueKey":"data.results.\\items.items.[INDEX].oneOf.0.person.oneOf.0.company.followerCount.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"data.results.\\items.items.[INDEX].oneOf.0.person.oneOf.0.company.followerCount","typeLabel":"integer | null"},"websiteUrl":{"oneOf":[{"type":"string","isRequired":true,"uniqueKey":"data.results.\\items.items.[INDEX].oneOf.0.person.oneOf.0.company.websiteUrl.oneOf.0","typeLabel":"string"},{"type":"null","isRequired":true,"uniqueKey":"data.results.\\items.items.[INDEX].oneOf.0.person.oneOf.0.company.websiteUrl.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"data.results.\\items.items.[INDEX].oneOf.0.person.oneOf.0.company.websiteUrl","typeLabel":"string | null"},"websiteDomain":{"oneOf":[{"type":"string","isRequired":true,"uniqueKey":"data.results.\\items.items.[INDEX].oneOf.0.person.oneOf.0.company.websiteDomain.oneOf.0","typeLabel":"string"},{"type":"null","isRequired":true,"uniqueKey":"data.results.\\items.items.[INDEX].oneOf.0.person.oneOf.0.company.websiteDomain.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"data.results.\\items.items.[INDEX].oneOf.0.person.oneOf.0.company.websiteDomain","typeLabel":"string | null"},"headquarters":{"oneOf":[{"type":"string","isRequired":true,"uniqueKey":"data.results.\\items.items.[INDEX].oneOf.0.person.oneOf.0.company.headquarters.oneOf.0","typeLabel":"string"},{"type":"null","isRequired":true,"uniqueKey":"data.results.\\items.items.[INDEX].oneOf.0.person.oneOf.0.company.headquarters.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"data.results.\\items.items.[INDEX].oneOf.0.person.oneOf.0.company.headquarters","typeLabel":"string | null"},"hqLocality":{"oneOf":[{"type":"string","isRequired":true,"uniqueKey":"data.results.\\items.items.[INDEX].oneOf.0.person.oneOf.0.company.hqLocality.oneOf.0","typeLabel":"string"},{"type":"null","isRequired":true,"uniqueKey":"data.results.\\items.items.[INDEX].oneOf.0.person.oneOf.0.company.hqLocality.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"data.results.\\items.items.[INDEX].oneOf.0.person.oneOf.0.company.hqLocality","typeLabel":"string | null"},"hqRegion":{"oneOf":[{"type":"string","isRequired":true,"uniqueKey":"data.results.\\items.items.[INDEX].oneOf.0.person.oneOf.0.company.hqRegion.oneOf.0","typeLabel":"string"},{"type":"null","isRequired":true,"uniqueKey":"data.results.\\items.items.[INDEX].oneOf.0.person.oneOf.0.company.hqRegion.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"data.results.\\items.items.[INDEX].oneOf.0.person.oneOf.0.company.hqRegion","typeLabel":"string | null"},"hqCountry":{"oneOf":[{"type":"string","isRequired":true,"uniqueKey":"data.results.\\items.items.[INDEX].oneOf.0.person.oneOf.0.company.hqCountry.oneOf.0","typeLabel":"string"},{"type":"null","isRequired":true,"uniqueKey":"data.results.\\items.items.[INDEX].oneOf.0.person.oneOf.0.company.hqCountry.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"data.results.\\items.items.[INDEX].oneOf.0.person.oneOf.0.company.hqCountry","typeLabel":"string | null"},"foundedYear":{"oneOf":[{"type":"integer","isRequired":true,"uniqueKey":"data.results.\\items.items.[INDEX].oneOf.0.person.oneOf.0.company.foundedYear.oneOf.0","typeLabel":"integer"},{"type":"null","isRequired":true,"uniqueKey":"data.results.\\items.items.[INDEX].oneOf.0.person.oneOf.0.company.foundedYear.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"data.results.\\items.items.[INDEX].oneOf.0.person.oneOf.0.company.foundedYear","typeLabel":"integer | null"},"companyType":{"oneOf":[{"type":"string","isRequired":true,"uniqueKey":"data.results.\\items.items.[INDEX].oneOf.0.person.oneOf.0.company.companyType.oneOf.0","typeLabel":"string"},{"type":"null","isRequired":true,"uniqueKey":"data.results.\\items.items.[INDEX].oneOf.0.person.oneOf.0.company.companyType.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"data.results.\\items.items.[INDEX].oneOf.0.person.oneOf.0.company.companyType","typeLabel":"string | null"},"specialties":{"type":"array","items":{"type":"string","uniqueKey":"data.results.\\items.items.[INDEX].oneOf.0.person.oneOf.0.company.specialties.items.[INDEX]","typeLabel":"string"},"isRequired":true,"uniqueKey":"data.results.\\items.items.[INDEX].oneOf.0.person.oneOf.0.company.specialties","typeLabel":"string[]"},"logoUrl":{"type":"null","description":"Always null. Reserved so the shape stays stable: a provider image address is never returned (it is signed, expires, and discloses the viewer). Render `logoImageUrl`.","isRequired":true,"uniqueKey":"data.results.\\items.items.[INDEX].oneOf.0.person.oneOf.0.company.logoUrl","typeLabel":"null"},"logoImageUrl":{"oneOf":[{"type":"string","description":"Our own copy of the logo (`/api/images/\u003cid>`, same authentication as this API). Null when the source states no logo or no copy is held.","isRequired":true,"uniqueKey":"data.results.\\items.items.[INDEX].oneOf.0.person.oneOf.0.company.logoImageUrl.oneOf.0","typeLabel":"string"},{"type":"null","description":"Our own copy of the logo (`/api/images/\u003cid>`, same authentication as this API). Null when the source states no logo or no copy is held.","isRequired":true,"uniqueKey":"data.results.\\items.items.[INDEX].oneOf.0.person.oneOf.0.company.logoImageUrl.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"data.results.\\items.items.[INDEX].oneOf.0.person.oneOf.0.company.logoImageUrl","typeLabel":"string | null"},"phone":{"oneOf":[{"type":"string","description":"The company phone. Always null until phone verification is available; reserved so the shape does not change when it is.","isRequired":true,"uniqueKey":"data.results.\\items.items.[INDEX].oneOf.0.person.oneOf.0.company.phone.oneOf.0","typeLabel":"string"},{"type":"null","description":"The company phone. Always null until phone verification is available; reserved so the shape does not change when it is.","isRequired":true,"uniqueKey":"data.results.\\items.items.[INDEX].oneOf.0.person.oneOf.0.company.phone.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"data.results.\\items.items.[INDEX].oneOf.0.person.oneOf.0.company.phone","typeLabel":"string | null"},"email":{"oneOf":[{"type":"string","description":"The company's general contact email: only a generic role address (info@, sales@, …) on the company's own domain, stated by the company, that passed email verification. Null when none is stated or it did not verify. Never a personal address.","isRequired":true,"uniqueKey":"data.results.\\items.items.[INDEX].oneOf.0.person.oneOf.0.company.email.oneOf.0","typeLabel":"string"},{"type":"null","description":"The company's general contact email: only a generic role address (info@, sales@, …) on the company's own domain, stated by the company, that passed email verification. Null when none is stated or it did not verify. Never a personal address.","isRequired":true,"uniqueKey":"data.results.\\items.items.[INDEX].oneOf.0.person.oneOf.0.company.email.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"data.results.\\items.items.[INDEX].oneOf.0.person.oneOf.0.company.email","typeLabel":"string | null"},"xUrl":{"oneOf":[{"type":"string","description":"X (Twitter) profile the company states as its own, as `https://x.com/\u003chandle>`. Null when not stated; never constructed from the name.","isRequired":true,"uniqueKey":"data.results.\\items.items.[INDEX].oneOf.0.person.oneOf.0.company.xUrl.oneOf.0","typeLabel":"string"},{"type":"null","description":"X (Twitter) profile the company states as its own, as `https://x.com/\u003chandle>`. Null when not stated; never constructed from the name.","isRequired":true,"uniqueKey":"data.results.\\items.items.[INDEX].oneOf.0.person.oneOf.0.company.xUrl.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"data.results.\\items.items.[INDEX].oneOf.0.person.oneOf.0.company.xUrl","typeLabel":"string | null"},"facebookUrl":{"oneOf":[{"type":"string","description":"Facebook page the company states as its own, as `https://www.facebook.com/\u003cpage>`. Null when not stated.","isRequired":true,"uniqueKey":"data.results.\\items.items.[INDEX].oneOf.0.person.oneOf.0.company.facebookUrl.oneOf.0","typeLabel":"string"},{"type":"null","description":"Facebook page the company states as its own, as `https://www.facebook.com/\u003cpage>`. Null when not stated.","isRequired":true,"uniqueKey":"data.results.\\items.items.[INDEX].oneOf.0.person.oneOf.0.company.facebookUrl.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"data.results.\\items.items.[INDEX].oneOf.0.person.oneOf.0.company.facebookUrl","typeLabel":"string | null"},"instagramUrl":{"oneOf":[{"type":"string","description":"Instagram profile the company states as its own, as `https://www.instagram.com/\u003cuser>`. Null when not stated.","isRequired":true,"uniqueKey":"data.results.\\items.items.[INDEX].oneOf.0.person.oneOf.0.company.instagramUrl.oneOf.0","typeLabel":"string"},{"type":"null","description":"Instagram profile the company states as its own, as `https://www.instagram.com/\u003cuser>`. Null when not stated.","isRequired":true,"uniqueKey":"data.results.\\items.items.[INDEX].oneOf.0.person.oneOf.0.company.instagramUrl.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"data.results.\\items.items.[INDEX].oneOf.0.person.oneOf.0.company.instagramUrl","typeLabel":"string | null"},"youtubeUrl":{"oneOf":[{"type":"string","description":"YouTube channel the company states as its own, as `https://www.youtube.com/` followed by `@handle`, `channel/…`, `c/…` or `user/…`. Null when not stated.","isRequired":true,"uniqueKey":"data.results.\\items.items.[INDEX].oneOf.0.person.oneOf.0.company.youtubeUrl.oneOf.0","typeLabel":"string"},{"type":"null","description":"YouTube channel the company states as its own, as `https://www.youtube.com/` followed by `@handle`, `channel/…`, `c/…` or `user/…`. Null when not stated.","isRequired":true,"uniqueKey":"data.results.\\items.items.[INDEX].oneOf.0.person.oneOf.0.company.youtubeUrl.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"data.results.\\items.items.[INDEX].oneOf.0.person.oneOf.0.company.youtubeUrl","typeLabel":"string | null"},"confirmedAt":{"oneOf":[{"type":"string","description":"When this record was last confirmed against the source. Null when the Company is built only from what a lead or list row observed (no company record).","isRequired":true,"uniqueKey":"data.results.\\items.items.[INDEX].oneOf.0.person.oneOf.0.company.confirmedAt.oneOf.0","typeLabel":"string"},{"type":"null","description":"When this record was last confirmed against the source. Null when the Company is built only from what a lead or list row observed (no company record).","isRequired":true,"uniqueKey":"data.results.\\items.items.[INDEX].oneOf.0.person.oneOf.0.company.confirmedAt.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"data.results.\\items.items.[INDEX].oneOf.0.person.oneOf.0.company.confirmedAt","typeLabel":"string | null"}},"required":["name","linkedinUrl","tagline","description","industry","employeeBand","employeeCount","followerCount","websiteUrl","websiteDomain","headquarters","hqLocality","hqRegion","hqCountry","foundedYear","companyType","specialties","logoUrl","logoImageUrl","phone","email","xUrl","facebookUrl","instagramUrl","youtubeUrl","confirmedAt"],"description":"The canonical Company for the current employer (same schema as `POST /api/v1/company`).","isRequired":true,"uniqueKey":"data.results.\\items.items.[INDEX].oneOf.0.person.oneOf.0.company","typeLabel":"object"},"companyName":{"oneOf":[{"type":"string","description":"Alias of `company.name`.","isRequired":true,"uniqueKey":"data.results.\\items.items.[INDEX].oneOf.0.person.oneOf.0.companyName.oneOf.0","typeLabel":"string"},{"type":"null","description":"Alias of `company.name`.","isRequired":true,"uniqueKey":"data.results.\\items.items.[INDEX].oneOf.0.person.oneOf.0.companyName.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"data.results.\\items.items.[INDEX].oneOf.0.person.oneOf.0.companyName","typeLabel":"string | null"},"companyLinkedinUrl":{"oneOf":[{"type":"string","description":"Alias of `company.linkedinUrl`.","isRequired":true,"uniqueKey":"data.results.\\items.items.[INDEX].oneOf.0.person.oneOf.0.companyLinkedinUrl.oneOf.0","typeLabel":"string"},{"type":"null","description":"Alias of `company.linkedinUrl`.","isRequired":true,"uniqueKey":"data.results.\\items.items.[INDEX].oneOf.0.person.oneOf.0.companyLinkedinUrl.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"data.results.\\items.items.[INDEX].oneOf.0.person.oneOf.0.companyLinkedinUrl","typeLabel":"string | null"},"companyLogoUrl":{"oneOf":[{"type":"string","description":"Alias of `company.logoImageUrl` (owned).","isRequired":true,"uniqueKey":"data.results.\\items.items.[INDEX].oneOf.0.person.oneOf.0.companyLogoUrl.oneOf.0","typeLabel":"string"},{"type":"null","description":"Alias of `company.logoImageUrl` (owned).","isRequired":true,"uniqueKey":"data.results.\\items.items.[INDEX].oneOf.0.person.oneOf.0.companyLogoUrl.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"data.results.\\items.items.[INDEX].oneOf.0.person.oneOf.0.companyLogoUrl","typeLabel":"string | null"},"domain":{"oneOf":[{"type":"string","description":"The company's website domain, else the domain the profile resolver stated.","isRequired":true,"uniqueKey":"data.results.\\items.items.[INDEX].oneOf.0.person.oneOf.0.domain.oneOf.0","typeLabel":"string"},{"type":"null","description":"The company's website domain, else the domain the profile resolver stated.","isRequired":true,"uniqueKey":"data.results.\\items.items.[INDEX].oneOf.0.person.oneOf.0.domain.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"data.results.\\items.items.[INDEX].oneOf.0.person.oneOf.0.domain","typeLabel":"string | null"},"industry":{"oneOf":[{"type":"string","description":"Alias of `company.industry`.","isRequired":true,"uniqueKey":"data.results.\\items.items.[INDEX].oneOf.0.person.oneOf.0.industry.oneOf.0","typeLabel":"string"},{"type":"null","description":"Alias of `company.industry`.","isRequired":true,"uniqueKey":"data.results.\\items.items.[INDEX].oneOf.0.person.oneOf.0.industry.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"data.results.\\items.items.[INDEX].oneOf.0.person.oneOf.0.industry","typeLabel":"string | null"},"location":{"oneOf":[{"type":"string","description":"The person's own location (never company HQ).","isRequired":true,"uniqueKey":"data.results.\\items.items.[INDEX].oneOf.0.person.oneOf.0.location.oneOf.0","typeLabel":"string"},{"type":"null","description":"The person's own location (never company HQ).","isRequired":true,"uniqueKey":"data.results.\\items.items.[INDEX].oneOf.0.person.oneOf.0.location.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"data.results.\\items.items.[INDEX].oneOf.0.person.oneOf.0.location","typeLabel":"string | null"},"department":{"oneOf":[{"type":"string","enum":["Accounting","Administrative","Arts and Design","Business Development","Community \u0026 Social Services","Consulting","Customer Success and Support","Education","Engineering","Entrepreneurship","Finance","Healthcare Services","Human Resources","Information Technology","Legal","Marketing","Media and Communication","Military and Protective Services","Operations","Product Management","Program and Project Management","Purchasing","Quality Assurance","Real Estate","Research","Sales",null],"description":"Source-stated only; never classified from the title.","isRequired":true,"uniqueKey":"data.results.\\items.items.[INDEX].oneOf.0.person.oneOf.0.department.oneOf.0","typeLabel":"enum\u003cstring>"},{"type":"null","enum":["Accounting","Administrative","Arts and Design","Business Development","Community \u0026 Social Services","Consulting","Customer Success and Support","Education","Engineering","Entrepreneurship","Finance","Healthcare Services","Human Resources","Information Technology","Legal","Marketing","Media and Communication","Military and Protective Services","Operations","Product Management","Program and Project Management","Purchasing","Quality Assurance","Real Estate","Research","Sales",null],"description":"Source-stated only; never classified from the title.","isRequired":true,"uniqueKey":"data.results.\\items.items.[INDEX].oneOf.0.person.oneOf.0.department.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"data.results.\\items.items.[INDEX].oneOf.0.person.oneOf.0.department","typeLabel":"enum\u003cstring> | null"},"seniority":{"oneOf":[{"type":"string","enum":["In Training","Entry Level","Senior","Strategic","Entry Level Manager","Experienced Manager","Director","Vice President","CXO","Owner / Partner",null],"description":"Source-stated only; never classified from the title.","isRequired":true,"uniqueKey":"data.results.\\items.items.[INDEX].oneOf.0.person.oneOf.0.seniority.oneOf.0","typeLabel":"enum\u003cstring>"},{"type":"null","enum":["In Training","Entry Level","Senior","Strategic","Entry Level Manager","Experienced Manager","Director","Vice President","CXO","Owner / Partner",null],"description":"Source-stated only; never classified from the title.","isRequired":true,"uniqueKey":"data.results.\\items.items.[INDEX].oneOf.0.person.oneOf.0.seniority.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"data.results.\\items.items.[INDEX].oneOf.0.person.oneOf.0.seniority","typeLabel":"enum\u003cstring> | null"},"yearsOfExperience":{"oneOf":[{"type":"string","enum":["Less than 1 year","1-2 years","3-5 years","6-10 years","11-15 years","16-20 years","20+ years",null],"description":"Overlap-free union of stated positions; null when any start is missing or the stated precision leaves it between two buckets.","isRequired":true,"uniqueKey":"data.results.\\items.items.[INDEX].oneOf.0.person.oneOf.0.yearsOfExperience.oneOf.0","typeLabel":"enum\u003cstring>"},{"type":"null","enum":["Less than 1 year","1-2 years","3-5 years","6-10 years","11-15 years","16-20 years","20+ years",null],"description":"Overlap-free union of stated positions; null when any start is missing or the stated precision leaves it between two buckets.","isRequired":true,"uniqueKey":"data.results.\\items.items.[INDEX].oneOf.0.person.oneOf.0.yearsOfExperience.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"data.results.\\items.items.[INDEX].oneOf.0.person.oneOf.0.yearsOfExperience","typeLabel":"enum\u003cstring> | null"},"employment":{"type":"array","items":{"type":"object","properties":{"companyName":{"oneOf":[{"type":"string","isRequired":true,"uniqueKey":"data.results.\\items.items.[INDEX].oneOf.0.person.oneOf.0.employment.items.[INDEX].companyName.oneOf.0","typeLabel":"string"},{"type":"null","isRequired":true,"uniqueKey":"data.results.\\items.items.[INDEX].oneOf.0.person.oneOf.0.employment.items.[INDEX].companyName.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"data.results.\\items.items.[INDEX].oneOf.0.person.oneOf.0.employment.items.[INDEX].companyName","typeLabel":"string | null"},"companyLinkedinUrl":{"oneOf":[{"type":"string","isRequired":true,"uniqueKey":"data.results.\\items.items.[INDEX].oneOf.0.person.oneOf.0.employment.items.[INDEX].companyLinkedinUrl.oneOf.0","typeLabel":"string"},{"type":"null","isRequired":true,"uniqueKey":"data.results.\\items.items.[INDEX].oneOf.0.person.oneOf.0.employment.items.[INDEX].companyLinkedinUrl.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"data.results.\\items.items.[INDEX].oneOf.0.person.oneOf.0.employment.items.[INDEX].companyLinkedinUrl","typeLabel":"string | null"},"title":{"oneOf":[{"type":"string","isRequired":true,"uniqueKey":"data.results.\\items.items.[INDEX].oneOf.0.person.oneOf.0.employment.items.[INDEX].title.oneOf.0","typeLabel":"string"},{"type":"null","isRequired":true,"uniqueKey":"data.results.\\items.items.[INDEX].oneOf.0.person.oneOf.0.employment.items.[INDEX].title.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"data.results.\\items.items.[INDEX].oneOf.0.person.oneOf.0.employment.items.[INDEX].title","typeLabel":"string | null"},"start":{"oneOf":[{"type":"object","properties":{"year":{"type":"integer","isRequired":true,"uniqueKey":"data.results.\\items.items.[INDEX].oneOf.0.person.oneOf.0.employment.items.[INDEX].start.oneOf.0.year","typeLabel":"integer"},"month":{"oneOf":[{"type":"integer","description":"1–12, or null when the source stated the year only (never padded).","isRequired":true,"uniqueKey":"data.results.\\items.items.[INDEX].oneOf.0.person.oneOf.0.employment.items.[INDEX].start.oneOf.0.month.oneOf.0","typeLabel":"integer"},{"type":"null","description":"1–12, or null when the source stated the year only (never padded).","isRequired":true,"uniqueKey":"data.results.\\items.items.[INDEX].oneOf.0.person.oneOf.0.employment.items.[INDEX].start.oneOf.0.month.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"data.results.\\items.items.[INDEX].oneOf.0.person.oneOf.0.employment.items.[INDEX].start.oneOf.0.month","typeLabel":"integer | null"}},"required":["year","month"],"isRequired":true,"uniqueKey":"data.results.\\items.items.[INDEX].oneOf.0.person.oneOf.0.employment.items.[INDEX].start.oneOf.0","typeLabel":"object"},{"type":"null","properties":{"year":{"type":"integer"},"month":{"oneOf":[{"type":"integer","description":"1–12, or null when the source stated the year only (never padded)."},{"type":"null","description":"1–12, or null when the source stated the year only (never padded)."}]}},"required":["year","month"],"isRequired":true,"uniqueKey":"data.results.\\items.items.[INDEX].oneOf.0.person.oneOf.0.employment.items.[INDEX].start.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"data.results.\\items.items.[INDEX].oneOf.0.person.oneOf.0.employment.items.[INDEX].start","typeLabel":"object | null"},"end":{"oneOf":[{"type":"object","properties":{"year":{"type":"integer","isRequired":true,"uniqueKey":"data.results.\\items.items.[INDEX].oneOf.0.person.oneOf.0.employment.items.[INDEX].end.oneOf.0.year","typeLabel":"integer"},"month":{"oneOf":[{"type":"integer","description":"1–12, or null when the source stated the year only (never padded).","isRequired":true,"uniqueKey":"data.results.\\items.items.[INDEX].oneOf.0.person.oneOf.0.employment.items.[INDEX].end.oneOf.0.month.oneOf.0","typeLabel":"integer"},{"type":"null","description":"1–12, or null when the source stated the year only (never padded).","isRequired":true,"uniqueKey":"data.results.\\items.items.[INDEX].oneOf.0.person.oneOf.0.employment.items.[INDEX].end.oneOf.0.month.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"data.results.\\items.items.[INDEX].oneOf.0.person.oneOf.0.employment.items.[INDEX].end.oneOf.0.month","typeLabel":"integer | null"}},"required":["year","month"],"isRequired":true,"uniqueKey":"data.results.\\items.items.[INDEX].oneOf.0.person.oneOf.0.employment.items.[INDEX].end.oneOf.0","typeLabel":"object"},{"type":"null","properties":{"year":{"type":"integer"},"month":{"oneOf":[{"type":"integer","description":"1–12, or null when the source stated the year only (never padded)."},{"type":"null","description":"1–12, or null when the source stated the year only (never padded)."}]}},"required":["year","month"],"isRequired":true,"uniqueKey":"data.results.\\items.items.[INDEX].oneOf.0.person.oneOf.0.employment.items.[INDEX].end.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"data.results.\\items.items.[INDEX].oneOf.0.person.oneOf.0.employment.items.[INDEX].end","typeLabel":"object | null"},"current":{"type":"boolean","isRequired":true,"uniqueKey":"data.results.\\items.items.[INDEX].oneOf.0.person.oneOf.0.employment.items.[INDEX].current","typeLabel":"boolean"},"location":{"oneOf":[{"type":"string","description":"Where the position was held, as the source stated it.","isRequired":true,"uniqueKey":"data.results.\\items.items.[INDEX].oneOf.0.person.oneOf.0.employment.items.[INDEX].location.oneOf.0","typeLabel":"string"},{"type":"null","description":"Where the position was held, as the source stated it.","isRequired":true,"uniqueKey":"data.results.\\items.items.[INDEX].oneOf.0.person.oneOf.0.employment.items.[INDEX].location.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"data.results.\\items.items.[INDEX].oneOf.0.person.oneOf.0.employment.items.[INDEX].location","typeLabel":"string | null"},"description":{"oneOf":[{"type":"string","description":"The person's own description of the position, as stated.","isRequired":true,"uniqueKey":"data.results.\\items.items.[INDEX].oneOf.0.person.oneOf.0.employment.items.[INDEX].description.oneOf.0","typeLabel":"string"},{"type":"null","description":"The person's own description of the position, as stated.","isRequired":true,"uniqueKey":"data.results.\\items.items.[INDEX].oneOf.0.person.oneOf.0.employment.items.[INDEX].description.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"data.results.\\items.items.[INDEX].oneOf.0.person.oneOf.0.employment.items.[INDEX].description","typeLabel":"string | null"}},"required":["companyName","companyLinkedinUrl","title","start","end","current","location","description"],"uniqueKey":"data.results.\\items.items.[INDEX].oneOf.0.person.oneOf.0.employment.items.[INDEX]","typeLabel":"object"},"description":"Source order; [] when not available.","isRequired":true,"uniqueKey":"data.results.\\items.items.[INDEX].oneOf.0.person.oneOf.0.employment","typeLabel":"object[]"},"education":{"type":"array","items":{"type":"object","properties":{"school":{"oneOf":[{"type":"string","isRequired":true,"uniqueKey":"data.results.\\items.items.[INDEX].oneOf.0.person.oneOf.0.education.items.[INDEX].school.oneOf.0","typeLabel":"string"},{"type":"null","isRequired":true,"uniqueKey":"data.results.\\items.items.[INDEX].oneOf.0.person.oneOf.0.education.items.[INDEX].school.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"data.results.\\items.items.[INDEX].oneOf.0.person.oneOf.0.education.items.[INDEX].school","typeLabel":"string | null"},"schoolLinkedinUrl":{"oneOf":[{"type":"string","isRequired":true,"uniqueKey":"data.results.\\items.items.[INDEX].oneOf.0.person.oneOf.0.education.items.[INDEX].schoolLinkedinUrl.oneOf.0","typeLabel":"string"},{"type":"null","isRequired":true,"uniqueKey":"data.results.\\items.items.[INDEX].oneOf.0.person.oneOf.0.education.items.[INDEX].schoolLinkedinUrl.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"data.results.\\items.items.[INDEX].oneOf.0.person.oneOf.0.education.items.[INDEX].schoolLinkedinUrl","typeLabel":"string | null"},"degree":{"oneOf":[{"type":"string","isRequired":true,"uniqueKey":"data.results.\\items.items.[INDEX].oneOf.0.person.oneOf.0.education.items.[INDEX].degree.oneOf.0","typeLabel":"string"},{"type":"null","isRequired":true,"uniqueKey":"data.results.\\items.items.[INDEX].oneOf.0.person.oneOf.0.education.items.[INDEX].degree.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"data.results.\\items.items.[INDEX].oneOf.0.person.oneOf.0.education.items.[INDEX].degree","typeLabel":"string | null"},"field":{"oneOf":[{"type":"string","isRequired":true,"uniqueKey":"data.results.\\items.items.[INDEX].oneOf.0.person.oneOf.0.education.items.[INDEX].field.oneOf.0","typeLabel":"string"},{"type":"null","isRequired":true,"uniqueKey":"data.results.\\items.items.[INDEX].oneOf.0.person.oneOf.0.education.items.[INDEX].field.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"data.results.\\items.items.[INDEX].oneOf.0.person.oneOf.0.education.items.[INDEX].field","typeLabel":"string | null"},"start":{"oneOf":[{"type":"object","properties":{"year":{"type":"integer","isRequired":true,"uniqueKey":"data.results.\\items.items.[INDEX].oneOf.0.person.oneOf.0.education.items.[INDEX].start.oneOf.0.year","typeLabel":"integer"},"month":{"oneOf":[{"type":"integer","description":"1–12, or null when the source stated the year only (never padded).","isRequired":true,"uniqueKey":"data.results.\\items.items.[INDEX].oneOf.0.person.oneOf.0.education.items.[INDEX].start.oneOf.0.month.oneOf.0","typeLabel":"integer"},{"type":"null","description":"1–12, or null when the source stated the year only (never padded).","isRequired":true,"uniqueKey":"data.results.\\items.items.[INDEX].oneOf.0.person.oneOf.0.education.items.[INDEX].start.oneOf.0.month.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"data.results.\\items.items.[INDEX].oneOf.0.person.oneOf.0.education.items.[INDEX].start.oneOf.0.month","typeLabel":"integer | null"}},"required":["year","month"],"isRequired":true,"uniqueKey":"data.results.\\items.items.[INDEX].oneOf.0.person.oneOf.0.education.items.[INDEX].start.oneOf.0","typeLabel":"object"},{"type":"null","properties":{"year":{"type":"integer"},"month":{"oneOf":[{"type":"integer","description":"1–12, or null when the source stated the year only (never padded)."},{"type":"null","description":"1–12, or null when the source stated the year only (never padded)."}]}},"required":["year","month"],"isRequired":true,"uniqueKey":"data.results.\\items.items.[INDEX].oneOf.0.person.oneOf.0.education.items.[INDEX].start.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"data.results.\\items.items.[INDEX].oneOf.0.person.oneOf.0.education.items.[INDEX].start","typeLabel":"object | null"},"end":{"oneOf":[{"type":"object","properties":{"year":{"type":"integer","isRequired":true,"uniqueKey":"data.results.\\items.items.[INDEX].oneOf.0.person.oneOf.0.education.items.[INDEX].end.oneOf.0.year","typeLabel":"integer"},"month":{"oneOf":[{"type":"integer","description":"1–12, or null when the source stated the year only (never padded).","isRequired":true,"uniqueKey":"data.results.\\items.items.[INDEX].oneOf.0.person.oneOf.0.education.items.[INDEX].end.oneOf.0.month.oneOf.0","typeLabel":"integer"},{"type":"null","description":"1–12, or null when the source stated the year only (never padded).","isRequired":true,"uniqueKey":"data.results.\\items.items.[INDEX].oneOf.0.person.oneOf.0.education.items.[INDEX].end.oneOf.0.month.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"data.results.\\items.items.[INDEX].oneOf.0.person.oneOf.0.education.items.[INDEX].end.oneOf.0.month","typeLabel":"integer | null"}},"required":["year","month"],"isRequired":true,"uniqueKey":"data.results.\\items.items.[INDEX].oneOf.0.person.oneOf.0.education.items.[INDEX].end.oneOf.0","typeLabel":"object"},{"type":"null","properties":{"year":{"type":"integer"},"month":{"oneOf":[{"type":"integer","description":"1–12, or null when the source stated the year only (never padded)."},{"type":"null","description":"1–12, or null when the source stated the year only (never padded)."}]}},"required":["year","month"],"isRequired":true,"uniqueKey":"data.results.\\items.items.[INDEX].oneOf.0.person.oneOf.0.education.items.[INDEX].end.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"data.results.\\items.items.[INDEX].oneOf.0.person.oneOf.0.education.items.[INDEX].end","typeLabel":"object | null"}},"required":["school","schoolLinkedinUrl","degree","field","start","end"],"uniqueKey":"data.results.\\items.items.[INDEX].oneOf.0.person.oneOf.0.education.items.[INDEX]","typeLabel":"object"},"description":"Source order; [] when not available.","isRequired":true,"uniqueKey":"data.results.\\items.items.[INDEX].oneOf.0.person.oneOf.0.education","typeLabel":"object[]"},"historyStatus":{"type":"object","properties":{"employment":{"type":"string","enum":["available","not-yet-available"],"description":"`not-yet-available`: no source has supplied this history yet (the list is []). `available` with [] means the source supplied an empty history.","isRequired":true,"uniqueKey":"data.results.\\items.items.[INDEX].oneOf.0.person.oneOf.0.historyStatus.employment","typeLabel":"enum\u003cstring>"},"education":{"type":"string","enum":["available","not-yet-available"],"description":"`not-yet-available`: no source has supplied this history yet (the list is []). `available` with [] means the source supplied an empty history.","isRequired":true,"uniqueKey":"data.results.\\items.items.[INDEX].oneOf.0.person.oneOf.0.historyStatus.education","typeLabel":"enum\u003cstring>"}},"required":["employment","education"],"isRequired":true,"uniqueKey":"data.results.\\items.items.[INDEX].oneOf.0.person.oneOf.0.historyStatus","typeLabel":"object"}},"isRequired":true,"uniqueKey":"data.results.\\items.items.[INDEX].oneOf.0.person.oneOf.0","typeLabel":"object"},{"type":"null","description":"THE canonical Person for this lead. `person.company` is the same object as `companyProfile`.","required":["avatarUrl","fullName","firstName","lastName","linkedinUrl","xUrl","facebookUrl","instagramUrl","telegramUrl","title","about","company","companyName","companyLinkedinUrl","companyLogoUrl","domain","industry","location","department","seniority","yearsOfExperience","employment","education","historyStatus"],"properties":{"avatarUrl":{"oneOf":[{"type":"string","description":"Owned image address (`/api/images/\u003cid>`, authenticated). Null ⇒ render initials."},{"type":"null","description":"Owned image address (`/api/images/\u003cid>`, authenticated). Null ⇒ render initials."}]},"fullName":{"oneOf":[{"type":"string","description":"The source's own statement of the name."},{"type":"null","description":"The source's own statement of the name."}]},"firstName":{"oneOf":[{"type":"string","description":"The first name, as the source stated it when it stated two names; otherwise `fullName` split at read time (as written). Null when the name does not split."},{"type":"null","description":"The first name, as the source stated it when it stated two names; otherwise `fullName` split at read time (as written). Null when the name does not split."}]},"lastName":{"oneOf":[{"type":"string","description":"The last name (the whole surname, e.g. \"van Beethoven\"), on the same rule as `firstName`."},{"type":"null","description":"The last name (the whole surname, e.g. \"van Beethoven\"), on the same rule as `firstName`."}]},"linkedinUrl":{"type":"string","description":"Canonical profile URL — the identity. Never null. The public profile URL (`https://www.linkedin.com/in/\u003cpublic-name>`) when known, else the member-ID URL."},"xUrl":{"oneOf":[{"type":"string","description":"The person's own X (Twitter) profile as a source stated it, as `https://x.com/\u003chandle>`. Null when no source stated one — never derived from a name, an address or another site's username."},{"type":"null","description":"The person's own X (Twitter) profile as a source stated it, as `https://x.com/\u003chandle>`. Null when no source stated one — never derived from a name, an address or another site's username."}]},"facebookUrl":{"oneOf":[{"type":"string","description":"The person's own Facebook profile as a source stated it (`https://www.facebook.com/\u003cname>` or `…/profile.php?id=\u003cdigits>`). Null when unstated."},{"type":"null","description":"The person's own Facebook profile as a source stated it (`https://www.facebook.com/\u003cname>` or `…/profile.php?id=\u003cdigits>`). Null when unstated."}]},"instagramUrl":{"oneOf":[{"type":"string","description":"The person's own Instagram profile as a source stated it, as `https://www.instagram.com/\u003cuser>`. Null when unstated."},{"type":"null","description":"The person's own Instagram profile as a source stated it, as `https://www.instagram.com/\u003cuser>`. Null when unstated."}]},"telegramUrl":{"oneOf":[{"type":"string","description":"The person's own Telegram profile as a source stated it, as `https://t.me/\u003cusername>` (never an invite or a channel post). Null when unstated."},{"type":"null","description":"The person's own Telegram profile as a source stated it, as `https://t.me/\u003cusername>` (never an invite or a channel post). Null when unstated."}]},"title":{"oneOf":[{"type":"string","description":"Title of the primary current position."},{"type":"null","description":"Title of the primary current position."}]},"about":{"oneOf":[{"type":"string"},{"type":"null"}]},"company":{"type":"object","properties":{"name":{"oneOf":[{"type":"string"},{"type":"null"}]},"linkedinUrl":{"oneOf":[{"type":"string"},{"type":"null"}]},"tagline":{"oneOf":[{"type":"string"},{"type":"null"}]},"description":{"oneOf":[{"type":"string"},{"type":"null"}]},"industry":{"oneOf":[{"type":"string"},{"type":"null"}]},"employeeBand":{"oneOf":[{"type":"string","description":"Size band as the source displays it."},{"type":"null","description":"Size band as the source displays it."}]},"employeeCount":{"oneOf":[{"type":"integer","description":"Exact headcount, when stated."},{"type":"null","description":"Exact headcount, when stated."}]},"followerCount":{"oneOf":[{"type":"integer"},{"type":"null"}]},"websiteUrl":{"oneOf":[{"type":"string"},{"type":"null"}]},"websiteDomain":{"oneOf":[{"type":"string"},{"type":"null"}]},"headquarters":{"oneOf":[{"type":"string"},{"type":"null"}]},"hqLocality":{"oneOf":[{"type":"string"},{"type":"null"}]},"hqRegion":{"oneOf":[{"type":"string"},{"type":"null"}]},"hqCountry":{"oneOf":[{"type":"string"},{"type":"null"}]},"foundedYear":{"oneOf":[{"type":"integer"},{"type":"null"}]},"companyType":{"oneOf":[{"type":"string"},{"type":"null"}]},"specialties":{"type":"array","items":{"type":"string"}},"logoUrl":{"type":"null","description":"Always null. Reserved so the shape stays stable: a provider image address is never returned (it is signed, expires, and discloses the viewer). Render `logoImageUrl`."},"logoImageUrl":{"oneOf":[{"type":"string","description":"Our own copy of the logo (`/api/images/\u003cid>`, same authentication as this API). Null when the source states no logo or no copy is held."},{"type":"null","description":"Our own copy of the logo (`/api/images/\u003cid>`, same authentication as this API). Null when the source states no logo or no copy is held."}]},"phone":{"oneOf":[{"type":"string","description":"The company phone. Always null until phone verification is available; reserved so the shape does not change when it is."},{"type":"null","description":"The company phone. Always null until phone verification is available; reserved so the shape does not change when it is."}]},"email":{"oneOf":[{"type":"string","description":"The company's general contact email: only a generic role address (info@, sales@, …) on the company's own domain, stated by the company, that passed email verification. Null when none is stated or it did not verify. Never a personal address."},{"type":"null","description":"The company's general contact email: only a generic role address (info@, sales@, …) on the company's own domain, stated by the company, that passed email verification. Null when none is stated or it did not verify. Never a personal address."}]},"xUrl":{"oneOf":[{"type":"string","description":"X (Twitter) profile the company states as its own, as `https://x.com/\u003chandle>`. Null when not stated; never constructed from the name."},{"type":"null","description":"X (Twitter) profile the company states as its own, as `https://x.com/\u003chandle>`. Null when not stated; never constructed from the name."}]},"facebookUrl":{"oneOf":[{"type":"string","description":"Facebook page the company states as its own, as `https://www.facebook.com/\u003cpage>`. Null when not stated."},{"type":"null","description":"Facebook page the company states as its own, as `https://www.facebook.com/\u003cpage>`. Null when not stated."}]},"instagramUrl":{"oneOf":[{"type":"string","description":"Instagram profile the company states as its own, as `https://www.instagram.com/\u003cuser>`. Null when not stated."},{"type":"null","description":"Instagram profile the company states as its own, as `https://www.instagram.com/\u003cuser>`. Null when not stated."}]},"youtubeUrl":{"oneOf":[{"type":"string","description":"YouTube channel the company states as its own, as `https://www.youtube.com/` followed by `@handle`, `channel/…`, `c/…` or `user/…`. Null when not stated."},{"type":"null","description":"YouTube channel the company states as its own, as `https://www.youtube.com/` followed by `@handle`, `channel/…`, `c/…` or `user/…`. Null when not stated."}]},"confirmedAt":{"oneOf":[{"type":"string","description":"When this record was last confirmed against the source. Null when the Company is built only from what a lead or list row observed (no company record)."},{"type":"null","description":"When this record was last confirmed against the source. Null when the Company is built only from what a lead or list row observed (no company record)."}]}},"required":["name","linkedinUrl","tagline","description","industry","employeeBand","employeeCount","followerCount","websiteUrl","websiteDomain","headquarters","hqLocality","hqRegion","hqCountry","foundedYear","companyType","specialties","logoUrl","logoImageUrl","phone","email","xUrl","facebookUrl","instagramUrl","youtubeUrl","confirmedAt"],"description":"The canonical Company for the current employer (same schema as `POST /api/v1/company`)."},"companyName":{"oneOf":[{"type":"string","description":"Alias of `company.name`."},{"type":"null","description":"Alias of `company.name`."}]},"companyLinkedinUrl":{"oneOf":[{"type":"string","description":"Alias of `company.linkedinUrl`."},{"type":"null","description":"Alias of `company.linkedinUrl`."}]},"companyLogoUrl":{"oneOf":[{"type":"string","description":"Alias of `company.logoImageUrl` (owned)."},{"type":"null","description":"Alias of `company.logoImageUrl` (owned)."}]},"domain":{"oneOf":[{"type":"string","description":"The company's website domain, else the domain the profile resolver stated."},{"type":"null","description":"The company's website domain, else the domain the profile resolver stated."}]},"industry":{"oneOf":[{"type":"string","description":"Alias of `company.industry`."},{"type":"null","description":"Alias of `company.industry`."}]},"location":{"oneOf":[{"type":"string","description":"The person's own location (never company HQ)."},{"type":"null","description":"The person's own location (never company HQ)."}]},"department":{"oneOf":[{"type":"string","enum":["Accounting","Administrative","Arts and Design","Business Development","Community \u0026 Social Services","Consulting","Customer Success and Support","Education","Engineering","Entrepreneurship","Finance","Healthcare Services","Human Resources","Information Technology","Legal","Marketing","Media and Communication","Military and Protective Services","Operations","Product Management","Program and Project Management","Purchasing","Quality Assurance","Real Estate","Research","Sales",null],"description":"Source-stated only; never classified from the title."},{"type":"null","enum":["Accounting","Administrative","Arts and Design","Business Development","Community \u0026 Social Services","Consulting","Customer Success and Support","Education","Engineering","Entrepreneurship","Finance","Healthcare Services","Human Resources","Information Technology","Legal","Marketing","Media and Communication","Military and Protective Services","Operations","Product Management","Program and Project Management","Purchasing","Quality Assurance","Real Estate","Research","Sales",null],"description":"Source-stated only; never classified from the title."}]},"seniority":{"oneOf":[{"type":"string","enum":["In Training","Entry Level","Senior","Strategic","Entry Level Manager","Experienced Manager","Director","Vice President","CXO","Owner / Partner",null],"description":"Source-stated only; never classified from the title."},{"type":"null","enum":["In Training","Entry Level","Senior","Strategic","Entry Level Manager","Experienced Manager","Director","Vice President","CXO","Owner / Partner",null],"description":"Source-stated only; never classified from the title."}]},"yearsOfExperience":{"oneOf":[{"type":"string","enum":["Less than 1 year","1-2 years","3-5 years","6-10 years","11-15 years","16-20 years","20+ years",null],"description":"Overlap-free union of stated positions; null when any start is missing or the stated precision leaves it between two buckets."},{"type":"null","enum":["Less than 1 year","1-2 years","3-5 years","6-10 years","11-15 years","16-20 years","20+ years",null],"description":"Overlap-free union of stated positions; null when any start is missing or the stated precision leaves it between two buckets."}]},"employment":{"type":"array","items":{"type":"object","properties":{"companyName":{"oneOf":[{"type":"string"},{"type":"null"}]},"companyLinkedinUrl":{"oneOf":[{"type":"string"},{"type":"null"}]},"title":{"oneOf":[{"type":"string"},{"type":"null"}]},"start":{"oneOf":[{"type":"object","properties":{"year":{"type":"integer"},"month":{"oneOf":[{"type":"integer","description":"1–12, or null when the source stated the year only (never padded)."},{"type":"null","description":"1–12, or null when the source stated the year only (never padded)."}]}},"required":["year","month"]},{"type":"null","properties":{"year":{"type":"integer"},"month":{"oneOf":[{"type":"integer","description":"1–12, or null when the source stated the year only (never padded)."},{"type":"null","description":"1–12, or null when the source stated the year only (never padded)."}]}},"required":["year","month"]}]},"end":{"oneOf":[{"type":"object","properties":{"year":{"type":"integer"},"month":{"oneOf":[{"type":"integer","description":"1–12, or null when the source stated the year only (never padded)."},{"type":"null","description":"1–12, or null when the source stated the year only (never padded)."}]}},"required":["year","month"]},{"type":"null","properties":{"year":{"type":"integer"},"month":{"oneOf":[{"type":"integer","description":"1–12, or null when the source stated the year only (never padded)."},{"type":"null","description":"1–12, or null when the source stated the year only (never padded)."}]}},"required":["year","month"]}]},"current":{"type":"boolean"},"location":{"oneOf":[{"type":"string","description":"Where the position was held, as the source stated it."},{"type":"null","description":"Where the position was held, as the source stated it."}]},"description":{"oneOf":[{"type":"string","description":"The person's own description of the position, as stated."},{"type":"null","description":"The person's own description of the position, as stated."}]}},"required":["companyName","companyLinkedinUrl","title","start","end","current","location","description"]},"description":"Source order; [] when not available."},"education":{"type":"array","items":{"type":"object","properties":{"school":{"oneOf":[{"type":"string"},{"type":"null"}]},"schoolLinkedinUrl":{"oneOf":[{"type":"string"},{"type":"null"}]},"degree":{"oneOf":[{"type":"string"},{"type":"null"}]},"field":{"oneOf":[{"type":"string"},{"type":"null"}]},"start":{"oneOf":[{"type":"object","properties":{"year":{"type":"integer"},"month":{"oneOf":[{"type":"integer","description":"1–12, or null when the source stated the year only (never padded)."},{"type":"null","description":"1–12, or null when the source stated the year only (never padded)."}]}},"required":["year","month"]},{"type":"null","properties":{"year":{"type":"integer"},"month":{"oneOf":[{"type":"integer","description":"1–12, or null when the source stated the year only (never padded)."},{"type":"null","description":"1–12, or null when the source stated the year only (never padded)."}]}},"required":["year","month"]}]},"end":{"oneOf":[{"type":"object","properties":{"year":{"type":"integer"},"month":{"oneOf":[{"type":"integer","description":"1–12, or null when the source stated the year only (never padded)."},{"type":"null","description":"1–12, or null when the source stated the year only (never padded)."}]}},"required":["year","month"]},{"type":"null","properties":{"year":{"type":"integer"},"month":{"oneOf":[{"type":"integer","description":"1–12, or null when the source stated the year only (never padded)."},{"type":"null","description":"1–12, or null when the source stated the year only (never padded)."}]}},"required":["year","month"]}]}},"required":["school","schoolLinkedinUrl","degree","field","start","end"]},"description":"Source order; [] when not available."},"historyStatus":{"type":"object","properties":{"employment":{"type":"string","enum":["available","not-yet-available"],"description":"`not-yet-available`: no source has supplied this history yet (the list is []). `available` with [] means the source supplied an empty history."},"education":{"type":"string","enum":["available","not-yet-available"],"description":"`not-yet-available`: no source has supplied this history yet (the list is []). `available` with [] means the source supplied an empty history."}},"required":["employment","education"]}},"isRequired":true,"uniqueKey":"data.results.\\items.items.[INDEX].oneOf.0.person.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"data.results.\\items.items.[INDEX].oneOf.0.person","typeLabel":"object | null"}},"uniqueKey":"data.results.\\items.items.[INDEX].oneOf.0","typeLabel":"object"},{"type":"object","required":["id","position","sourcePage","erased"],"properties":{"id":{"type":"string","description":"Stable id of this delivered result row.","isRequired":true,"uniqueKey":"data.results.\\items.items.[INDEX].oneOf.1.id","typeLabel":"string"},"position":{"type":"integer","description":"0-based delivery position within the run.","isRequired":true,"uniqueKey":"data.results.\\items.items.[INDEX].oneOf.1.position","typeLabel":"integer"},"sourcePage":{"oneOf":[{"type":"integer","description":"The source page that delivered the row; null on older rows.","isRequired":true,"uniqueKey":"data.results.\\items.items.[INDEX].oneOf.1.sourcePage.oneOf.0","typeLabel":"integer"},{"type":"null","description":"The source page that delivered the row; null on older rows.","isRequired":true,"uniqueKey":"data.results.\\items.items.[INDEX].oneOf.1.sourcePage.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"data.results.\\items.items.[INDEX].oneOf.1.sourcePage","typeLabel":"integer | null"},"erased":{"type":"boolean","enum":[true],"description":"Removed at the person's request: no personal data is served.","isRequired":true,"uniqueKey":"data.results.\\items.items.[INDEX].oneOf.1.erased","typeLabel":"enum\u003cboolean>"}},"uniqueKey":"data.results.\\items.items.[INDEX].oneOf.1","typeLabel":"object"}],"uniqueKey":"data.results.\\items.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"data.results.\\items","typeLabel":"object[]"}},"required":["page","pageSize","totalDelivered","items"],"isRequired":true,"uniqueKey":"data.results","typeLabel":"object"}},"required":["run","results"],"isRequired":true,"uniqueKey":"data","typeLabel":"object"}},"required":["data"],"uniqueKey":"","typeLabel":"object"},"example":{"data":{"run":{"id":"cmf3x0v2b0001abcd","status":"processing","requestedCount":500,"deliveredCount":175,"sourceExhausted":false,"sourceTotalElements":23000,"sourceTotalPages":100,"sourcePages":[{"page":1,"sourceRows":25,"delivered":24,"notAtCompany":0,"titleNotStated":0,"duplicates":1,"doNotContact":0,"beyondRequested":0}],"continuedFromId":null,"unitCost":1,"maxCost":500,"creditsCharged":null,"error":null,"criteria":{"jobTitle":["Head of Sales"],"location":["Germany"],"headcount":["51-200"]},"createdAt":"2026-09-01T09:00:00.000Z","startedAt":"2026-09-01T09:00:02.000Z","finishedAt":null},"results":{"page":1,"pageSize":25,"totalDelivered":175,"items":[{"id":"cmf3x1a9k0007abcd","position":0,"sourcePage":1,"name":"Holger Frank","title":"Head Of Sales","company":"Sales People GmbH","location":"Mannheim, Baden-Württemberg, Germany","industry":null,"linkedinUrl":"https://www.linkedin.com/in/ACwAADQwgVsBH0t8Ns1HcaFODvoUSy9rtijQwPk","publicIdentifier":null,"revealedEmail":null,"revealedEmailStatus":null,"revealedEarlier":false,"companyProfile":{"name":"Sales People GmbH","linkedinUrl":null,"tagline":null,"description":null,"industry":null,"employeeBand":null,"employeeCount":null,"followerCount":null,"websiteUrl":null,"websiteDomain":null,"headquarters":null,"hqLocality":null,"hqRegion":null,"hqCountry":null,"foundedYear":null,"companyType":null,"specialties":[],"logoUrl":null,"logoImageUrl":null,"phone":null,"email":null,"xUrl":null,"facebookUrl":null,"instagramUrl":null,"youtubeUrl":null,"confirmedAt":null}}]}}},"examples":{"Example":{"title":"Example","value":{"data":{"run":{"id":"cmf3x0v2b0001abcd","status":"processing","requestedCount":500,"deliveredCount":175,"sourceExhausted":false,"sourceTotalElements":23000,"sourceTotalPages":100,"sourcePages":[{"page":1,"sourceRows":25,"delivered":24,"notAtCompany":0,"titleNotStated":0,"duplicates":1,"doNotContact":0,"beyondRequested":0}],"continuedFromId":null,"unitCost":1,"maxCost":500,"creditsCharged":null,"error":null,"criteria":{"jobTitle":["Head of Sales"],"location":["Germany"],"headcount":["51-200"]},"createdAt":"2026-09-01T09:00:00.000Z","startedAt":"2026-09-01T09:00:02.000Z","finishedAt":null},"results":{"page":1,"pageSize":25,"totalDelivered":175,"items":[{"id":"cmf3x1a9k0007abcd","position":0,"sourcePage":1,"name":"Holger Frank","title":"Head Of Sales","company":"Sales People GmbH","location":"Mannheim, Baden-Württemberg, Germany","industry":null,"linkedinUrl":"https://www.linkedin.com/in/ACwAADQwgVsBH0t8Ns1HcaFODvoUSy9rtijQwPk","publicIdentifier":null,"revealedEmail":null,"revealedEmailStatus":null,"revealedEarlier":false,"companyProfile":{"name":"Sales People GmbH","linkedinUrl":null,"tagline":null,"description":null,"industry":null,"employeeBand":null,"employeeCount":null,"followerCount":null,"websiteUrl":null,"websiteDomain":null,"headquarters":null,"hqLocality":null,"hqRegion":null,"hqCountry":null,"foundedYear":null,"companyType":null,"specialties":[],"logoUrl":null,"logoImageUrl":null,"phone":null,"email":null,"xUrl":null,"facebookUrl":null,"instagramUrl":null,"youtubeUrl":null,"confirmedAt":null}}]}}}}},"exampleType":"examples"}},"exampleType":"examples"},"d009b37d-4b09-42e2-85e5-3412fea46dbe":{"description":"API key missing (`Missing API key. Pass it as: Authorization: Bearer \u003ckey>`), invalid (`Invalid API key`), or expired (`This API key has expired`).","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"}},"required":["message"],"isRequired":true,"uniqueKey":"error","typeLabel":"object"}},"required":["error"],"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":{"message":"\u003cstring>"}}}},"exampleType":"generated"}},"exampleType":"generated"},"9fc68da1-aafa-49eb-8858-d153b29beb51":{"description":"`not_found`: no such run for this workspace — an unknown id or a run of another workspace; identical for both. Employee-search runs (spec 064) are found here too.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","enum":["validation_error","unauthenticated","not_found","forbidden","method_not_allowed","idempotency_conflict","idempotency_in_progress","rate_limited","internal_error","run_already_active","run_already_continued","search_unavailable","invalid_continuation","invalid_input","insufficient_credits","incomplete"],"description":"Machine-readable error code. Branch on this, not on `message`.","isRequired":true,"uniqueKey":"error.code","typeLabel":"enum\u003cstring>"},"message":{"type":"string","description":"Human-readable explanation.","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"},"retryAfterSeconds":{"type":"integer","description":"Present on a 429 only: seconds until the workspace may call again (same value as the `Retry-After` header).","uniqueKey":"error.retryAfterSeconds","typeLabel":"integer"}},"required":["code","message"],"isRequired":true,"uniqueKey":"error","typeLabel":"object"}},"required":["error"],"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":{"code":"validation_error","message":"\u003cstring>","retryAfterSeconds":123}}}},"exampleType":"generated"}},"exampleType":"generated"},"1c826784-0ef6-4bde-8da5-8af6730270e6":{"description":"Method not allowed — see the `Allow` response header.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"}},"required":["message"],"isRequired":true,"uniqueKey":"error","typeLabel":"object"}},"required":["error"],"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":{"message":"\u003cstring>"}}}},"exampleType":"generated"}},"exampleType":"generated"},"5e0e6d47-bc86-4002-af4a-37740143db47":{"description":"Rate limit exceeded for this workspace. Retry after the number of seconds in the `Retry-After` header (60). Rate-limited calls are never billed.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"}},"required":["message"],"isRequired":true,"uniqueKey":"error","typeLabel":"object"}},"required":["error"],"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":{"message":"\u003cstring>"}}}},"exampleType":"generated"}},"exampleType":"generated"},"8f6c207d-c990-4a4b-bb6e-f7b97dce1aef":{"description":"`internal_error`: the read failed on our side.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","enum":["validation_error","unauthenticated","not_found","forbidden","method_not_allowed","idempotency_conflict","idempotency_in_progress","rate_limited","internal_error","run_already_active","run_already_continued","search_unavailable","invalid_continuation","invalid_input","insufficient_credits","incomplete"],"description":"Machine-readable error code. Branch on this, not on `message`.","isRequired":true,"uniqueKey":"error.code","typeLabel":"enum\u003cstring>"},"message":{"type":"string","description":"Human-readable explanation.","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"},"retryAfterSeconds":{"type":"integer","description":"Present on a 429 only: seconds until the workspace may call again (same value as the `Retry-After` header).","uniqueKey":"error.retryAfterSeconds","typeLabel":"integer"}},"required":["code","message"],"isRequired":true,"uniqueKey":"error","typeLabel":"object"}},"required":["error"],"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":{"code":"validation_error","message":"\u003cstring>","retryAfterSeconds":123}}}},"exampleType":"generated"}},"exampleType":"generated"}},"security":{"7a022a61-62b7-46d5-9a4a-7ce59b7762f8":{"workspaceApiKey":{"type":"http","scheme":"bearer","description":"Workspace API key (`loice_sk_` + 48 hex characters), created under Settings → API Keys. Sent as `Authorization: Bearer loice_sk_…`. Invalid, missing, or expired keys are rejected with 401 before any billable work happens.","scopes":[],"schemeName":"workspaceApiKey"}}},"servers":{"695260fa-a90d-430f-9fda-0588978e186c":{"url":"https://app.loice.ai"}},"processedSecurityOptions":[{"schemes":[{"scheme":{"type":"http","scheme":"bearer","description":"Workspace API key (`loice_sk_` + 48 hex characters), created under Settings → API Keys. Sent as `Authorization: Bearer loice_sk_…`. Invalid, missing, or expired keys are rejected with 401 before any billable work happens.","scopes":[],"schemeName":"workspaceApiKey"},"schema":{"title":"Bearer Auth","type":"string","isRequired":true,"description":"Workspace API key (`loice_sk_` + 48 hex characters), created under Settings → API Keys. Sent as `Authorization: Bearer loice_sk_…`. Invalid, missing, or expired keys are rejected with 401 before any billable work happens.","format":"bearer","typeLabel":"string\u003cbearer>","deprecated":false},"schemeName":"workspaceApiKey","name":"Authorization"}],"title":"workspaceApiKey"}]},"originalFileLocation":"openapi.json"},"subdomain":"loice-ai","siteName":"Loice","title":"Poll lead search - Loice","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-11-09T13:15:54.064Z","originalFileLocation":"api-reference/poll-lead-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=\"Returns the status of a lead-search run plus one server page of its delivered results (25 per page — pass ?page= for the rest). Poll it every few seconds while status is queued/processing/cancelling; a terminal status (completed/cancelled/failed) carries the final deliveredCount and creditsCharged. Results already delivered remain readable after the run finishes. #### Billing Free — this endpoint does not consume points.\">\u003cmeta data-mint-head name=\"application-name\" content=\"Loice\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/loice-ai/dsWJfncwTF1mrm64/_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/loice-ai/dsWJfncwTF1mrm64/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/loice-ai/dsWJfncwTF1mrm64/_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/loice-ai/dsWJfncwTF1mrm64/_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/loice-ai/dsWJfncwTF1mrm64/_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/loice-ai/dsWJfncwTF1mrm64/_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/loice-ai/dsWJfncwTF1mrm64/_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/loice-ai/dsWJfncwTF1mrm64/_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/loice-ai/dsWJfncwTF1mrm64/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Poll lead search - Loice\">\u003cmeta data-mint-head property=\"og:description\" content=\"Returns the status of a lead-search run plus one server page of its delivered results (25 per page — pass ?page= for the rest). Poll it every few seconds while status is queued/processing/cancelling; a terminal status (completed/cancelled/failed) carries the final deliveredCount and creditsCharged. Results already delivered remain readable after the run finishes. #### Billing Free — this endpoint does not consume points.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Loice\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.loice.ai/api-reference/poll-lead-search\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://loice-ai.mintlify.site/_mintlify/api/og/v2?division=API+Reference\u0026amp;title=Poll+lead+search\u0026amp;description=Returns+the+status+of+a+lead-search+run+plus+one+server+page+of+its+delivered+results+%2825+per+page+%E2%80%94+pass+%60%3Fpage%3D%60+for+the+rest%29.+Poll+it+every+few+seconds+whil\u0026amp;theme=aaaf477007e472ee8ada61f7\u0026amp;signature=0f518785cb7905ca0e26b4fa6e77e9b3652d88ab94bd1e560ccb1542df85fad0\">\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=\"Poll lead search - Loice\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Returns the status of a lead-search run plus one server page of its delivered results (25 per page — pass ?page= for the rest). Poll it every few seconds while status is queued/processing/cancelling; a terminal status (completed/cancelled/failed) carries the final deliveredCount and creditsCharged. Results already delivered remain readable after the run finishes. #### Billing Free — this endpoint does not consume points.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://loice-ai.mintlify.site/_mintlify/api/og/v2?division=API+Reference\u0026amp;title=Poll+lead+search\u0026amp;description=Returns+the+status+of+a+lead-search+run+plus+one+server+page+of+its+delivered+results+%2825+per+page+%E2%80%94+pass+%60%3Fpage%3D%60+for+the+rest%29.+Poll+it+every+few+seconds+whil\u0026amp;theme=aaaf477007e472ee8ada61f7\u0026amp;signature=0f518785cb7905ca0e26b4fa6e77e9b3652d88ab94bd1e560ccb1542df85fad0\">\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/loice-ai/dsWJfncwTF1mrm64/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Loice\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#ff5a1f\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.loice.ai/api-reference/poll-lead-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/poll-lead-search.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.loice.ai/#organization\",\"name\":\"Loice\",\"url\":\"https://docs.loice.ai\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/loice-ai/BjcqR91eFdyMv2fQ/logo/loice-black.png?fit=max\u0026auto=format\u0026n=BjcqR91eFdyMv2fQ\u0026q=85\u0026s=bec1e804b7d2b4e6090aad41f5ec149e\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.loice.ai#website\",\"name\":\"Loice\",\"url\":\"https://docs.loice.ai\",\"publisher\":{\"@id\":\"https://docs.loice.ai/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.loice.ai/api-reference/poll-lead-search#webpage\",\"url\":\"https://docs.loice.ai/api-reference/poll-lead-search\",\"name\":\"Poll lead search\",\"description\":\"Returns the status of a lead-search run plus one server page of its delivered results (25 per page — pass ?page= for the rest). Poll it every few seconds while status is queued/processing/cancelling; a terminal status (completed/cancelled/failed) carries the final deliveredCount and creditsCharged. Results already delivered remain readable after the run finishes. #### Billing Free — this endpoint does not consume points.\",\"dateModified\":\"2026-11-09T13:15:54.064Z\",\"isPartOf\":{\"@id\":\"https://docs.loice.ai#website\"},\"breadcrumb\":{\"@id\":\"https://docs.loice.ai/api-reference/poll-lead-search#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.loice.ai/api-reference/poll-lead-search#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"API Reference\",\"item\":\"https://docs.loice.ai/api-reference/find-and-verify-email\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Poll lead search\",\"item\":\"https://docs.loice.ai/api-reference/poll-lead-search\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.loice.ai/api-reference/poll-lead-search#apireference\",\"headline\":\"Poll lead search\",\"name\":\"Poll lead search\",\"description\":\"Returns the status of a lead-search run plus one server page of its delivered results (25 per page — pass ?page= for the rest). Poll it every few seconds while status is queued/processing/cancelling; a terminal status (completed/cancelled/failed) carries the final deliveredCount and creditsCharged. Results already delivered remain readable after the run finishes. #### Billing Free — this endpoint does not consume points.\",\"url\":\"https://docs.loice.ai/api-reference/poll-lead-search\",\"mainEntityOfPage\":{\"@id\":\"https://docs.loice.ai/api-reference/poll-lead-search#webpage\"},\"dateModified\":\"2026-11-09T13:15:54.064Z\",\"publisher\":{\"@id\":\"https://docs.loice.ai/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.loice.ai#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Loice\",\"creator\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","siteName":"Loice","nav":{"global":null,"tabs":[{"tab":"Documentation","pages":[{"title":"Documentation","href":""}]},{"tab":"API reference","groups":[{"group":"API Reference","pages":[{"title":"Find and verify email","deprecated":null,"version":null,"openapi":"/openapi.json post /api/v1/find","href":"/api-reference/find-and-verify-email"},{"title":"Enrich an email address","deprecated":null,"version":null,"openapi":"/openapi.json post /api/v1/enrich/email","href":"/api-reference/enrich-an-email-address"},{"title":"Search LinkedIn profiles by name","deprecated":null,"version":null,"openapi":"/openapi.json post /api/v1/linkedin-search","href":"/api-reference/search-linkedin-profiles-by-name"},{"title":"Start lead search","deprecated":null,"version":null,"openapi":"/openapi.json post /api/v1/lead-search","href":"/api-reference/start-lead-search"},{"title":"Start an employee search","description":"Finds the current employees of ONE company, named by its website `domain` or its LinkedIn company URL, optionally filtered by title, seniority, department and location. Creates a **background run** like `POST /api/v1/lead-search` and returns immediately; poll and read it with `GET /api/v1/lead-search/runs/{runId}`. One active run per workspace at a time. Rate limited per workspace.\n\n#### Billing\n\n- once per search, when any source answered; released when every source was unavailable.\n- per delivered employee, debited when the run finalizes; an empty run is free.\n\nThe current cost is shown in the app under Settings → Billing and in the live `GET /api/v1/openapi.json`. Calls that end in a system or provider error (HTTP 500) or are rate limited (HTTP 429) are not billed. The `charged` and `pointsCharged` fields of the response state what this call actually consumed.","deprecated":null,"version":null,"openapi":"/openapi.json post /api/v1/employee-search","href":"/api-reference/start-an-employee-search"},{"title":"Poll lead search","deprecated":null,"version":null,"openapi":"/openapi.json get /api/v1/lead-search/runs/{runId}","href":"/api-reference/poll-lead-search"},{"title":"Cancel lead search","description":"Stops a lead-search or employee-search run (spec 044, the same contract as the web screen). A `queued` run ends `cancelled` at once and charges nothing; a `processing` run answers `cancelling` and stops at its next page, charging only the leads already delivered. A repeat answers the same; a finished run answers `already-terminal`. Nothing is fetched or billed after the answer beyond rows already delivered.\n\n#### Billing\n\nFree — this endpoint does not consume points.","deprecated":null,"version":null,"openapi":"/openapi.json post /api/v1/lead-search/runs/{runId}/cancel","href":"/api-reference/cancel-lead-search"},{"title":"List lead lists","deprecated":null,"version":null,"openapi":"/openapi.json get /api/v1/lead-lists","href":"/api-reference/list-lead-lists"},{"title":"Save lead-search results to a list","deprecated":null,"version":null,"openapi":"/openapi.json post /api/v1/lead-lists/add","href":"/api-reference/save-lead-search-results-to-a-list"},{"title":"Read a list’s members","deprecated":null,"version":null,"openapi":"/openapi.json get /api/v1/lead-lists/{listId}/members","href":"/api-reference/read-a-list’s-members"},{"title":"Check the points balance","deprecated":null,"version":null,"openapi":"/openapi.json get /api/v1/points","href":"/api-reference/check-the-points-balance"},{"title":"This API description","deprecated":null,"version":null,"openapi":"/openapi.json get /api/v1/openapi.json","href":"/api-reference/this-api-description"}]}]}]},"basePath":"","title":"Poll lead search - Loice","buildId":"dpl_42LwxxU1kGN114H4XzwGYXa9ZDah","deploymentId":"dpl_42LwxxU1kGN114H4XzwGYXa9ZDah","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-C-hEh3I2.js","utils-CnF4QiUD.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-C7PVNbel.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-8ytevL2A.js","snippetPresets-BT1alx3v.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","conditional-requirements-CFM0id0Q.js","ApiExamples-BLXC0i_W.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-CyLIGI9_.js","shallow-DC0lGVIW.js","getApiPlaygroundDisplay-CgDQ85tN.js","CodeSnippet-6-I-Gpv9.js","CodeSnippets-BAk1kDdu.js","Page-C945cI-W.js","getPastedJson-B276RuWN.js","icon-BqP8etTm.js","MethodPill-DM6sbxG1.js","DuplicateIcon-PyJglOaE.js","createIcon-CMeOMAc_.js","DynamicMarkdown-BoyYAA8K.js","SectionHeading-DAYv3gvZ.js","axios-vUo_bRtp.js","Markdown-BhTTmazV.js","clsx-CR-RHrVC.js","lib-DuNMoZ05.js","lib-B8HbPgcC.js","html-void-elements-mCSPHezU.js","dist-CBUH0-zX.js","katex-YMM-FMeD.js","marked.esm-CZWythHk.js","AssistantPageLink-BmARFYNC.js"]}