> ## 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 All Competitor Customers

> Every competitor's customers in one list

The customers of every competitor you track, in one list. Each row is the same as in
[List Competitor Customers](https://docs.clustr-ai.com/api-reference/list-competitor-customers.md), plus a `competitor`
object naming whose customer it is, and each row carries `people_you_can_reach` and the owners
its owner filters match. Repeat `competitor_id` to narrow the list to some competitors,
`owner` to keep one CRM owner's, and `order=standing` to list your own customers first.
Confirmed and likely customers by default; see
[List Competitor Customers](https://docs.clustr-ai.com/api-reference/list-competitor-customers.md) for the signals and labels.

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

```python Python theme={null}
import requests

requests.get(
    "https://api.clustr-ai.com/v2/competitor_customers",
    headers={"Authorization": "Bearer YOUR_API_KEY"},
    params={"limit": 50},
)
```

```javascript JavaScript theme={null}
await fetch("https://api.clustr-ai.com/v2/competitor_customers?limit=50", {
  headers: { Authorization: "Bearer YOUR_API_KEY" },
});
```

```json 200 theme={null}
{
  "success": true,
  "data": {
    "customers": [
      {
        "clustr_competitor_customer_id": "ccus_3jm919aa345jdss56074sb5vy2",
        "clustr_account_id": "acc_g756rvkxxsbt7wedcdh3rsqvyb",
        "id": "8b4e2f6a-1c3d-4e5f-9a7b-0c2d4e6f8a1b",
        "competitor": {
          "clustr_competitor_id": "cmp_r0jpyyqyeh0txpgdhb604j2g9s",
          "id": "c1a2b3c4-d5e6-7890-abcd-ef1234567890",
          "name": "Globex"
        },
        "company_name": "Initech",
        "domain": "initech.com",
        "linkedin_numeric_id": "1035",
        "company_id": "3f9a1b2c-4d5e-6f70-8a9b-0c1d2e3f4a5b",
        "label": "likely",
        "score": 50,
        "signals": [
          { "signal": "logo_wall", "weight": 50, "url": "https://globex.com/", "count": 1 }
        ],
        "contacts": [],
        "possible_churn": false,
        "renewal_date": "2027-03-31",
        "renewal_task_created_at": null,
        "confidence": "named",
        "sources": ["logo_wall"],
        "first_seen_at": "2026-09-07T06:00:00Z",
        "last_seen_at": "2026-10-05T06:00:00Z",
        "removed_at": null,
        "renewal_window_start": null,
        "renewal_window_end": null,
        "user_verdict": "confirmed",
        "in_crm": true,
        "is_customer_of_ours": false,
        "evidence": [
          {
            "kind": "logo_wall",
            "signal": "logo_wall",
            "weight": 50,
            "url": "https://globex.com/",
            "quote": null,
            "person_name": null,
            "person_title": null,
            "observed_at": "2026-09-07T06:00:00Z"
          }
        ]
      }
    ],
    "total": 1,
    "limit": 50,
    "offset": 0
  }
}
```


## OpenAPI

````yaml GET /v2/competitor_customers
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/competitor_customers:
    get:
      tags:
        - Competitor Monitoring
      summary: List All Competitor Customers
      description: >-
        Lists the customers of every competitor you track in one list. Each
        customer names its competitor, and `competitor_id` narrows the list to
        one competitor.
      operationId: listCompetitorCustomers
      parameters:
        - name: competitor_id
          in: query
          required: false
          style: form
          explode: true
          schema:
            type: array
            items:
              type: string
              format: uuid
          description: >-
            Only these competitors' customers, by Clustr ID (`cmp_…`); repeat it
            for several (a comma list in one value is read too). The id from
            earlier responses also works.
        - name: label
          in: query
          required: false
          description: >-
            Comma-separated labels: confirmed, likely, possible. Default
            confirmed,likely; possible also needs include_possible.
          schema:
            type: string
        - name: include_possible
          in: query
          required: false
          description: true also lists possible customers (one weak signal).
          schema:
            type: string
            enum:
              - '0'
              - '1'
              - 'true'
              - 'false'
        - name: signal
          in: query
          required: false
          description: >-
            Comma-separated signals: case_study, testimonial, post_announcement,
            post_webinar, post_highlight, logo_wall, cs_interaction,
            product_user_comment.
          schema:
            type: string
        - name: include_rejected
          in: query
          required: false
          description: 1 also lists the customers someone rejected.
          schema:
            type: string
            enum:
              - '0'
              - '1'
              - 'true'
              - 'false'
        - name: order
          in: query
          required: false
          description: >-
            standing: your own customers first, then the companies in your CRM,
            then the default order (live first, label, score, last seen). Omit
            for the default order.
          schema:
            type: string
            enum:
              - standing
        - name: owner
          in: query
          required: false
          description: >-
            Only the customers whose CRM match (on the domain) has this email as
            account owner or CS owner, case-insensitively.
          schema:
            type: string
        - name: cs_owner
          in: query
          required: false
          description: >-
            Only the customers whose CS owner has this email,
            case-insensitively: the one set in Clustr, else your CRM's.
          schema:
            type: string
        - name: q
          in: query
          required: false
          description: >-
            Only the customers whose company name or domain contains this text,
            case- and accent-insensitively.
          schema:
            type: string
            maxLength: 200
        - name: search
          in: query
          required: false
          description: Same as q.
          schema:
            type: string
            maxLength: 200
        - name: standing
          in: query
          required: false
          description: >-
            Comma-separated standings: customer (your customer), crm (in your
            CRM), new (a new account).
          schema:
            type: string
        - name: sales_owner
          in: query
          required: false
          description: >-
            Comma-separated emails: only the customers whose Sales owner (the
            one set in Clustr, else your CRM's) is one of them,
            case-insensitively. A comma list in cs_owner does the same for the
            CS owner.
          schema:
            type: string
        - name: found_from
          in: query
          required: false
          description: >-
            Only the customers first found on or after this day (UTC,
            YYYY-MM-DD).
          schema:
            type: string
            format: date
        - name: found_to
          in: query
          required: false
          description: >-
            Only the customers first found on or before this day (UTC,
            YYYY-MM-DD).
          schema:
            type: string
            format: date
        - name: company
          in: query
          required: false
          description: >-
            Only these companies, by name as the company filter options list
            them, case-insensitively. Repeated keys, since a name may contain a
            comma.
          style: form
          explode: true
          schema:
            type: array
            items:
              type: string
        - name: limit
          in: query
          required: false
          schema:
            type: integer
            minimum: 1
            maximum: 500
            default: 100
          description: The number of customers per page, at most 500.
        - $ref: '#/components/parameters/Offset'
        - name: foundFrom
          in: query
          deprecated: true
          schema:
            type: string
            format: date
          description: The same as `found_from`. `found_from` is the name to use.
        - name: foundTo
          in: query
          deprecated: true
          schema:
            type: string
            format: date
          description: The same as `found_to`. `found_to` is the name to use.
      responses:
        '200':
          description: One page of customers across competitors.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/CompetitorCustomersResponseEnvelope'
              example:
                success: true
                data:
                  customers:
                    - id: c2639296-a79d-43ce-ab8f-30f455b6e5ec
                      competitor:
                        id: 3247c8cd-2cbd-48aa-aa6a-3792873aeb76
                        name: Vantage Revenue
                        clustr_competitor_id: cmp_5qk1nfz2att5f6xxyzzb5qmxak
                      company_name: Northwind Logistics
                      domain: northwind.io
                      linkedin_numeric_id: '18472301'
                      company_id: bacb303f-4a2b-4e1a-ab2e-18de1fb920ea
                      label: Warm intro
                      score: 72
                      signals:
                        - signal: case_study
                          weight: 12
                          url: >-
                            https://app.clustr-ai.com/accounts/acc_0ewr9dy46v0c75h0nkrb1qvpxy
                          count: 128
                      confidence: high
                      sources:
                        - crm
                      first_seen_at: '2026-11-03T09:14:22Z'
                      last_seen_at: '2026-11-03T09:14:22Z'
                      removed_at: '2026-11-03T09:14:22Z'
                      possible_churn: true
                      renewal_window_start: '2026-12-01'
                      renewal_window_end: '2027-03-01'
                      renewal_date: '2026-11-03'
                      renewal_task_created_at: '2026-11-03T09:14:22Z'
                      user_verdict: confirmed
                      in_crm: true
                      is_customer_of_ours: true
                      owner_name: Alex Martin
                      owner_email: alex.martin@halden.io
                      cs_owner_name: Alex Martin
                      cs_owner_email: alex.martin@halden.io
                      people_you_can_reach: 12
                      owner_id: 971f2c4e-2eda-4600-a7bd-c55ef8f21680
                      owner_stored_name: Alex Martin
                      owner_stored_email: alex.martin@halden.io
                      owner_source: clustr
                      cs_owner_id: 971f2c4e-2eda-4600-a7bd-c55ef8f21680
                      cs_owner_stored_name: Alex Martin
                      cs_owner_stored_email: alex.martin@halden.io
                      cs_owner_source: clustr
                      contacts:
                        - name: Thomas Lefevre
                          title: Head of Procurement
                          linkedin_url: https://www.linkedin.com/in/thomas-lefevre-4b2a1
                          found_via: Thomas Lefevre
                          evidence_url: >-
                            https://app.clustr-ai.com/accounts/acc_0ewr9dy46v0c75h0nkrb1qvpxy
                      evidence:
                        - kind: case_study
                          signal: case_study
                          weight: 12
                          url: >-
                            https://app.clustr-ai.com/accounts/acc_0ewr9dy46v0c75h0nkrb1qvpxy
                          quote: We moved our whole fleet to Vantage last year.
                          person_name: Thomas Lefevre
                          person_title: Thomas Lefevre
                          detail:
                            at: '2026-09-30T12:00:00Z'
                            customer_key: 604c6dc0-5ca9-4dcf-a2c4-4b55aca89bdc
                            person_source: linkedin
                            post_url: >-
                              https://app.clustr-ai.com/accounts/acc_0ewr9dy46v0c75h0nkrb1qvpxy
                            quote: We moved our whole fleet to Vantage last year.
                            removed_at: '2026-09-30T12:00:00Z'
                            rep_linkedin_url: https://www.linkedin.com/in/thomas-lefevre-4b2a1
                            rep_name: Alex Martin
                            type: note
                          observed_at: '2026-11-12T07:45:00Z'
                      clustr_account_id: acc_0tz9wnjk80dav6r07mk649yfgw
                      clustr_competitor_customer_id: ccus_3d7v8htvjehdw5anbejxw6aq0w
                  total: 128
                  limit: 50
                  offset: 0
        '400':
          $ref: '#/components/responses/BadRequest'
        '401':
          $ref: '#/components/responses/Unauthorized'
        '403':
          $ref: '#/components/responses/FeatureNotEnabled'
        '500':
          $ref: '#/components/responses/InternalServerError'
components:
  parameters:
    Offset:
      name: offset
      in: query
      required: false
      description: How many items to skip, in the endpoint's order.
      schema:
        type: integer
        minimum: 0
        default: 0
  schemas:
    CompetitorCustomersResponseEnvelope:
      type: object
      required:
        - success
        - data
      properties:
        success:
          type: boolean
        data:
          $ref: '#/components/schemas/CompetitorCustomersResponse'
    CompetitorCustomersResponse:
      type: object
      required:
        - customers
        - total
        - limit
        - offset
      properties:
        customers:
          type: array
          items:
            $ref: '#/components/schemas/CompetitorCustomerDTO'
        total:
          type: integer
          format: int64
        limit:
          type: integer
        offset:
          type: integer
    ErrorEnvelope:
      type: object
      required:
        - success
        - error
      properties:
        success:
          type: boolean
          description: Always false.
        error:
          $ref: '#/components/schemas/ErrorInfo'
    CompetitorCustomerDTO:
      type: object
      required:
        - id
        - company_name
        - domain
        - linkedin_numeric_id
        - company_id
        - label
        - score
        - signals
        - confidence
        - sources
        - first_seen_at
        - last_seen_at
        - removed_at
        - possible_churn
        - renewal_window_start
        - renewal_window_end
        - renewal_date
        - renewal_task_created_at
        - user_verdict
        - in_crm
        - is_customer_of_ours
        - contacts
        - evidence
      properties:
        id:
          type: string
        competitor:
          oneOf:
            - $ref: '#/components/schemas/CompetitorCustomerCompetitorDTO'
            - type: 'null'
        company_name:
          type: string
        domain:
          type:
            - string
            - 'null'
        linkedin_numeric_id:
          type:
            - string
            - 'null'
        company_id:
          type:
            - string
            - 'null'
        label:
          type: string
        score:
          type: integer
        signals:
          type: array
          items:
            $ref: '#/components/schemas/CompetitorCustomerSignalDTO'
        confidence:
          type: string
        sources:
          type: array
          items:
            type: string
        first_seen_at:
          type: string
        last_seen_at:
          type: string
        removed_at:
          type:
            - string
            - 'null'
        possible_churn:
          type: boolean
        renewal_window_start:
          type:
            - string
            - 'null'
        renewal_window_end:
          type:
            - string
            - 'null'
        renewal_date:
          type:
            - string
            - 'null'
        renewal_task_created_at:
          type:
            - string
            - 'null'
        user_verdict:
          type:
            - string
            - 'null'
        in_crm:
          type: boolean
        is_customer_of_ours:
          type: boolean
        owner_name:
          type: string
        owner_email:
          type: string
        cs_owner_name:
          type: string
        cs_owner_email:
          type: string
        people_you_can_reach:
          type: integer
          description: >-
            How many people at the company match your buyer titles and are
            reached by your network, at most 20, as the customers export counts
            them. Left out when it could not be read.
        owner_id:
          type: string
          description: >-
            The Sales owner's id in Clustr's owner directory, when Clustr stores
            the owner (owner_source clustr).
        owner_stored_name:
          type: string
          description: >-
            The Sales owner the owner filter matches, by name. The one set in
            Clustr, else your CRM's.
        owner_stored_email:
          type: string
          description: >-
            The Sales owner the owner filter matches, by email. The one set in
            Clustr, else your CRM's.
        owner_source:
          type: string
          enum:
            - clustr
            - crm
          description: Where the Sales owner came from. Left out when the row has none.
        cs_owner_id:
          type: string
          description: >-
            The CS owner's id in Clustr's owner directory, when Clustr stores
            the owner (cs_owner_source clustr).
        cs_owner_stored_name:
          type: string
          description: >-
            The CS owner the CS owner filter matches, by name. The one set in
            Clustr, else your CRM's.
        cs_owner_stored_email:
          type: string
          description: >-
            The CS owner the CS owner filter matches, by email. The one set in
            Clustr, else your CRM's.
        cs_owner_source:
          type: string
          enum:
            - clustr
            - crm
          description: Where the CS owner came from. Left out when the row has none.
        contacts:
          type: array
          items:
            $ref: '#/components/schemas/CompetitorCustomerContactDTO'
        evidence:
          type: array
          items:
            $ref: '#/components/schemas/CompetitorCustomerEvidenceDTO'
        clustr_account_id:
          type: string
          description: The Clustr id of `company_id`, an account (`acc_...`).
        clustr_competitor_customer_id:
          type: string
          description: The competitor customer's Clustr id (`ccus_...`).
    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.
    CompetitorCustomerCompetitorDTO:
      type: object
      required:
        - id
        - name
      properties:
        id:
          type: string
        name:
          type: string
        clustr_competitor_id:
          type: string
          description: The competitor's Clustr id (`cmp_...`).
    CompetitorCustomerSignalDTO:
      type: object
      required:
        - signal
        - weight
        - url
        - count
      properties:
        signal:
          type: string
        weight:
          type: integer
        url:
          type: string
        count:
          type: integer
    CompetitorCustomerContactDTO:
      type: object
      required:
        - name
        - title
        - linkedin_url
        - found_via
        - evidence_url
      properties:
        name:
          type: string
        title:
          type: string
          nullable: true
        linkedin_url:
          type: string
          nullable: true
        found_via:
          type: string
        evidence_url:
          type: string
          nullable: true
    CompetitorCustomerEvidenceDTO:
      type: object
      required:
        - kind
        - signal
        - weight
        - url
        - quote
        - person_name
        - person_title
        - observed_at
      properties:
        kind:
          type: string
        signal:
          type: string
          nullable: true
        weight:
          type: integer
          nullable: true
        url:
          type: string
        quote:
          type: string
          nullable: true
        person_name:
          type: string
          nullable: true
        person_title:
          type: string
          nullable: true
        detail:
          allOf:
            - $ref: '#/components/schemas/CompetitorEvidenceDetail'
        observed_at:
          type: string
          nullable: true
    CompetitorEvidenceDetail:
      description: >-
        What a piece of evidence carries beyond its columns. Every field is left
        out when empty.
      type: object
      properties:
        at:
          type: string
        customer_key:
          type: string
        person_source:
          type: string
        post_url:
          type: string
        quote:
          type: string
        removed_at:
          type: string
        rep_linkedin_url:
          type: string
        rep_name:
          type: string
        type:
          type: string
  responses:
    BadRequest:
      description: Request validation failed.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ErrorEnvelope'
    Unauthorized:
      description: Missing or invalid auth.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ErrorEnvelope'
    FeatureNotEnabled:
      description: >-
        The workspace's plan does not include this paid add-on (CRM Cleaning or
        Competitor Monitoring). error.code is FEATURE_NOT_ENABLED and
        error.message names the add-on. Enforced server-side for every caller:
        the web app, the public API and MCP.
      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.