> ## 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 excluded companies

> The companies excluded from your workspace

Returns every company on your exclusion list, newest first. An excluded company
is hidden from every list, search, account, warm intro, count and export, and
Clustr skips it when enriching. See [Targets, clients and excluded](https://docs.clustr-ai.com/account-standing.md)
for how the exclusion list differs from the other two.

Each row says what it is matched on: a `domain`, a `linkedin_vanity_name` (the
LinkedIn company slug), a `linkedin_numeric_id`, or a `company_id`. A company
excluded before Clustr had a record for it gets its `company_id` filled in once
one exists.

To ask about one company, pass `domain`, `linkedin_url` (a LinkedIn company page)
or `linkedin_numeric_id`. A row matches when its own key equals the one you sent,
or when the company it belongs to carries that key; with several keys, a row
matches any of them. An empty list means the company is not excluded. A
`linkedin_url` that is not a company page, or a `linkedin_numeric_id` that is not
digits, is a 400. A company excluded a few seconds ago can take a moment to show up.

The list holds at most 500 companies.

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

```bash cURL (one company) theme={null}
curl -G https://api.clustr-ai.com/v2/excluded_companies \
  --data-urlencode "linkedin_url=https://www.linkedin.com/company/acme-corp" \
  -H "Authorization: Bearer YOUR_API_KEY"
```

```json 200 theme={null}
{
  "success": true,
  "data": {
    "excluded_companies": [
      {
        "clustr_excluded_company_id": "exco_f9nan0w4892z0s7s7kb793038p",
        "clustr_workspace_id": "ten_93tdpgecrrpwmf19spn5k2cds3",
        "id": "8f1c2d3e-4b5a-4c6d-8e7f-9a0b1c2d3e4f",
        "tenant_id": "3b0f6a52-1c9e-4d7a-8f21-5e6c7d8a9b10",
        "linkedin_vanity_name": "acme-corp",
        "domain": "acme.com",
        "label": "Acme Corp",
        "reason": "Competitor",
        "created_at": "2026-10-12T09:30:00Z"
      }
    ],
    "count": 1
  }
}
```


## OpenAPI

````yaml GET /v2/excluded_companies
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/excluded_companies:
    get:
      tags:
        - Excluded Companies
      summary: List excluded companies
      description: >
        The companies excluded from your workspace, newest first, each with the

        keys it is matched on. Clustr hides an excluded company from every list,

        search, account, warm intro, count and export, and skips it during

        enrichment. Filter by domain, linkedin_url or linkedin_numeric_id to ask
        about one company.
      operationId: listExcludedCompanies
      parameters:
        - name: domain
          in: query
          required: false
          description: >-
            A domain or website URL, matched on its host, lowercased. A row
            matches on its own domain or its company's.
          schema:
            type: string
        - name: linkedin_url
          in: query
          required: false
          description: >-
            A LinkedIn company page URL (linkedin.com/company/...), matched on
            its numeric id or its vanity, the row's own or its company's. Any
            other URL is a 400.
          schema:
            type: string
        - name: linkedin_numeric_id
          in: query
          required: false
          description: >-
            A LinkedIn company numeric id, digits only; anything else is a 400.
            With several of domain, linkedin_url and linkedin_numeric_id, a row
            matches when it holds any of them.
          schema:
            type: string
      responses:
        '200':
          description: Typed result envelope.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ExcludedCompaniesEnvelope'
              example:
                success: true
                data:
                  count: 128
                  excluded_companies:
                    - id: 06acc222-b7b4-4b30-abd9-5ad6c487a71b
                      company_id: bacb303f-4a2b-4e1a-ab2e-18de1fb920ea
                      linkedin_numeric_id: '18472301'
                      linkedin_vanity_name: '18472301'
                      domain: northwind.io
                      label: Warm intro
                      reason: On your target list
                      created_by: eb53c253-1e7d-441c-ad04-e787afc5c2c3
                      created_at: '2026-11-03T09:14:22Z'
                      clustr_account_id: acc_4m9hg1k2h0m5ksph94wn5fhbem
                      clustr_created_by_user_id: usr_4698sm27w28de32yd5ve4yf47z
                      clustr_excluded_company_id: exco_445p06x86dn97tj91y5wnm6raz
                      clustr_workspace_id: ten_2b1jey64t3jt679db0v4edwpfh
        '401':
          $ref: '#/components/responses/Unauthorized'
        '404':
          $ref: '#/components/responses/NotFound'
        '500':
          $ref: '#/components/responses/InternalServerError'
components:
  schemas:
    ExcludedCompaniesEnvelope:
      type: object
      required:
        - success
        - data
      properties:
        success:
          type: boolean
        data:
          $ref: '#/components/schemas/ExcludedCompaniesData'
    ExcludedCompaniesData:
      type: object
      required:
        - count
        - excluded_companies
      properties:
        count:
          type: integer
        excluded_companies:
          type: array
          items:
            $ref: '#/components/schemas/ExcludedCompany'
    ErrorEnvelope:
      type: object
      required:
        - success
        - error
      properties:
        success:
          type: boolean
          description: Always false.
        error:
          $ref: '#/components/schemas/ErrorInfo'
    ExcludedCompany:
      type: object
      required:
        - id
        - label
        - created_at
      properties:
        id:
          type: string
        company_id:
          type: string
        linkedin_numeric_id:
          type: string
        linkedin_vanity_name:
          type: string
        domain:
          type: string
        label:
          type: string
        reason:
          type: string
        created_by:
          type: string
        created_at:
          type: string
        clustr_account_id:
          type: string
          description: The Clustr id of `company_id`, an account (`acc_...`).
        clustr_created_by_user_id:
          type: string
          description: The Clustr id of `created_by`, an user (`usr_...`).
        clustr_excluded_company_id:
          type: string
          description: The excluded company's Clustr id (`exco_...`).
        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.
  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.