Intakra Opportunities API

openapi: 3.2.0
info:
  title: Intakra REST Opportunities 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: []
tags:
- name: Opportunities
paths:
  /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
      tags:
      - Opportunities
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.