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

# Get buyer filters

> The workspace's buyer filters (Knowledge Base > Buyer Filters): the companies you sell to, and the Decision Makers, End Users and Full Buying Committee you target there. An empty list means no restriction.



## OpenAPI

````yaml /openapi.json get /buyer-filters
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:
  /buyer-filters:
    get:
      tags:
        - Buyer filters
      summary: Get buyer filters
      description: >-
        The workspace's buyer filters (Knowledge Base > Buyer Filters): the
        companies you sell to, and the Decision Makers, End Users and Full
        Buying Committee you target there. An empty list means no restriction.
      operationId: getBuyerFilters
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                type: object
                required:
                  - data
                  - meta
                properties:
                  data:
                    $ref: '#/components/schemas/BuyerFilters'
                  meta:
                    $ref: '#/components/schemas/Meta'
              example:
                data:
                  company_sizes:
                    - 201-500
                    - 501-1000
                  company_industries:
                    - Software Development
                  company_excluded_industries:
                    - Staffing and Recruiting
                  company_hq_countries:
                    - US
                  decision_makers:
                    contact_job_titles:
                      - VP Sales
                      - Chief Revenue Officer
                    contact_excluded_job_titles:
                      - Assistant
                    contact_seniorities:
                      - Vice President
                      - CXO
                    contact_countries:
                      - US
                  end_users:
                    contact_job_titles:
                      - Account Executive
                      - Sales Development Representative
                    contact_excluded_job_titles: []
                    contact_seniorities:
                      - Senior
                    contact_countries: []
                  full_buying_committee:
                    contact_job_titles:
                      - VP Sales
                      - Director of Sales Operations
                      - Account Executive
                    contact_excluded_job_titles: []
                    contact_seniorities: []
                    contact_countries: []
                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:
    BuyerFilters:
      type: object
      description: >-
        The workspace's buyer filters: which companies you sell to and which
        people there you target. An empty list means no restriction.
      properties:
        company_sizes:
          type: array
          items:
            type: string
          description: Employee bands to include, as in company_size (e.g. "201-500").
        company_industries:
          type: array
          items:
            type: string
          description: Industries to include, as in company_industry.
        company_excluded_industries:
          type: array
          items:
            type: string
          description: Industries to leave out.
        company_hq_countries:
          type: array
          items:
            type: string
          description: >-
            Headquarters countries to include, ISO 3166-1 alpha-2 as in
            company_hq_country (e.g. "US").
        decision_makers:
          type: object
          properties:
            contact_job_titles:
              type: array
              items:
                type: string
              description: Job titles to include.
            contact_excluded_job_titles:
              type: array
              items:
                type: string
              description: Job titles to leave out.
            contact_seniorities:
              type: array
              items:
                type: string
              description: Seniority levels to include, e.g. "Vice President".
            contact_countries:
              type: array
              items:
                type: string
              description: Countries the person is in, ISO 3166-1 alpha-2 (e.g. "US").
          description: 'Decision Makers: the people who sign off on the purchase.'
        end_users:
          type: object
          properties:
            contact_job_titles:
              type: array
              items:
                type: string
              description: Job titles to include.
            contact_excluded_job_titles:
              type: array
              items:
                type: string
              description: Job titles to leave out.
            contact_seniorities:
              type: array
              items:
                type: string
              description: Seniority levels to include, e.g. "Vice President".
            contact_countries:
              type: array
              items:
                type: string
              description: Countries the person is in, ISO 3166-1 alpha-2 (e.g. "US").
          description: 'End Users: the people who use the product day to day.'
        full_buying_committee:
          type: object
          properties:
            contact_job_titles:
              type: array
              items:
                type: string
              description: Job titles to include.
            contact_excluded_job_titles:
              type: array
              items:
                type: string
              description: Job titles to leave out.
            contact_seniorities:
              type: array
              items:
                type: string
              description: Seniority levels to include, e.g. "Vice President".
            contact_countries:
              type: array
              items:
                type: string
              description: Countries the person is in, ISO 3166-1 alpha-2 (e.g. "US").
          description: >-
            Full Buying Committee: everyone involved in the purchase, the people
            a Buying Committee contact is drawn from. Usually defined by job
            title alone.
    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.