> ## 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 target accounts

> The companies on the workspace's Target Accounts page, by domain: uploaded, added over the API, and synced from your CRM.



## OpenAPI

````yaml /openapi.json get /target-accounts
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:
  /target-accounts:
    get:
      tags:
        - Target accounts
      summary: List target accounts
      description: >-
        The companies on the workspace's Target Accounts page, by domain:
        uploaded, added over the API, and synced from your CRM.
      operationId: listTargetAccounts
      parameters:
        - $ref: '#/components/parameters/search'
        - name: page_size
          in: query
          required: false
          description: Rows per page, 1-100. Default 25.
          schema:
            type: integer
            minimum: 1
            maximum: 100
        - name: cursor
          in: query
          required: false
          description: pagination.next_cursor from the previous page.
          schema:
            type: string
            minLength: 1
            maxLength: 2048
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                type: object
                required:
                  - data
                  - meta
                properties:
                  data:
                    type: object
                    properties:
                      target_accounts:
                        type: array
                        items:
                          $ref: '#/components/schemas/TargetAccount'
                  meta:
                    $ref: '#/components/schemas/Meta'
                  pagination:
                    $ref: '#/components/schemas/Pagination'
              example:
                data:
                  target_accounts:
                    - id: 6a1f0c2e9b1d4c0012ab34cd
                      company_name: Acme
                      company_domain: acme.com
                      company_linkedin_url: https://example.com/company/acme
                      source: upload
                      created_at: '2026-11-02T09:36:28.016Z'
                pagination:
                  total: 1
                  has_more: false
                  next_cursor: null
                meta:
                  api_version: '2'
                  data_as_of: '2026-11-02T09:36:28.016Z'
                  cache: 'off'
        '400':
          $ref: '#/components/responses/BadRequest'
        '401':
          $ref: '#/components/responses/Unauthorized'
        '403':
          $ref: '#/components/responses/Forbidden'
        '410':
          $ref: '#/components/responses/Gone'
        '422':
          $ref: '#/components/responses/Unprocessable'
        '429':
          $ref: '#/components/responses/TooManyRequests'
        '500':
          $ref: '#/components/responses/ServerError'
      security:
        - WorkspaceKey: []
        - BearerAuth:
            - mcp.read
components:
  parameters:
    search:
      name: search
      in: query
      required: false
      description: Free-text match on company and contact names.
      schema:
        type: string
        maxLength: 200
      x-filter: true
  schemas:
    TargetAccount:
      type: object
      description: A company on the workspace's Target Accounts page.
      properties:
        id:
          type: string
          description: Target account id. Use it to remove the account.
        company_name:
          type: string
          description: Company name (the domain, until enrichment finds the name).
        company_domain:
          type: string
          description: Website domain.
        company_linkedin_url:
          type: string
          description: The company's page URL. Empty until matched.
        source:
          type: string
          description: 'Where it came from: upload (CSV or API), hubspot or salesforce.'
          x-values:
            - upload
            - hubspot
            - salesforce
        created_at:
          type:
            - string
            - 'null'
          format: date-time
    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.
    Pagination:
      type: object
      required:
        - total
        - has_more
        - next_cursor
      properties:
        total:
          type: integer
          description: Rows matching the query.
        has_more:
          type: boolean
        next_cursor:
          type:
            - string
            - 'null'
          description: Send as cursor to get the next page. Valid for 6 hours.
    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:
    BadRequest:
      description: Malformed request or cursor.
      x-status: 400
      x-codes:
        - invalid_json
        - invalid_cursor
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
    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'
    Gone:
      description: The cursor expired; start the list again.
      x-status: 410
      x-codes:
        - cursor_expired
      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.