{"openapi":"3.1.0","info":{"title":"Intakra REST API","version":"3.2.0","summary":"Read the leads Intakra found for one workspace.","description":"Read-only access to one Intakra workspace: today's note, open leads and tracked accounts. Leads are public, dated proof about a company on the list, with the quote and its source; what it usually means is an interpretation, not confirmed buying intent. Authenticate with a workspace API key. AI assistants can use the MCP server instead (see the API catalog).","contact":{"email":"hello@intakra.com","url":"https://intakra.com/support"},"termsOfService":"https://intakra.com/terms"},"servers":[{"url":"https://intakra.com"}],"security":[{"apiKey":[]}],"components":{"securitySchemes":{"apiKey":{"type":"http","scheme":"bearer","description":"A workspace API key (ik_live_...). A workspace member creates it in Settings, API and MCP; it is shown once and can be revoked there."}}},"paths":{"/api/v1/brief":{"get":{"operationId":"getBrief","summary":"Today's note","description":"The accounts in today's note (status sent), or, when no note went out yet today, the ones the next note would hold (status next). Quiet days return status none and no items. Same data as the MCP tool get_daily_brief.","responses":{"200":{"description":"Today's note.","content":{"application/json":{"schema":{"type":"object","required":["as_of","status","items","note"],"properties":{"as_of":{"type":"string","format":"date-time"},"status":{"type":"string","enum":["sent","next","none"]},"items":{"type":"array","items":{"type":"object","properties":{"opportunity_id":{"type":"string","description":"Lead id (eop_...), a match of the workspace's own rule (rh_...) or of one of its buying signals (dh_...)."},"item_kind":{"type":"string","enum":["opportunity","rule_hit","signal_hit"]},"account_id":{"type":"string"},"company":{"type":"string"},"domain":{"type":["string","null"]},"headline":{"type":"string"},"what_we_found":{"type":"array","description":"The dated public proof, each with a link to its source when there is one.","items":{"type":"object","properties":{"text":{"type":"string"},"url":{"type":["string","null"]},"checked":{"type":["string","null"]},"dated":{"type":"string","description":"For a buying signal match: how the source dates the quote, such as published Oct 3."}}}},"what_it_usually_means_for_you":{"type":"string"},"who_to_reach":{"type":"array","items":{"type":"string"}},"why_them":{"type":["string","null"]},"timing":{"type":"string","description":"Empty for a buying signal match whose line states no time frame."},"usually_winds_down_by":{"type":"string","format":"date"},"best_contact":{"type":["object","null"],"description":"The person named for the lead, when one is. Never an email for EU, EEA or UK companies.","properties":{"name":{"type":["string","null"]},"title":{"type":["string","null"]},"linkedin_url":{"type":["string","null"]},"email":{"type":["string","null"]},"email_grade":{"type":"string"},"why":{"type":"string"},"source":{"type":"string"}}},"signal_id":{"type":["string","null"],"description":"The buying signal line this matches, or null for a lead. Present when buying signals are switched on for the workspace."},"signal_label":{"type":["string","null"],"description":"That line in the workspace's own words. Present when buying signals are switched on for the workspace."},"quote":{"type":["string","null"],"description":"The verbatim words from the source, when we have them. Present when buying signals are switched on for the workspace."},"source_url":{"type":["string","null"],"description":"The link the quote is on. Present when buying signals are switched on for the workspace."}}}},"note":{"type":"string"}}}}}},"401":{"description":"Missing, invalid or revoked API key, or a workspace that has not added its card yet.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"}}}}}},"402":{"description":"The workspace came through the trial setup and has not added its card yet.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"}}}}}}}}},"/api/v1/opportunities":{"get":{"operationId":"listOpportunities","summary":"Open leads","description":"Open leads, highest priority first. Only leads that pass the same quality gate as the email are listed; held counts the ones held back. When buying signals are switched on for the workspace, open matches of its buying signals are listed too (item_kind signal_hit), each with its quote and source.","parameters":[{"name":"limit","in":"query","schema":{"type":"integer","minimum":1,"maximum":200,"default":50}},{"name":"closing_within_days","in":"query","description":"Only leads that usually wind down within this many days.","schema":{"type":"integer","minimum":1,"maximum":365}}],"responses":{"200":{"description":"Open leads.","content":{"application/json":{"schema":{"type":"object","required":["opportunities","held"],"properties":{"opportunities":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"company":{"type":"string"},"domain":{"type":["string","null"]},"headline":{"type":"string"},"why_now":{"type":"string"},"what_they_buy":{"type":"string"},"motion":{"type":["string","null"],"description":"The kind of project, in plain words. Null for a buying signal match."},"stage":{"type":["string","null"],"enum":["planning","hiring","evaluating","buying","implementing","stale",null],"description":"Null for a buying signal match."},"confidence":{"type":"number"},"priority":{"type":"number"},"window_opens_at":{"type":"string","format":"date-time"},"window_peaks_at":{"type":"string","format":"date-time"},"window_closes_at":{"type":"string","format":"date-time"},"evidence_count":{"type":"integer"},"first_evidence_at":{"type":"string","format":"date-time"},"item_kind":{"type":"string","enum":["opportunity","signal_hit"],"description":"Present when buying signals are switched on for the workspace."},"signal_id":{"type":["string","null"],"description":"The buying signal line this matches, or null for a lead. Present when buying signals are switched on for the workspace."},"signal_label":{"type":["string","null"],"description":"That line in the workspace's own words. Present when buying signals are switched on for the workspace."},"quote":{"type":["string","null"],"description":"The verbatim words from the source, when we have them. Present when buying signals are switched on for the workspace."},"source_url":{"type":["string","null"],"description":"The link the quote is on. Present when buying signals are switched on for the workspace."}}}},"held":{"type":"integer","description":"Leads checked but held back by the quality gate."}}}}}},"401":{"description":"Missing, invalid or revoked API key, or a workspace that has not added its card yet.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"}}}}}},"402":{"description":"The workspace came through the trial setup and has not added its card yet.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"}}}}}}}}},"/api/v1/accounts":{"get":{"operationId":"listAccounts","summary":"Tracked accounts","description":"Tracked accounts, highest heat first, each with its top open lead. Suggested accounts that were not approved are left out.","parameters":[{"name":"limit","in":"query","schema":{"type":"integer","minimum":1,"maximum":100,"default":25}}],"responses":{"200":{"description":"Tracked accounts.","content":{"application/json":{"schema":{"type":"object","required":["accounts"],"properties":{"accounts":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"domain":{"type":["string","null"]},"industry":{"type":["string","null"]},"heat":{"type":["integer","null"],"minimum":0,"maximum":100},"fit":{"type":["number","null"],"description":"Present when the account score is on for the workspace."},"timing":{"type":["number","null"],"description":"Present when the account score is on for the workspace."},"reach":{"type":["number","null"],"description":"Present when the account score is on for the workspace."},"top_opportunity":{"type":["object","null"],"properties":{"id":{"type":"string"},"headline":{"type":"string"},"project_type":{"type":"string"},"priority":{"type":"number"},"found_at":{"type":"string","format":"date-time"},"usually_winds_down_by":{"type":"string","format":"date"}}}}}}}}}}},"401":{"description":"Missing, invalid or revoked API key, or a workspace that has not added its card yet.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"}}}}}}}}}}}