> ## 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.

# List Account Research Reports

> Every account research report of your workspace

Every account research report of your workspace, newest first, whether it was started in the
app, through the API or by the assistant. Reading reports is free; only
[Start Account Research](https://docs.clustr-ai.com/api-reference/start-account-research.md) spends a credit.

Each report carries its `id`, the `abs_report_id` the other report operations take, and the
`job_id` of the run that wrote it, the one Start Account Research answered. Find a report you
started by that `job_id`.

| Field | Meaning |
| - | - |
| `target_company_name`, `target_company_linkedin_url` | The company researched |
| `status` | Where the report stands |
| `warm_buyer_count` | Buyers at the company with at least one warm path |
| `cold_buyer_count` | Buyers with none |
| `intros_discovered` | Warm paths found, across every buyer |
| `created_at`, `completed_at` | When the run started and when it wrote the report |

```bash cURL theme={null}
curl https://api.clustr-ai.com/v2/abs_reports \
  -H "Authorization: Bearer YOUR_API_KEY"
```


## OpenAPI

````yaml GET /v2/abs_reports
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:
    get:
      tags:
        - Account Research
      summary: List Account Research Reports
      description: >
        Every account research report of your workspace, newest first, whether
        it was started

        in the app, through the API or by the assistant. Each report carries its
        `id` (the

        `abs_report_id` the other report operations take), the `job_id` of the
        run that wrote it

        (the one [Start Account Research](/api-reference/start-account-research)
        answered), its

        company and its buyer and intro counts.
      operationId: listAbsReports
      responses:
        '200':
          description: Typed result envelope.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ABSReportsEnvelope'
              example:
                success: true
                data:
                  reports:
                    - 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
                            validated: true
                            prospect_count: 3
                        generated_at: '2026-10-28T16:02:05Z'
                        path_enrichments:
                          enrichments_1:
                            tier: Tier 1
                            reason: On your target list
                            enriched_at: '2026-09-30T12:00: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-11-03T09:14:22Z'
                      completed_at: '2026-11-03T09:14:22Z'
                      warm_buyer_count: 3
                      cold_buyer_count: 3
                      warm_buyers: 12
                      cold_buyers: 12
                      clustr_account_research_id: abs_45b7erb6y82qzjdkahw00m1695
                      clustr_job_id: job_6jwhwv3wycsebzfq0fxnw7gpbb
                      clustr_target_account_id: tacc_7490xf0kzqpzqpvv870g97bvyz
                      clustr_workspace_id: ten_5qjvdvcsf461e94cymeffggcdg
                  total: 128
        '401':
          $ref: '#/components/responses/Unauthorized'
        '404':
          $ref: '#/components/responses/NotFound'
        '500':
          $ref: '#/components/responses/InternalServerError'
components:
  schemas:
    ABSReportsEnvelope:
      type: object
      required:
        - success
        - data
      properties:
        success:
          type: boolean
        data:
          $ref: '#/components/schemas/ABSReportsData'
    ABSReportsData:
      type: object
      required:
        - reports
        - total
      properties:
        reports:
          type:
            - array
            - 'null'
          items:
            $ref: '#/components/schemas/ABSReportWithCounts'
        total:
          type: integer
    ErrorEnvelope:
      type: object
      required:
        - success
        - error
      properties:
        success:
          type: boolean
          description: Always false.
        error:
          $ref: '#/components/schemas/ErrorInfo'
    ABSReportWithCounts:
      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
        - warm_buyers
        - cold_buyers
      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:
          allOf:
            - $ref: '#/components/schemas/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'
        warm_buyers:
          type: integer
        cold_buyers:
          type: integer
        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_...`).
    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
    schemas-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:
          allOf:
            - $ref: '#/components/schemas/ABSReportSearchParams'
          nullable: true
        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
          nullable: true
          items:
            $ref: '#/components/schemas/schemas-ABSReportEmployee'
        generated_at:
          type: string
          format: date-time
        path_enrichments:
          type: object
          additionalProperties:
            $ref: '#/components/schemas/ABSReportIntroEnrichment'
    ABSReportCompany:
      type: object
      required:
        - name
      properties:
        name:
          type: string
        linkedin_url:
          type: string
        numeric_id:
          type: string
        industry:
          type: string
        employee_count:
          type: integer
    schemas-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
          nullable: true
          items:
            $ref: '#/components/schemas/schemas-ABSReportIntro'
        validated:
          type: boolean
        prospect_count:
          type: integer
    ABSReportIntroEnrichment:
      type: object
      required:
        - tier
      properties:
        tier:
          type: string
        reason:
          type: string
        enriched_at:
          type: string
        retry_count:
          type: integer
    schemas-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
  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.