> ## Documentation Index
> Fetch the complete documentation index at: https://docs.rapportapi.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Get Research

> Poll a research task by ID. Returns the current status and, when completed, the full intelligence report with icebreakers, communication style, and background data.



## OpenAPI

````yaml GET /research/{task_id}
openapi: 3.1.0
info:
  title: RapportAPI
  description: >-
    Sales intelligence API. Submit a person's identifier and receive deep
    intelligence reports with icebreakers, communication style guides, and
    background research.
  version: 1.0.0
  contact:
    name: RapportAPI Support
    email: support@rapportapi.com
    url: https://rapportapi.com
servers:
  - url: https://api.rapportapi.com
    description: Production
security:
  - bearerAuth: []
paths:
  /research/{task_id}:
    get:
      summary: Get research status and results
      description: >-
        Poll a research task by ID. Returns the current status and, when
        completed, the full intelligence report with icebreakers, communication
        style, and background data.
      operationId: getResearch
      parameters:
        - name: task_id
          in: path
          required: true
          description: The task ID returned from POST /research
          schema:
            type: string
            format: uuid
      responses:
        '200':
          description: Task status and results
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ResearchResult'
        '401':
          description: Authentication failed
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '404':
          description: Task not found
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
              example:
                detail: Task not found
                status_code: 404
components:
  schemas:
    ResearchResult:
      type: object
      properties:
        task_id:
          type: string
          format: uuid
        status:
          type: string
          enum:
            - pending
            - running
            - completed
            - failed
          description: Current task status
        prospect_id:
          type: string
          nullable: true
        created_at:
          type: string
          format: date-time
        started_at:
          type: string
          format: date-time
          nullable: true
        completed_at:
          type: string
          format: date-time
          nullable: true
        processing_time_seconds:
          type: number
          nullable: true
        report_url:
          type: string
          format: uri
          nullable: true
          description: Public URL to the HTML report (only when completed)
        result:
          $ref: '#/components/schemas/IntelligenceReport'
        error:
          type: string
          nullable: true
          description: Error message (only when failed)
    Error:
      type: object
      properties:
        detail:
          type: string
          description: Human-readable error message
        status_code:
          type: integer
          description: HTTP status code
    IntelligenceReport:
      type: object
      nullable: true
      description: Full intelligence report (only present when status is 'completed')
      properties:
        status:
          type: string
          enum:
            - success
            - partial
            - error
        overall_confidence:
          type: string
          enum:
            - HIGH
            - MEDIUM
            - LOW
            - UNKNOWN
        outreach_intelligence:
          type: object
          description: Actionable sales intelligence
          properties:
            icebreakers:
              type: array
              items:
                $ref: '#/components/schemas/Icebreaker'
            communication_style:
              type: string
              description: How to communicate with this person
            best_approach:
              type: string
              description: Recommended outreach approach
            topics_to_avoid:
              type: array
              items:
                type: string
              description: Sensitive topics to steer clear of
        professional:
          type: object
          properties:
            current_title:
              type: string
              nullable: true
            current_company:
              type: string
              nullable: true
            current_location:
              type: string
              nullable: true
            industry:
              type: string
              nullable: true
            skills:
              type: array
              items:
                type: string
            achievements:
              type: array
              items:
                type: string
        personal:
          type: object
          properties:
            interests:
              type: array
              items:
                type: string
            hobbies:
              type: array
              items:
                type: string
            sports_teams:
              type: array
              items:
                type: string
            causes:
              type: array
              items:
                type: string
            memberships:
              type: array
              items:
                type: string
        education:
          type: object
          properties:
            entries:
              type: array
              items:
                type: object
                properties:
                  institution:
                    type: string
                  degree:
                    type: string
                    nullable: true
                  field_of_study:
                    type: string
                    nullable: true
                  graduation_year:
                    type: integer
                    nullable: true
            certifications:
              type: array
              items:
                type: string
        family:
          type: object
          properties:
            children_count:
              type: integer
              nullable: true
            pets:
              type: array
              items:
                type: string
        social_media:
          type: object
          properties:
            linkedin:
              type: object
              properties:
                url:
                  type: string
                  nullable: true
                bio:
                  type: string
                  nullable: true
                post_count:
                  type: integer
                posts_summary:
                  type: string
                  nullable: true
            twitter:
              type: object
              properties:
                url:
                  type: string
                  nullable: true
                bio:
                  type: string
                  nullable: true
                twitter_posts_summary:
                  type: string
                  nullable: true
    Icebreaker:
      type: object
      properties:
        angle:
          type: string
          description: The topic angle (e.g., 'Marathon Runner', 'Youth Baseball Coach')
        opening_line:
          type: string
          description: Ready-to-use opening line for outreach
        why_effective:
          type: string
          description: Why this icebreaker works for this person
        source_type:
          type: string
          description: Where the insight was sourced from
        confidence:
          type: string
          enum:
            - HIGH
            - MEDIUM
            - LOW
        topic_category:
          type: string
          description: Category (e.g., 'personal_interests', 'professional', 'community')
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      description: API key with rapi_live_ prefix

````