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

> The job titles that hide a person everywhere

Returns every [excluded title](https://docs.clustr-ai.com/buyer-titles.md), oldest first. Anyone whose job
title or LinkedIn headline matches one is hidden everywhere in Clustr, even when
they match a buyer title.

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

```json 200 theme={null}
{
  "success": true,
  "data": {
    "excludes": [
      {
        "clustr_keyword_exclude_id": "kwx_x1jkn5gxamtg8gfa5k2b3er0py",
        "id": 7,
        "keyword": "Recruiter"
      }
    ],
    "count": 1
  }
}
```


## OpenAPI

````yaml GET /excluded-titles
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-titles:
    get:
      tags:
        - Buyer Titles
      summary: List excluded titles
      description: >
        The Excluded titles list on the Targeting page. Anyone whose job title
        or

        LinkedIn headline matches one is hidden everywhere in Clustr and skipped

        by imports, even when they match a buyer title.
      operationId: listExcludedTitles
      responses:
        '200':
          description: Every excluded title, oldest first
          content:
            application/json:
              schema:
                type: object
                properties:
                  success:
                    type: boolean
                    example: true
                  data:
                    type: object
                    properties:
                      excludes:
                        type: array
                        items:
                          $ref: '#/components/schemas/JobTitle'
                      count:
                        type: integer
                        example: 1
        '401':
          description: Invalid or missing API key
components:
  schemas:
    JobTitle:
      type: object
      properties:
        clustr_keyword_id:
          type: string
          description: >-
            The buyer title's Clustr ID, for example
            `kw_d69pbmkm13axteg0b2b0mnh33b`, when you list buyer

            titles. Use it to delete the title.
          example: kw_d69pbmkm13axteg0b2b0mnh33b
        clustr_keyword_exclude_id:
          type: string
          description: >-
            The excluded title's Clustr ID, for example
            `kwx_b1m6sfvhv8kmtkb2qj0me7ynaq`, when you list

            excluded titles. Use it to delete the title.
          example: kwx_b1m6sfvhv8kmtkb2qj0me7ynaq
        id:
          type: integer
          description: >-
            Kept for integrations built before Clustr IDs. New integrations
            should use `clustr_keyword_id` or `clustr_keyword_exclude_id`.
          example: 42
        keyword:
          type: string
          description: The title text
          example: Head of Finance
  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.