> ## Documentation Index
> Fetch the complete documentation index at: https://docs.letterdrop.com/llms.txt
> Use this file to discover all available pages before exploring further.

# List tracked competitors

> The competitors this workspace tracks (the Tracking competitors card on Competitor Signals), in the order they were added, each with the exec and company pages monitored for it. competitor_name is the name account_competitors and competitor_name use elsewhere in this API.



## OpenAPI

````yaml /openapi.json get /tracked-competitors
openapi: 3.1.0
info:
  title: Letterdrop Competitor Signals API
  version: 2.0.0
  license:
    name: Proprietary
    url: https://letterdrop.com/terms
  description: >-
    Read your workspace's Competitor Signals data: the accounts showing
    competitor signals, the contacts and signals behind each, their CRM context,
    your outreach, and the dashboard metrics.


    It also manages your target accounts and returns the people who recently
    changed jobs into them (Target accounts), and reads the workspace's buyer
    filters and tracked competitors.


    The API speaks the same language as the New Competitor Deal webhook (payload
    version v2): a field has the same name and the same values in both, so
    whatever you build on one reads the other.


    **Versioning.** The major version is in the path (/api/v2). Within v2
    changes are additive only (new optional fields, filters, endpoints), so
    ignore fields you do not recognise. The v1 Competitor Signals endpoints keep
    working unchanged.


    **Rate limits.** Per workspace: 10 requests/second and 600/minute, plus 20
    uncached computations/minute (analytics count as 4). Cached reads
    (meta.cache = hit), including every later page of a list you already
    started, use no computation budget. Every response carries RateLimit-Limit /
    RateLimit-Remaining / RateLimit-Reset; a 429 carries Retry-After.


    **Freshness.** Results are cached for a few minutes (analytics and filter
    options a little longer); meta.data_as_of says when the data was computed.
    Signals are collected daily, so polling faster than every few minutes
    returns the same data.
servers:
  - url: https://api.letterdrop.com/api/v2
security: []
tags:
  - name: Accounts
    description: Companies with competitor signals, and what we know about each.
  - name: Contacts
    description: The people behind the signals.
  - name: Analytics
    description: The dashboard metrics, one endpoint each.
  - name: Filters
    description: Every key of every object, and how to select and filter on it.
  - name: Target accounts
    description: >-
      The companies you sell to, and the people who just joined them. Writes
      need the mcp.write scope (any API key has it).
  - name: Buyer filters
    description: The companies and people you sell to.
  - name: Tracked competitors
    description: >-
      The competitors you track, and the exec and company pages monitored for
      each.
paths:
  /tracked-competitors:
    get:
      tags:
        - Tracked competitors
      summary: List tracked competitors
      description: >-
        The competitors this workspace tracks (the Tracking competitors card on
        Competitor Signals), in the order they were added, each with the exec
        and company pages monitored for it. competitor_name is the name
        account_competitors and competitor_name use elsewhere in this API.
      operationId: listTrackedCompetitors
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                type: object
                required:
                  - data
                  - meta
                properties:
                  data:
                    type: object
                    properties:
                      tracked_competitors:
                        type: array
                        items:
                          $ref: '#/components/schemas/TrackedCompetitor'
                  meta:
                    $ref: '#/components/schemas/Meta'
              example:
                data:
                  tracked_competitors:
                    - competitor_domain: acme-rival.com
                      competitor_name: Acme Rival
                      monitored_profiles:
                        - profile_type: person
                          profile_linkedin_url: https://example.com/in/jane-doe
                        - profile_type: company
                          profile_linkedin_url: https://example.com/company/acme-rival
                    - competitor_domain: globex.com
                      competitor_name: Globex
                      monitored_profiles:
                        - profile_type: person
                          profile_linkedin_url: https://example.com/in/john-roe
                meta:
                  api_version: '2'
                  data_as_of: '2026-11-02T09:36:28.016Z'
                  cache: 'off'
        '401':
          $ref: '#/components/responses/Unauthorized'
        '403':
          $ref: '#/components/responses/Forbidden'
        '422':
          $ref: '#/components/responses/Unprocessable'
        '429':
          $ref: '#/components/responses/TooManyRequests'
        '500':
          $ref: '#/components/responses/ServerError'
      security:
        - WorkspaceKey: []
        - BearerAuth:
            - mcp.read
components:
  schemas:
    TrackedCompetitor:
      type: object
      description: A competitor the workspace tracks.
      properties:
        competitor_domain:
          type: string
          description: The competitor's website domain.
        competitor_name:
          type: string
          description: >-
            The competitor's name, as account_competitors and competitor_name
            show it.
        monitored_profiles:
          type: array
          description: >-
            The competitor's exec and company pages that are monitored for
            signals (the card's exec and company pages).
          items:
            type: object
            properties:
              profile_type:
                type: string
                description: >-
                  person (an exec or other employee) or company (the company
                  page).
                enum:
                  - person
                  - company
              profile_linkedin_url:
                type: string
                description: The page URL.
    Meta:
      type: object
      required:
        - api_version
        - data_as_of
        - cache
      properties:
        api_version:
          type: string
          const: '2'
        data_as_of:
          type: string
          format: date-time
          description: >-
            When the data in this response was computed. Responses are cached
            for a few minutes; this tells you how fresh they are.
        cache:
          type: string
          enum:
            - hit
            - miss
            - shared
            - 'off'
          description: >-
            hit = served from cache; miss = computed for this request; shared =
            joined a computation already running for the same query.
    Error:
      type: object
      required:
        - error
      properties:
        error:
          type: object
          required:
            - code
            - message
          properties:
            code:
              type: string
              enum:
                - invalid_request
                - invalid_json
                - invalid_cursor
                - cursor_expired
                - unauthorized
                - forbidden
                - account_not_found
                - not_found
                - rate_limited
                - internal_error
            message:
              type: string
            details:
              type: array
              items:
                type: object
                properties:
                  path:
                    type: string
                  message:
                    type: string
              description: 'For invalid_request: one entry per parameter that failed.'
  responses:
    Unauthorized:
      description: Missing or invalid credential.
      x-status: 401
      x-codes:
        - unauthorized
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
    Forbidden:
      description: >-
        The credential lacks the scope the operation needs (mcp.read to read,
        mcp.write to write).
      x-status: 403
      x-codes:
        - forbidden
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
    Unprocessable:
      description: A parameter failed validation; details lists each one.
      x-status: 422
      x-codes:
        - invalid_request
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
    TooManyRequests:
      description: Rate limited; wait Retry-After seconds.
      x-status: 429
      x-codes:
        - rate_limited
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
      headers:
        Retry-After:
          schema:
            type: integer
          description: Seconds to wait.
    ServerError:
      description: Our fault; retry, and contact support if it persists.
      x-status: 500
      x-codes:
        - internal_error
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
  securitySchemes:
    WorkspaceKey:
      type: apiKey
      in: header
      name: api-key
    BearerAuth:
      type: http
      scheme: bearer

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.