> ## 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 `linkedinVanityName` (the
LinkedIn company slug), a `linkedinNumericId`, or a `companyId`. A company
excluded before Clustr had a record for it gets its `companyId` filled in once
one exists.

The list holds at most 500 companies.

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

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


## OpenAPI

````yaml GET /excluded-companies
openapi: 3.1.0
info:
  title: Clustr Public API
  description: >
    Programmatic access to your Clustr network: import connectors, search warm
    intros (opportunities), 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: '1.0'
  contact:
    name: Clustr Support
    url: https://clustr-ai.com
servers:
  - url: https://api.clustr-ai.com/api/public
    description: Production
security:
  - BearerAuth: []
paths:
  /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.
      operationId: listExcludedCompanies
      responses:
        '200':
          description: The exclusion list
          content:
            application/json:
              schema:
                type: object
                properties:
                  success:
                    type: boolean
                    example: true
                  data:
                    type: object
                    properties:
                      excludedCompanies:
                        type: array
                        items:
                          $ref: '#/components/schemas/ExcludedCompany'
                      count:
                        type: integer
                        example: 1
        '401':
          description: Invalid or missing API key
components:
  schemas:
    ExcludedCompany:
      type: object
      properties:
        clustrExcludedCompanyId:
          type: string
          description: >-
            The exclusion's Clustr ID, for example
            `exco_gs55xmz75eekyeen4gcze1vn6d`. Use it to refer to

            this exclusion.
          example: exco_gs55xmz75eekyeen4gcze1vn6d
        clustrWorkspaceId:
          type: string
          description: >-
            The workspace's Clustr ID, for example
            `ten_d7ybajxezg97cghd2y3x7am2qg`.
          example: ten_d7ybajxezg97cghd2y3x7am2qg
        clustrAccountId:
          type: string
          description: >-
            The Clustr ID of the account it matched, for example
            `acc_5x3vqy454qx6m6q2thvk020zmn`. For a

            company Clustr does not know yet, it is filled in once that company
            appears.
          example: acc_5x3vqy454qx6m6q2thvk020zmn
        clustrCreatedByUserId:
          type: string
          description: >-
            The Clustr ID of the member who added it, for example
            `usr_z21gb6gp5qg90dfrsf5hb5dfdj`.
          example: usr_z21gb6gp5qg90dfrsf5hb5dfdj
        id:
          type: string
          format: uuid
          description: >-
            Kept for integrations built before Clustr IDs. New integrations
            should use `clustrExcludedCompanyId`.
        tenantId:
          type: string
          format: uuid
          description: >-
            Kept for integrations built before Clustr IDs. New integrations
            should use `clustrWorkspaceId`.
        companyId:
          type: string
          description: >-
            Kept for integrations built before Clustr IDs. New integrations
            should use `clustrAccountId`.
        linkedinNumericId:
          type: string
          example: '1035'
        linkedinVanityName:
          type: string
          description: The LinkedIn company slug, lower-cased.
          example: acme-corp
        domain:
          type: string
          description: The bare host, without scheme, `www.` or path.
          example: acme.com
        label:
          type: string
          description: The name shown on the list, for display only.
          example: Acme Corp
        reason:
          type: string
          example: Competitor
        createdBy:
          type: string
          description: >-
            Kept for integrations built before Clustr IDs. New integrations
            should use `clustrCreatedByUserId`.
        createdAt:
          type: string
          format: date-time
  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.