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

# Get Account Research Report

> One account research report, its buyers and the warm paths into them

One account research report: the warm buyers at the company, each with its intro paths (which
connector, through which shared company, how long they overlapped), then the cold buyers, who
have no warm path, the alumni, the organization map and the best first move.

Warm buyers come a page at a time with `page` and `page_size`, cold buyers with `cold_page` and
`cold_page_size`; a page holds 50 by default. Take the report's `abs_report_id` from
[List Account Research Reports](https://docs.clustr-ai.com/api-reference/list-account-research-reports.md). For every buyer
at once, as rows or as a CSV file, use
[Export Account Research Report](https://docs.clustr-ai.com/api-reference/export-account-research-report.md).

```bash cURL theme={null}
curl "https://api.clustr-ai.com/v2/abs_reports/abs_.../detail?page=1&page_size=20" \
  -H "Authorization: Bearer YOUR_API_KEY"
```


## OpenAPI

````yaml GET /v2/abs_reports/{abs_report_id}/detail
openapi: 3.1.0
info:
  title: Clustr API
  description: >
    Programmatic access to your Clustr network: import connectors, search warm
    intros, and manage target accounts.


    ## Authentication

    All endpoints require a Bearer token (API key) in the `Authorization`
    header.


    ```

    Authorization: Bearer <your_api_key>

    ```


    API keys can be created and managed from the [API settings
    page](https://app.clustr-ai.com/api).
  version: '2.0'
  contact:
    name: Clustr Support
    url: https://clustr-ai.com
servers:
  - url: https://api.clustr-ai.com
    description: Production
security:
  - BearerAuth: []
paths:
  /v2/abs_reports/{abs_report_id}/detail:
    get:
      tags:
        - Account Research
      summary: Get Account Research Report
      description: >
        One account research report: the warm buyers at the company, a page at a
        time, each with

        its intro paths, then the cold buyers (no warm path), a page at a time,
        the alumni, the

        organization map and the best first move.
      operationId: getAbsReportDetail
      parameters:
        - name: abs_report_id
          in: path
          required: true
          schema:
            type: string
        - $ref: '#/components/parameters/Page'
        - name: page_size
          in: query
          required: false
          description: Default 50.
          schema:
            type: integer
        - name: cold_page
          in: query
          required: false
          description: The cold buyers' page, 1-based; default 1.
          schema:
            type: integer
        - name: cold_page_size
          in: query
          required: false
          description: Default 50.
          schema:
            type: integer
      responses:
        '200':
          description: Typed result envelope.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ABSReportDetailV2ResponseEnvelope'
              example:
                success: true
                data:
                  report:
                    id: ac149745-bb7c-40ef-a799-e9e7488dc50e
                    job_id: fae8ac62-87d2-4680-a223-9a571db8538b
                    target_company_name: Northwind Logistics
                    target_company_linkedin_url: https://www.linkedin.com/company/northwind-logistics
                    target_company_numeric_id: '18472301'
                    target_company_industry: Transportation & Logistics
                    target_company_employee_count: 320
                    search_params:
                      company_linkedin_url: https://www.linkedin.com/company/northwind-logistics
                      company_name: Northwind Logistics
                      location_filter: France
                      company_url: >-
                        https://app.clustr-ai.com/accounts/acc_0ewr9dy46v0c75h0nkrb1qvpxy
                      country: France
                      job_titles:
                        - VP Sales
                    employees_searched: 320
                    employees_processed: 320
                    intros_discovered: 12
                    unique_contacts: 12
                    avg_confidence_score: 0.82
                    report_data:
                      job_id: fae8ac62-87d2-4680-a223-9a571db8538b
                      company:
                        name: Northwind Logistics
                        linkedin_url: https://www.linkedin.com/company/northwind-logistics
                        numeric_id: 2ed206b6-9fe9-4fb0-a190-7bed61ccd11a
                        industry: Transportation & Logistics
                        employee_count: 320
                      search_params:
                        company_linkedin_url: https://www.linkedin.com/company/northwind-logistics
                        company_name: Northwind Logistics
                        location_filter: France
                        company_url: >-
                          https://app.clustr-ai.com/accounts/acc_0ewr9dy46v0c75h0nkrb1qvpxy
                        country: France
                        job_titles:
                          - VP Sales
                      employees_searched: 320
                      employees_processed: 320
                      paths_discovered: 12
                      unique_contacts: 12
                      avg_confidence_score: 0.82
                      executive_summary: >-
                        Northwind Logistics is renewing its fleet software in
                        Q1; two connectors know the buyer.
                      employees:
                        - linkedin_id: thomas-lefevre-4b2a1
                          name: Thomas Lefevre
                          title: Head of Procurement
                          headline: Head of Procurement at Northwind Logistics
                          profile_url: >-
                            https://app.clustr-ai.com/accounts/acc_0ewr9dy46v0c75h0nkrb1qvpxy
                          location: Lyon, France
                          intro_paths:
                            - contact_linkedin_id: thomas-lefevre-4b2a1
                              contact_name: Thomas Lefevre
                              path_type: colleague
                              shared_company: Acme Analytics
                              overlap_months: 18
                              confidence_score: 0.82
                              engagement_count: 3
                              contact_job_title: Thomas Lefevre
                              employee_job_title: Director of Engineering
                              contact_location: Lyon, France
                              employee_location: Lyon, France
                              overlap_start_ym: 12
                              overlap_end_ym: 12
                              is_current_overlap: true
                              same_location: true
                              company_linkedin_url: >-
                                https://www.linkedin.com/company/northwind-logistics
                              has_recommendation: true
                              location_match_type: city
                              clustr_contact_person_id: per_2yc54rt9319363snmzhte7gje4
                          validated: true
                          prospect_count: 3
                          clustr_person_id: per_2yc54rt9319363snmzhte7gje4
                      generated_at: '2026-11-03T09:14:22Z'
                      path_enrichments:
                        enrichments_1:
                          tier: Tier 1
                          reason: On your target list
                          enriched_at: '2026-11-12T07:45:00Z'
                          retry_count: 3
                    executive_summary: >-
                      Northwind Logistics is renewing its fleet software in Q1;
                      two connectors know the buyer.
                    status: active
                    created_at: '2026-09-30T12:00:00Z'
                    completed_at: '2026-09-30T12:00:00Z'
                    warm_buyer_count: 3
                    cold_buyer_count: 3
                    clustr_account_research_id: abs_45b7erb6y82qzjdkahw00m1695
                    clustr_job_id: job_6jwhwv3wycsebzfq0fxnw7gpbb
                    clustr_target_account_id: tacc_7490xf0kzqpzqpvv870g97bvyz
                    clustr_workspace_id: ten_5qjvdvcsf461e94cymeffggcdg
                  buyers:
                    - linkedin_id: thomas-lefevre-4b2a1
                      name: Thomas Lefevre
                      title: Head of Procurement
                      headline: Head of Procurement at Northwind Logistics
                      profile_url: >-
                        https://app.clustr-ai.com/accounts/acc_0ewr9dy46v0c75h0nkrb1qvpxy
                      picture_url: >-
                        https://media.licdn.com/dms/image/v2/D4E03AQ/profile-displayphoto-shrink_200_200/0/1700000000000
                      location: Lyon, France
                      intro_count: 3
                      seniority_level: Head
                      best_path:
                        contact_name: Thomas Lefevre
                        contact_linkedin_id: thomas-lefevre-4b2a1
                        contact_picture_url: >-
                          https://media.licdn.com/dms/image/v2/D4E03AQ/profile-displayphoto-shrink_200_200/0/1700000000000
                        contact_profile_url: >-
                          https://app.clustr-ai.com/accounts/acc_0ewr9dy46v0c75h0nkrb1qvpxy
                        confidence: 0.82
                        path_type: colleague
                        shared_company: Acme Analytics
                        overlap_months: 18
                        last_activity_at: '2026-10-28T16:02:05Z'
                        overlap_duration: 3 years
                        last_activity: '2026-11-03T09:14:22Z'
                        clustr_contact_person_id: per_2yc54rt9319363snmzhte7gje4
                      intros:
                        - contact_linkedin_id: jameswalker
                          contact_name: James Walker
                          contact_headline: Director of Engineering at Northwind Logistics
                          contact_job_title: James Walker
                          contact_company: James Walker
                          contact_picture_url: >-
                            https://media.licdn.com/dms/image/v2/D4E03AQ/profile-displayphoto-shrink_200_200/0/1700000000000
                          contact_profile_url: >-
                            https://app.clustr-ai.com/accounts/acc_0ewr9dy46v0c75h0nkrb1qvpxy
                          confidence: 0.82
                          path_type: colleague
                          shared_company: Acme Analytics
                          overlap_months: 18
                          overlap_start_ym: 12
                          overlap_end_ym: 12
                          is_current_overlap: true
                          overlap_duration: 3 years
                          overlap_period: 2019-2022
                          contact_role_at_shared: James Walker
                          buyer_role_at_shared: Account Manager
                          contact_location: Lyon, France
                          buyer_location: Lyon, France
                          same_location: true
                          same_country: true
                          contact_role_seq:
                            - title: Director of Engineering
                              company: Northwind Logistics
                              company_domain: northwind.io
                              location: Lyon, France
                              function: Engineering
                              start_ym: 12
                              end_ym: 12
                              is_current: true
                              start_year: 2011
                              end_year: 2011
                          buyer_role_seq:
                            - title: Director of Engineering
                              company: Northwind Logistics
                              company_domain: northwind.io
                              location: Lyon, France
                              function: Engineering
                              start_ym: 12
                              end_ym: 12
                              is_current: true
                              start_year: 2011
                              end_year: 2011
                          contact_loc_seq:
                            - location: Lyon, France
                              country: France
                              start_ym: 12
                              end_ym: 12
                              start_year: 2011
                              end_year: 2011
                          buyer_loc_seq:
                            - location: Lyon, France
                              country: France
                              start_ym: 12
                              end_ym: 12
                              start_year: 2011
                              end_year: 2011
                          has_recommendation: true
                          engagement_count: 3
                          last_activity_at: '2026-11-12T07:45:00Z'
                          last_activity: '2026-11-03T09:14:22Z'
                          engagements:
                            - type: email
                              subtype: post
                              direction: outbound
                              label: Warm intro
                              at: '2026-11-03T09:14:22Z'
                              at_formatted: 3 Nov 2026, 09:14
                              url: >-
                                https://app.clustr-ai.com/accounts/acc_0ewr9dy46v0c75h0nkrb1qvpxy
                              comment_text: Congratulations on the launch!
                              post_content_preview: >-
                                We just opened our Lyon warehouse and are hiring
                                40 people.
                              post_author_name: Alex Martin
                              post_type: text
                              post_media_type: image
                              post_like_count: 3
                              post_comment_count: 3
                              post_share_count: 3
                          contact_crm_info:
                            crm_provider: hubspot
                            crm_contact_id: ff702f91-7375-44d7-afe8-414d3793fca7
                            email: james.walker@northwind.io
                            full_name: James Walker
                            job_title: Director of Engineering
                            company_name: Northwind Logistics
                            phone: +33 4 72 10 20 30
                            last_activity_date: '2026-09-30T12:00:00Z'
                            last_activity_type: email
                            owner_id: 971f2c4e-2eda-4600-a7bd-c55ef8f21680
                            owner_email: alex.martin@halden.io
                            owner_name: Alex Martin
                            lifecycle_stage: customer
                            recent_activities:
                              - crm_activity_id: 1533c8d7-536b-49cd-a4ba-beeff07caadb
                                activity_type: email
                                activity_date: '2026-10-28T16:02:05Z'
                                subject: Intro call with Northwind
                                activity_direction: outbound
                                activity_status: completed
                                activity_outcome: connected
                                duration_minutes: 30
                                body_preview: >-
                                  Hi Sofia, would you introduce me to Thomas at
                                  Northwind Logistics?
                                thread_count: 3
                            recent_deals:
                              - crm_deal_id: 881a8b46-d40e-4f64-ae8f-33ae45bc3288
                                deal_name: James Walker
                                amount: 48000
                                currency: EUR
                                stage: Negotiation
                                pipeline: Sales pipeline
                                close_date: '2026-10-28T16:02:05Z'
                                is_closed: true
                                is_closed_won: true
                          intro_tier: Tier 1
                          is_borderline_warm: true
                          relevance_reason: Leads procurement at a target account
                          period_level: year
                          role_level: VP
                          geo_level: city
                          contact_owner:
                            user_id: 971f2c4e-2eda-4600-a7bd-c55ef8f21680
                            email: alex.martin@halden.io
                            first_name: Alex
                            last_name: Martin
                            clustr_owner_id: own_4dw2w1ads69pkcq2vsawkz5thg
                          contact_tags:
                            - id: 843ba873-6577-4a34-ab37-f193509a2df9
                              name: James Walker
                              color: '#3B82F6'
                              clustr_tag_id: tag_2cj1rf29pmpwncwm5v68vxwzw6
                          clustr_contact_person_id: per_3s9v3yby6q6dj5jwq7whsz56pm
                      crm_info:
                        crm_provider: hubspot
                        crm_contact_id: ff702f91-7375-44d7-afe8-414d3793fca7
                        email: thomas.lefevre@northwind.io
                        full_name: Thomas Lefevre
                        job_title: Head of Procurement
                        company_name: Northwind Logistics
                        phone: +33 4 72 10 20 30
                        last_activity_date: '2026-10-28T16:02:05Z'
                        last_activity_type: email
                        owner_id: 971f2c4e-2eda-4600-a7bd-c55ef8f21680
                        owner_email: alex.martin@halden.io
                        owner_name: Alex Martin
                        lifecycle_stage: customer
                        recent_activities:
                          - crm_activity_id: 1533c8d7-536b-49cd-a4ba-beeff07caadb
                            activity_type: email
                            activity_date: '2026-09-30T12:00:00Z'
                            subject: Intro call with Northwind
                            activity_direction: outbound
                            activity_status: completed
                            activity_outcome: connected
                            duration_minutes: 30
                            body_preview: >-
                              Hi Sofia, would you introduce me to Thomas at
                              Northwind Logistics?
                            thread_count: 3
                        recent_deals:
                          - crm_deal_id: 881a8b46-d40e-4f64-ae8f-33ae45bc3288
                            deal_name: Thomas Lefevre
                            amount: 48000
                            currency: EUR
                            stage: Negotiation
                            pipeline: Sales pipeline
                            close_date: '2026-09-30T12:00:00Z'
                            is_closed: true
                            is_closed_won: true
                      intro_tier: Tier 1
                      clustr_person_id: per_2yc54rt9319363snmzhte7gje4
                  cold_buyers:
                    - linkedin_id: thomas-lefevre-4b2a1
                      name: Thomas Lefevre
                      title: Head of Procurement
                      headline: Head of Procurement at Northwind Logistics
                      profile_url: >-
                        https://app.clustr-ai.com/accounts/acc_0ewr9dy46v0c75h0nkrb1qvpxy
                      picture_url: >-
                        https://media.licdn.com/dms/image/v2/D4E03AQ/profile-displayphoto-shrink_200_200/0/1700000000000
                      location: Lyon, France
                      crm_info:
                        crm_provider: hubspot
                        crm_contact_id: ff702f91-7375-44d7-afe8-414d3793fca7
                        email: thomas.lefevre@northwind.io
                        full_name: Thomas Lefevre
                        job_title: Head of Procurement
                        company_name: Northwind Logistics
                        phone: +33 4 72 10 20 30
                        last_activity_date: '2026-10-28T16:02:05Z'
                        last_activity_type: email
                        owner_id: 971f2c4e-2eda-4600-a7bd-c55ef8f21680
                        owner_email: alex.martin@halden.io
                        owner_name: Alex Martin
                        lifecycle_stage: customer
                        recent_activities:
                          - crm_activity_id: 1533c8d7-536b-49cd-a4ba-beeff07caadb
                            activity_type: email
                            activity_date: '2026-09-30T12:00:00Z'
                            subject: Intro call with Northwind
                            activity_direction: outbound
                            activity_status: completed
                            activity_outcome: connected
                            duration_minutes: 30
                            body_preview: >-
                              Hi Sofia, would you introduce me to Thomas at
                              Northwind Logistics?
                            thread_count: 3
                        recent_deals:
                          - crm_deal_id: 881a8b46-d40e-4f64-ae8f-33ae45bc3288
                            deal_name: Thomas Lefevre
                            amount: 48000
                            currency: EUR
                            stage: Negotiation
                            pipeline: Sales pipeline
                            close_date: '2026-09-30T12:00:00Z'
                            is_closed: true
                            is_closed_won: true
                      clustr_person_id: per_2yc54rt9319363snmzhte7gje4
                  alumni:
                    contacts_at_target:
                      - linkedin_id: thomas-lefevre-4b2a1
                        name: Thomas Lefevre
                        profile_url: >-
                          https://app.clustr-ai.com/accounts/acc_0ewr9dy46v0c75h0nkrb1qvpxy
                        picture_url: >-
                          https://media.licdn.com/dms/image/v2/D4E03AQ/profile-displayphoto-shrink_200_200/0/1700000000000
                        job_title: Head of Procurement
                        company_name: Northwind Logistics
                        start_ym: 12
                        end_ym: 12
                        is_current: true
                        duration_months: 30
                        period: 2019-2022
                        duration: 3 years
                        clustr_person_id: per_2yc54rt9319363snmzhte7gje4
                    buyers_at_clients:
                      - linkedin_id: thomas-lefevre-4b2a1
                        name: Thomas Lefevre
                        profile_url: >-
                          https://app.clustr-ai.com/accounts/acc_0ewr9dy46v0c75h0nkrb1qvpxy
                        picture_url: >-
                          https://media.licdn.com/dms/image/v2/D4E03AQ/profile-displayphoto-shrink_200_200/0/1700000000000
                        job_title: Head of Procurement
                        company_name: Northwind Logistics
                        start_ym: 12
                        end_ym: 12
                        is_current: true
                        duration_months: 30
                        period: 2019-2022
                        duration: 3 years
                        clustr_person_id: per_2yc54rt9319363snmzhte7gje4
                  org_map:
                    departments:
                      - name: Northwind Logistics
                        people:
                          - linkedin_id: thomas-lefevre-4b2a1
                            name: Thomas Lefevre
                            title: Head of Procurement
                            location: Lyon, France
                            profile_url: >-
                              https://app.clustr-ai.com/accounts/acc_0ewr9dy46v0c75h0nkrb1qvpxy
                            picture_url: >-
                              https://media.licdn.com/dms/image/v2/D4E03AQ/profile-displayphoto-shrink_200_200/0/1700000000000
                            seniority_level: Head
                            seniority_tag: VP
                            intro_count: 3
                            is_warm: true
                            crm_info:
                              crm_provider: hubspot
                              crm_contact_id: ff702f91-7375-44d7-afe8-414d3793fca7
                              email: thomas.lefevre@northwind.io
                              full_name: Thomas Lefevre
                              job_title: Head of Procurement
                              company_name: Northwind Logistics
                              phone: +33 4 72 10 20 30
                              last_activity_date: '2026-11-03T09:14:22Z'
                              last_activity_type: email
                              owner_id: 971f2c4e-2eda-4600-a7bd-c55ef8f21680
                              owner_email: alex.martin@halden.io
                              owner_name: Alex Martin
                              lifecycle_stage: customer
                              recent_activities:
                                - crm_activity_id: 1533c8d7-536b-49cd-a4ba-beeff07caadb
                                  activity_type: email
                                  activity_date: '2026-11-12T07:45:00Z'
                                  subject: Intro call with Northwind
                                  activity_direction: outbound
                                  activity_status: completed
                                  activity_outcome: connected
                                  duration_minutes: 30
                                  body_preview: >-
                                    Hi Sofia, would you introduce me to Thomas
                                    at Northwind Logistics?
                                  thread_count: 3
                              recent_deals:
                                - crm_deal_id: 881a8b46-d40e-4f64-ae8f-33ae45bc3288
                                  deal_name: Thomas Lefevre
                                  amount: 48000
                                  currency: EUR
                                  stage: Negotiation
                                  pipeline: Sales pipeline
                                  close_date: '2026-11-12T07:45:00Z'
                                  is_closed: true
                                  is_closed_won: true
                            clustr_person_id: per_2yc54rt9319363snmzhte7gje4
                        has_warm: true
                    total_people: 12
                  insights:
                    best_first_move:
                      contact_name: Thomas Lefevre
                      contact_linkedin_id: thomas-lefevre-4b2a1
                      contact_profile_url: >-
                        https://app.clustr-ai.com/accounts/acc_0ewr9dy46v0c75h0nkrb1qvpxy
                      contact_picture_url: >-
                        https://media.licdn.com/dms/image/v2/D4E03AQ/profile-displayphoto-shrink_200_200/0/1700000000000
                      buyer_reach_count: 3
                      via_company: Sofia Rossi
                      clustr_contact_person_id: per_2yc54rt9319363snmzhte7gje4
                    total_warm_buyers: 12
                    total_cold_buyers: 12
                    total_intros: 12
                    total_contacts: 12
                  pagination:
                    page: 1
                    page_size: 50
                    total_items: 3
                    total_pages: 12
                  cold_pagination:
                    page: 1
                    page_size: 50
                    total_items: 3
                    total_pages: 12
        '401':
          $ref: '#/components/responses/Unauthorized'
        '404':
          $ref: '#/components/responses/NotFound'
        '500':
          $ref: '#/components/responses/InternalServerError'
components:
  parameters:
    Page:
      name: page
      in: query
      required: false
      description: Which page to read, from 1, on a list numbered by page.
      schema:
        type: integer
  schemas:
    ABSReportDetailV2ResponseEnvelope:
      type: object
      required:
        - success
        - data
      properties:
        success:
          type: boolean
        data:
          $ref: '#/components/schemas/ResearchABSReportDetailV2Response'
    ResearchABSReportDetailV2Response:
      type: object
      required:
        - report
        - buyers
        - cold_buyers
        - alumni
        - org_map
        - insights
        - pagination
        - cold_pagination
      properties:
        report:
          $ref: '#/components/schemas/ABSReport'
        buyers:
          type: array
          items:
            $ref: '#/components/schemas/ResearchBuyerCard'
        cold_buyers:
          type: array
          items:
            $ref: '#/components/schemas/ResearchColdBuyer'
        alumni:
          $ref: '#/components/schemas/ResearchAlumniData'
        org_map:
          $ref: '#/components/schemas/ResearchOrgMapData'
        insights:
          $ref: '#/components/schemas/ResearchReportInsights'
        pagination:
          allOf:
            - $ref: '#/components/schemas/schemas-PaginationMeta'
        cold_pagination:
          allOf:
            - $ref: '#/components/schemas/schemas-PaginationMeta'
    ErrorEnvelope:
      type: object
      required:
        - success
        - error
      properties:
        success:
          type: boolean
          description: Always false.
        error:
          $ref: '#/components/schemas/ErrorInfo'
    ABSReport:
      type: object
      required:
        - id
        - job_id
        - target_company_name
        - target_company_linkedin_url
        - target_company_numeric_id
        - target_company_industry
        - target_company_employee_count
        - search_params
        - employees_searched
        - employees_processed
        - intros_discovered
        - unique_contacts
        - avg_confidence_score
        - status
        - created_at
      properties:
        id:
          type: string
        job_id:
          type: string
        target_company_name:
          type: string
        target_company_linkedin_url:
          type: string
        target_company_numeric_id:
          type: string
        target_company_industry:
          type: string
        target_company_employee_count:
          type: integer
        search_params:
          allOf:
            - $ref: '#/components/schemas/ABSReportSearchParams'
        employees_searched:
          type: integer
        employees_processed:
          type: integer
        intros_discovered:
          type: integer
        unique_contacts:
          type: integer
        avg_confidence_score:
          type: number
          format: double
        report_data:
          $ref: '#/components/schemas/ABSReportData'
        executive_summary:
          type: string
        status:
          type: string
        created_at:
          type: string
          format: date-time
        completed_at:
          type:
            - string
            - 'null'
          format: date-time
        warm_buyer_count:
          type:
            - integer
            - 'null'
        cold_buyer_count:
          type:
            - integer
            - 'null'
        clustr_account_research_id:
          type: string
          description: The account research's Clustr id (`abs_...`).
        clustr_job_id:
          type: string
          description: The Clustr id of `job_id`, a job (`job_...`).
        clustr_target_account_id:
          type: string
          description: >-
            The Clustr id of `target_company_numeric_id`, an account
            (`acc_...`).
        clustr_workspace_id:
          type: string
          description: The Clustr id of `tenant_id`, a tenant (`ten_...`).
    ResearchBuyerCard:
      type: object
      required:
        - linkedin_id
        - name
        - title
        - intro_count
        - best_path
        - intros
      properties:
        linkedin_id:
          type: string
        name:
          type: string
        title:
          type: string
        headline:
          type: string
        profile_url:
          type: string
        picture_url:
          type: string
        location:
          type: string
        intro_count:
          type: integer
        seniority_level:
          type: string
        best_path:
          $ref: '#/components/schemas/ResearchBestPathSummary'
        intros:
          type: array
          items:
            $ref: '#/components/schemas/ResearchABSIntro'
        crm_info:
          anyOf:
            - type: object
              allOf:
                - $ref: '#/components/schemas/schemas-ApiCRMContactInfo'
            - type: 'null'
        intro_tier:
          type: string
        clustr_person_id:
          type: string
          description: The Clustr id of `linkedin_id`, a person (`per_...`).
    ResearchColdBuyer:
      type: object
      required:
        - linkedin_id
        - name
        - title
      properties:
        linkedin_id:
          type: string
        name:
          type: string
        title:
          type: string
        headline:
          type: string
        profile_url:
          type: string
        picture_url:
          type: string
        location:
          type: string
        crm_info:
          anyOf:
            - type: object
              allOf:
                - $ref: '#/components/schemas/schemas-ApiCRMContactInfo'
            - type: 'null'
        clustr_person_id:
          type: string
          description: The Clustr id of `linkedin_id`, a person (`per_...`).
    ResearchAlumniData:
      type: object
      required:
        - contacts_at_target
        - buyers_at_clients
      properties:
        contacts_at_target:
          type: array
          items:
            $ref: '#/components/schemas/ResearchAlumniEntry'
        buyers_at_clients:
          type: array
          items:
            $ref: '#/components/schemas/ResearchAlumniEntry'
    ResearchOrgMapData:
      type: object
      required:
        - departments
        - total_people
      properties:
        departments:
          type: array
          items:
            $ref: '#/components/schemas/ResearchOrgDepartment'
        total_people:
          type: integer
    ResearchReportInsights:
      type: object
      required:
        - total_warm_buyers
        - total_cold_buyers
        - total_intros
        - total_contacts
      properties:
        best_first_move:
          oneOf:
            - $ref: '#/components/schemas/ResearchBestFirstMoveInsight'
            - type: 'null'
        total_warm_buyers:
          type: integer
        total_cold_buyers:
          type: integer
        total_intros:
          type: integer
        total_contacts:
          type: integer
    schemas-PaginationMeta:
      type: object
      required:
        - page
        - page_size
        - total_items
        - total_pages
      properties:
        page:
          type: integer
        page_size:
          type: integer
        total_items:
          type: integer
        total_pages:
          type: integer
    ErrorInfo:
      type: object
      required:
        - code
        - message
      properties:
        code:
          type: string
          description: >-
            What a client branches on, such as BAD_REQUEST or NOT_FOUND: one of
            the codes listed, the same on every operation. A code is added
            within a major version, never renamed.
          enum:
            - ADMIN_REQUIRED
            - ALREADY_LISTED
            - API_REQUEST_FAILED
            - ATTIO_NOT_CONNECTED
            - ATTIO_WORKSPACE_NOT_FOUND
            - AUTHORIZATION_UNAVAILABLE
            - AUTH_CONTEXT_ERROR
            - AUTH_FAILED
            - AUTH_METHOD_UNSUPPORTED
            - BAD_GATEWAY
            - BAD_REQUEST
            - BIGQUERY_ERROR
            - BODY_TOO_LARGE
            - BULK_PUSH_TOO_LARGE
            - BUYER_TITLES_UNAVAILABLE
            - CANCELLED
            - CANNOT_CHANGE_OWN_ROLE
            - CANNOT_DEACTIVATE_SELF
            - CANNOT_REMOVE_SELF
            - CLEANING_REPORT_FAILED
            - CLEANING_REPORT_UNAVAILABLE
            - CLIENT_CLOSED_REQUEST
            - COMPANY_NOT_FOUND
            - COMPANY_NOT_RESOLVED
            - COMPETITOR_EXISTS
            - COMPETITOR_READ_FAILED
            - COMPETITOR_RUN_FAILED
            - CONFLICT
            - CRM_CAPABILITY_UNSUPPORTED
            - CRM_CREDENTIAL_EXPIRED
            - CRM_DAILY_LIMIT
            - CRM_LISTS_UNSUPPORTED
            - CRM_NOT_ACTIVE
            - CRM_NOT_CONNECTED
            - CRM_RATE_LIMITED
            - CRM_RECONNECT_REQUIRED
            - CRM_ROW
            - CRM_SCHEMA_UNAVAILABLE
            - CRM_SCOPE_MISSING
            - CRM_UNAVAILABLE
            - CRM_VALUES_UNAVAILABLE
            - CRM_WRITE_DISABLED
            - CUSTOMERS_UNAVAILABLE
            - DATABASE_NOT_FOUND
            - DATASET_NOT_FOUND
            - DUPLICATE_ALREADY_RESOLVED
            - DUPLICATE_CHECK_FAILED
            - EMAIL_NOTIFIER_UNAVAILABLE
            - ENTITLEMENT_UNAVAILABLE
            - ESCALATION_EMAIL_DISABLED
            - EXPORT_FAILED
            - EXPORT_IN_FLIGHT
            - EXPORT_UNAVAILABLE
            - FAMILY_CLUSTER
            - FEATURE_NOT_ENABLED
            - FINDING_NOT_APPLICABLE
            - FIRE_FAILED
            - FORBIDDEN
            - FULLENRICH_API_ERROR
            - FULLENRICH_UNEXPECTED_ERROR
            - GATEWAY_TIMEOUT
            - HEADERS_TOO_LARGE
            - HUBSPOT_NOT_CONNECTED
            - HUBSPOT_UPSTREAM_ERROR
            - INSUFFICIENT_CREDITS
            - INSUFFICIENT_PERMISSION
            - INTEGRATION_REAUTH_REQUIRED
            - INTERNAL_ERROR
            - INVALID_BODY
            - INVALID_BOOLEAN
            - INVALID_BUCKET
            - INVALID_COMPANY_NAME
            - INVALID_CREDENTIALS
            - INVALID_CUSTOMER_RULE
            - INVALID_ENDPOINT
            - INVALID_EVENT
            - INVALID_FIELD
            - INVALID_INPUT
            - INVALID_LINKEDIN_URL
            - INVALID_MAPPING
            - INVALID_MATCHING_SETTINGS
            - INVALID_OBJECT_TYPE
            - INVALID_REQUEST
            - INVALID_SCHEDULE
            - INVALID_SETTINGS
            - INVALID_SIGNATURE
            - INVALID_TARGET_LIST
            - INVALID_TENANT_ID
            - INVALID_TOKEN
            - INVALID_URL
            - INVALID_UUID
            - INVALID_WEBSITE_URL
            - JOB_CLIENT_NOT_CONFIGURED
            - JOB_CREATION_FAILED
            - JOB_NOT_FOUND
            - KEY_NOT_REGISTERED
            - LAST_ADMIN
            - LOAD_FAILED
            - MAPPING_NOT_FOUND
            - MATCHING_SETTINGS_CONFLICT
            - MATCHING_VERSION_NOT_FOUND
            - MERGES_DISABLED
            - MERGE_UNRESOLVED
            - MERGE_UNSUPPORTED
            - METHOD_NOT_ALLOWED
            - MISSING_FIELDS
            - MISSING_HEADER
            - MISSING_JOB_ID
            - MISSING_OBJECT_ID
            - MISSING_PORTAL_ID
            - MISSING_TENANT_ID
            - MISSING_USER_ID
            - NOT_APPLIED
            - NOT_AUTO_SAFE
            - NOT_CONFIGURED
            - NOT_CONNECTED
            - NOT_DUPLICATE_CLUSTER
            - NOT_ENABLED
            - NOT_FOUND
            - NOT_RETRYABLE
            - NOT_REVERTABLE
            - NO_ACTIVE_WAREHOUSE
            - NO_BUYER_TITLES
            - NO_CONNECTION
            - NO_LINKEDIN_URL
            - NO_MATCH_KEY
            - NO_ORG
            - NO_PACKAGE
            - NO_SLOT
            - NO_TEAM_FOUND
            - NO_TOKEN
            - NO_WEBSITE
            - ORG_LIMIT_EXCEEDED
            - PANIC_RECOVERED
            - PARSE_ERROR
            - PAYLOAD_TOO_LARGE
            - PAYMENT_REQUIRED
            - PERSON_LEFT
            - PORTAL_TENANT_MISMATCH
            - PRIVATE_CHANNEL_NEEDS_INVITE
            - PROCESSING_ERROR
            - PROFILE_NOT_RESOLVED
            - PROJECT_NOT_FOUND
            - PROPERTY_INSIGHTS_FAILED
            - PROPERTY_INSIGHTS_UNAVAILABLE
            - QUEUE_UNAVAILABLE
            - RATE_LIMITED
            - RATE_LIMITER_INIT_FAILED
            - RATE_LIMIT_EXCEEDED
            - REDIRECT_REFUSED
            - REFRESH_RATE_LIMITED
            - REFRESH_UNAVAILABLE
            - REPORT_ONLY_DUPLICATE
            - REQUEST_FAILED
            - RESEARCH_NOT_STARTED
            - RESOURCE_EXHAUSTED
            - RESPONSE_READ_FAILED
            - REVERT_BATCH_UNAVAILABLE
            - REVERT_CONFLICT
            - REVERT_EXPIRED
            - ROUTE_NOT_FOUND
            - SALESFORCE_NOT_CONNECTED
            - SALESFORCE_ORG_NOT_FOUND
            - SAVE_FAILED
            - SEARCH_FAILED
            - SERVICE_NOT_FOUND
            - SERVICE_UNAVAILABLE
            - SERVICE_UNREACHABLE
            - SETUP_FAILED
            - SETUP_RATE_LIMITED
            - SLACK_REJECTED
            - SNOWFLAKE_ERROR
            - STAFF_REQUIRED
            - SUPABASE_NEEDS_POOLER
            - SYNC_IN_PROGRESS
            - SYNC_PROPERTIES_DISABLED
            - SYNC_STATUS_UNAVAILABLE
            - SYNC_UNAVAILABLE
            - TABLE_SHAPE_MISMATCH
            - TARGET_ACCOUNTS_UNAVAILABLE
            - TARGET_LIST_NOT_BINDABLE
            - TARGET_LIST_NOT_FOUND
            - TASK_CREATION_FAILED
            - TENANT_LOOKUP_FAILED
            - TENANT_MISMATCH
            - TOO_MANY_HEADERS
            - TOO_SOON
            - UNAUTHORIZED
            - UNAVAILABLE
            - UNKNOWN_ERROR
            - UNKNOWN_FEATURE
            - UNKNOWN_PORTAL
            - UNKNOWN_PROVIDER
            - UNPROCESSABLE_ENTITY
            - UNSUPPORTED_FLOW
            - UNSUPPORTED_MEDIA_TYPE
            - UNSUPPORTED_OBJECT_TYPE
            - UNSUPPORTED_PROVIDER
            - UNSUPPORTED_RESOURCE_TYPE
            - UPSTREAM_ERROR
            - UPSTREAM_UNAVAILABLE
            - URL_TOO_LONG
            - USER_NOT_AUTHORIZED
            - VALIDATION_ERROR
            - VALUES_FAILED
            - VALUES_UNAVAILABLE
            - VERIFICATION_UNAVAILABLE
            - WEBHOOK_UNAVAILABLE
        message:
          type: string
          description: The sentence a person reads.
        details:
          type: string
          description: Developer text, returned outside production only.
        request_id:
          type: string
          description: >-
            The request's id, for support. Always set, and the same as the
            X-Request-ID response header.
    ABSReportSearchParams:
      description: What the account search was run for.
      type: object
      required:
        - company_name
      properties:
        company_linkedin_url:
          type: string
        company_name:
          type: string
        location_filter:
          type: string
        company_url:
          type: string
        country:
          type: string
        job_titles:
          type: array
          items:
            type: string
    ABSReportData:
      description: >-
        The account search's full result, the company, the employees searched
        and each one's intros, and the relevance tier given to each intro
        (path_enrichments, keyed by intro).
      type: object
      required:
        - job_id
        - company
        - employees
        - generated_at
      properties:
        job_id:
          type: string
        company:
          $ref: '#/components/schemas/ABSReportCompany'
        search_params:
          anyOf:
            - allOf:
                - $ref: '#/components/schemas/ABSReportSearchParams'
            - type: 'null'
        employees_searched:
          type: integer
        employees_processed:
          type: integer
        paths_discovered:
          type: integer
        unique_contacts:
          type: integer
        avg_confidence_score:
          type: number
          format: double
        executive_summary:
          type: string
        employees:
          type:
            - array
            - 'null'
          items:
            $ref: '#/components/schemas/ABSReportEmployee'
        generated_at:
          type: string
          format: date-time
        path_enrichments:
          type: object
          additionalProperties:
            $ref: '#/components/schemas/ABSReportIntroEnrichment'
    ResearchBestPathSummary:
      type: object
      required:
        - contact_name
        - contact_linkedin_id
        - confidence
        - path_type
      properties:
        contact_name:
          type: string
        contact_linkedin_id:
          type: string
        contact_picture_url:
          type: string
        contact_profile_url:
          type: string
        confidence:
          type: number
          format: double
        path_type:
          type: string
        shared_company:
          type: string
        overlap_months:
          type: integer
        last_activity_at:
          type: string
        overlap_duration:
          type: string
        last_activity:
          type: string
        clustr_contact_person_id:
          type: string
          description: The Clustr id of `contact_linkedin_id`, a person (`per_...`).
    ResearchABSIntro:
      type: object
      required:
        - contact_linkedin_id
        - contact_name
        - confidence
        - path_type
        - engagement_count
      properties:
        contact_linkedin_id:
          type: string
        contact_name:
          type: string
        contact_headline:
          type: string
        contact_job_title:
          type: string
        contact_company:
          type: string
        contact_picture_url:
          type: string
        contact_profile_url:
          type: string
        confidence:
          type: number
          format: double
        path_type:
          type: string
        shared_company:
          type: string
        overlap_months:
          type: integer
        overlap_start_ym:
          type: integer
        overlap_end_ym:
          type: integer
        is_current_overlap:
          type: boolean
        overlap_duration:
          type: string
        overlap_period:
          type: string
        contact_role_at_shared:
          type: string
        buyer_role_at_shared:
          type: string
        contact_location:
          type: string
        buyer_location:
          type: string
        same_location:
          type: boolean
        same_country:
          type: boolean
        contact_role_seq:
          type: array
          items:
            $ref: '#/components/schemas/schemas-RoleEntry'
        buyer_role_seq:
          type: array
          items:
            $ref: '#/components/schemas/schemas-RoleEntry'
        contact_loc_seq:
          type: array
          items:
            $ref: '#/components/schemas/schemas-LocationEntry'
        buyer_loc_seq:
          type: array
          items:
            $ref: '#/components/schemas/schemas-LocationEntry'
        has_recommendation:
          type: boolean
        engagement_count:
          type: integer
        last_activity_at:
          type: string
        last_activity:
          type: string
        engagements:
          type: array
          items:
            $ref: '#/components/schemas/schemas-EngagementV2'
        contact_crm_info:
          anyOf:
            - type: object
              allOf:
                - $ref: '#/components/schemas/schemas-ApiCRMContactInfo'
            - type: 'null'
        intro_tier:
          type: string
        is_borderline_warm:
          type: boolean
        relevance_reason:
          type: string
        period_level:
          type: string
        role_level:
          type: string
        geo_level:
          type: string
        contact_owner:
          oneOf:
            - $ref: '#/components/schemas/ContactOwnerInfo'
            - type: 'null'
        contact_tags:
          type: array
          items:
            $ref: '#/components/schemas/ContactTagInfo'
        clustr_contact_person_id:
          type: string
          description: The Clustr id of `contact_linkedin_id`, a person (`per_...`).
    schemas-ApiCRMContactInfo:
      type: object
      required:
        - crm_provider
        - crm_contact_id
      properties:
        crm_provider:
          type: string
        crm_contact_id:
          type: string
        email:
          type: string
        full_name:
          type: string
        job_title:
          type: string
        company_name:
          type: string
        phone:
          type: string
        last_activity_date:
          type: string
          format: date-time
        last_activity_type:
          type: string
        owner_id:
          type: string
        owner_email:
          type: string
        owner_name:
          type: string
        lifecycle_stage:
          type: string
        recent_activities:
          type: array
          items:
            $ref: '#/components/schemas/schemas-ApiCRMActivity'
        recent_deals:
          type: array
          items:
            $ref: '#/components/schemas/schemas-ApiCRMDeal'
    ResearchAlumniEntry:
      type: object
      required:
        - linkedin_id
        - name
        - job_title
        - company_name
        - start_ym
        - end_ym
        - is_current
        - duration_months
        - period
        - duration
      properties:
        linkedin_id:
          type: string
        name:
          type: string
        profile_url:
          type: string
        picture_url:
          type: string
        job_title:
          type: string
        company_name:
          type: string
        start_ym:
          type: integer
        end_ym:
          type: integer
        is_current:
          type: boolean
        duration_months:
          type: integer
        period:
          type: string
        duration:
          type: string
        clustr_person_id:
          type: string
          description: The Clustr id of `linkedin_id`, a person (`per_...`).
    ResearchOrgDepartment:
      type: object
      required:
        - name
        - people
        - has_warm
      properties:
        name:
          type: string
        people:
          type: array
          items:
            $ref: '#/components/schemas/ResearchOrgPerson'
        has_warm:
          type: boolean
    ResearchBestFirstMoveInsight:
      type: object
      required:
        - contact_name
        - contact_linkedin_id
        - buyer_reach_count
      properties:
        contact_name:
          type: string
        contact_linkedin_id:
          type: string
        contact_profile_url:
          type: string
        contact_picture_url:
          type: string
        buyer_reach_count:
          type: integer
        via_company:
          type: string
        clustr_contact_person_id:
          type: string
          description: The Clustr id of `contact_linkedin_id`, a person (`per_...`).
    ABSReportCompany:
      type: object
      required:
        - name
      properties:
        name:
          type: string
        linkedin_url:
          type: string
        numeric_id:
          type: string
        industry:
          type: string
        employee_count:
          type: integer
    ABSReportEmployee:
      type: object
      required:
        - linkedin_id
        - name
        - title
        - intro_paths
        - validated
        - prospect_count
      properties:
        linkedin_id:
          type: string
        name:
          type: string
        title:
          type: string
        headline:
          type: string
        profile_url:
          type: string
        location:
          type: string
        intro_paths:
          type:
            - array
            - 'null'
          items:
            $ref: '#/components/schemas/ABSReportIntro'
        validated:
          type: boolean
        prospect_count:
          type: integer
        clustr_person_id:
          type: string
          description: The Clustr id of `linkedin_id`, a person (`per_...`).
    ABSReportIntroEnrichment:
      type: object
      required:
        - tier
      properties:
        tier:
          type: string
        reason:
          type: string
        enriched_at:
          type: string
        retry_count:
          type: integer
    schemas-RoleEntry:
      type: object
      required:
        - title
        - start_ym
        - end_ym
        - is_current
        - start_year
        - end_year
      properties:
        title:
          type: string
        company:
          type: string
        company_domain:
          type: string
        location:
          type: string
        function:
          type: string
        start_ym:
          type: integer
        end_ym:
          type: integer
        is_current:
          type: boolean
        start_year:
          type: number
          format: double
        end_year:
          type: number
          format: double
    schemas-LocationEntry:
      type: object
      required:
        - location
        - start_ym
        - end_ym
        - start_year
        - end_year
      properties:
        location:
          type: string
        country:
          type: string
        start_ym:
          type: integer
        end_ym:
          type: integer
        start_year:
          type: number
          format: double
        end_year:
          type: number
          format: double
    schemas-EngagementV2:
      type: object
      required:
        - type
        - subtype
        - direction
        - label
      properties:
        type:
          type: string
        subtype:
          type: string
        direction:
          type: string
        label:
          type: string
        at:
          type: string
        at_formatted:
          type: string
        url:
          type: string
        comment_text:
          type: string
        post_content_preview:
          type: string
        post_author_name:
          type: string
        post_type:
          type: string
        post_media_type:
          type: string
        post_like_count:
          type: integer
        post_comment_count:
          type: integer
        post_share_count:
          type: integer
    ContactOwnerInfo:
      type: object
      required:
        - user_id
      properties:
        user_id:
          type: string
        email:
          type: string
        first_name:
          type: string
        last_name:
          type: string
        clustr_owner_id:
          type: string
          description: The Clustr id of `user_id`, an owner (`own_...`).
    ContactTagInfo:
      type: object
      required:
        - id
        - name
      properties:
        id:
          type: string
        name:
          type: string
        color:
          type: string
        clustr_tag_id:
          type: string
          description: The tag's Clustr id (`tag_...`).
    schemas-ApiCRMActivity:
      type: object
      required:
        - activity_type
        - activity_date
      properties:
        crm_activity_id:
          type: string
        activity_type:
          type: string
        activity_date:
          type: string
          format: date-time
        subject:
          type: string
        activity_direction:
          type: string
        activity_status:
          type: string
        activity_outcome:
          type: string
        duration_minutes:
          type: integer
        body_preview:
          type: string
        thread_count:
          type: integer
    schemas-ApiCRMDeal:
      type: object
      required:
        - crm_deal_id
        - deal_name
        - is_closed
        - is_closed_won
      properties:
        crm_deal_id:
          type: string
        deal_name:
          type: string
        amount:
          type: number
          format: double
        currency:
          type: string
        stage:
          type: string
        pipeline:
          type: string
        close_date:
          type: string
          format: date-time
        is_closed:
          type: boolean
        is_closed_won:
          type: boolean
    ResearchOrgPerson:
      type: object
      required:
        - linkedin_id
        - name
        - title
        - intro_count
        - is_warm
      properties:
        linkedin_id:
          type: string
        name:
          type: string
        title:
          type: string
        location:
          type: string
        profile_url:
          type: string
        picture_url:
          type: string
        seniority_level:
          type: string
        seniority_tag:
          type: string
        intro_count:
          type: integer
        is_warm:
          type: boolean
        crm_info:
          anyOf:
            - type: object
              allOf:
                - $ref: '#/components/schemas/schemas-ApiCRMContactInfo'
            - type: 'null'
        clustr_person_id:
          type: string
          description: The Clustr id of `linkedin_id`, a person (`per_...`).
    ABSReportIntro:
      type: object
      required:
        - contact_linkedin_id
        - contact_name
        - path_type
        - confidence_score
      properties:
        contact_linkedin_id:
          type: string
        contact_name:
          type: string
        path_type:
          type: string
        shared_company:
          type: string
        overlap_months:
          type: integer
        confidence_score:
          type: number
          format: double
        engagement_count:
          type: integer
        contact_job_title:
          type: string
        employee_job_title:
          type: string
        contact_location:
          type: string
        employee_location:
          type: string
        overlap_start_ym:
          type: integer
        overlap_end_ym:
          type: integer
        is_current_overlap:
          type: boolean
        same_location:
          type: boolean
        company_linkedin_url:
          type: string
        has_recommendation:
          type: boolean
        location_match_type:
          type: string
        clustr_contact_person_id:
          type: string
          description: The Clustr id of `contact_linkedin_id`, a person (`per_...`).
  responses:
    Unauthorized:
      description: Missing or invalid auth.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ErrorEnvelope'
    NotFound:
      description: Resource does not exist.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ErrorEnvelope'
    InternalServerError:
      description: Unexpected server-side failure.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ErrorEnvelope'
  securitySchemes:
    BearerAuth:
      type: http
      scheme: bearer
      description: The API key you created on the API settings page of the Clustr app.

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.