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

# Get Competitor Slots

> Your competitor monitoring slots, used and total

Each monitored person takes one slot, whatever the competitor. This is the counter the app shows as
"Slots: used / total".

| Field | Meaning |
| - | - |
| `used` | Monitored people. Only they take a slot. |
| `total` | Your slot limit, from your plan. |
| `paused` | People paused, because the limit was reached or manually. |
| `pending` | People waiting for a decision. Normally 0: joiners are followed automatically while you have free slots. |
| `plan` | `s50`, `m100`, `l200`, or `custom` for a limit Clustr set manually. |

`active` and `limit` carry the same values as `used` and `total`.

To raise your limit, contact Clustr.

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

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

requests.get(
    "https://api.clustr-ai.com/api/public/competitor-slots",
    headers={"Authorization": "Bearer YOUR_API_KEY"},
)
```

```javascript JavaScript theme={null}
await fetch("https://api.clustr-ai.com/api/public/competitor-slots", {
  headers: { Authorization: "Bearer YOUR_API_KEY" },
});
```

```json 200 theme={null}
{
  "success": true,
  "data": {
    "used": 182,
    "total": 200,
    "paused": 12,
    "pending": 3,
    "plan": "l200",
    "active": 182,
    "limit": 200
  }
}
```


## OpenAPI

````yaml GET /competitor-slots
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:
  /competitor-slots:
    get:
      tags:
        - Competitor Monitoring
      summary: Get Competitor Slots
      description: >-
        Returns your competitor monitoring slots: how many are used (one per
        monitored person), the total, how many people are paused or pending, and
        your plan.
      operationId: getCompetitorSlots
      responses:
        '200':
          description: The slot counter
          content:
            application/json:
              schema:
                type: object
                required:
                  - success
                  - data
                properties:
                  success:
                    type: boolean
                    example: true
                  data:
                    $ref: '#/components/schemas/SlotUsage'
        '401':
          description: Invalid or missing API key
components:
  schemas:
    SlotUsage:
      type: object
      description: >-
        Your competitor monitoring slots. Each monitored person takes one slot,
        whatever the competitor. The limit comes from your workspace's plan,
        which Clustr sets.
      properties:
        used:
          type: integer
          description: How many people are monitored.
          example: 182
        total:
          type: integer
          description: The slot limit.
          example: 200
        paused:
          type: integer
          description: How many people are paused, for lack of a slot or manually.
          example: 12
        pending:
          type: integer
          description: How many joiners are waiting for you to validate them.
          example: 3
        plan:
          type: string
          enum:
            - s50
            - m100
            - l200
            - custom
          example: l200
        active:
          type: integer
          description: The same count as `used`.
          example: 182
        limit:
          type: integer
          description: The same limit as `total`.
          example: 200
  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.