> ## 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 job changes at target accounts

> People who recently joined, or were promoted at, one of your target accounts and match your buying committee, newest first. Collected daily once job-change tracking is turned on under Target Accounts. A person appears once per company; last_seen_at moves forward while the change is still being reported (about 90 days).



## OpenAPI

````yaml /openapi.json get /target-accounts/job-changes
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/job-changes:
    get:
      tags:
        - Target accounts
      summary: List job changes at target accounts
      description: >-
        People who recently joined, or were promoted at, one of your target
        accounts and match your buying committee, newest first. Collected daily
        once job-change tracking is turned on under Target Accounts. A person
        appears once per company; last_seen_at moves forward while the change is
        still being reported (about 90 days).
      operationId: listTargetAccountJobChanges
      parameters:
        - name: since
          in: query
          required: false
          description: Only job changes first seen at or after this date.
          schema:
            type: string
        - name: until
          in: query
          required: false
          description: Only job changes first seen before this date.
          schema:
            type: string
        - name: company_domain
          in: query
          required: false
          description: Only job changes into this target account, by domain.
          schema:
            type: string
            minLength: 1
            maxLength: 255
        - name: company_linkedin_url
          in: query
          required: false
          description: Only job changes into this target account, by company page URL.
          schema:
            type: string
            minLength: 1
            maxLength: 500
        - name: change_type
          in: query
          required: false
          description: >-
            new_hire (joined the company), promotion (new role at the same
            company) or unknown.
          schema:
            type: string
            enum:
              - new_hire
              - promotion
              - unknown
        - 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:
                      job_changes:
                        type: array
                        items:
                          $ref: '#/components/schemas/JobChange'
                  meta:
                    $ref: '#/components/schemas/Meta'
                  pagination:
                    $ref: '#/components/schemas/Pagination'
              example:
                data:
                  job_changes:
                    - id: 6a2b9e0f1c3d5e0012cd56ef
                      contact_name: Sam Lee
                      contact_first_name: Sam
                      contact_last_name: Lee
                      contact_job_title: Director of Finance
                      contact_linkedin_url: https://example.com/in/sam-lee
                      contact_location: San Francisco Bay Area
                      company_name: Acme
                      company_domain: acme.com
                      company_linkedin_url: https://example.com/company/acme
                      target_account_id: 6a1f0c2e9b1d4c0012ab34cd
                      change_type: new_hire
                      started_role_on: 2026-09
                      first_seen_at: '2026-11-10T01:52:11.000Z'
                      last_seen_at: '2026-11-11T01:49:03.000Z'
                pagination:
                  total: 37
                  has_more: true
                  next_cursor: eyJ0IjoiMjAyNi0xMS0xMCJ9
                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:
  schemas:
    JobChange:
      type: object
      description: >-
        Someone who recently joined, or was promoted at, one of your target
        accounts and matches your buying committee.
      properties:
        id:
          type: string
        contact_name:
          type: string
        contact_first_name:
          type: string
        contact_last_name:
          type: string
        contact_job_title:
          type: string
          description: Their title in the new role.
        contact_linkedin_url:
          type: string
          description: Their profile URL.
        contact_location:
          type: string
        company_name:
          type: string
          description: The company they moved into.
        company_domain:
          type: string
          description: The target account's domain.
        company_linkedin_url:
          type: string
          description: The target account's page URL.
        target_account_id:
          type:
            - string
            - 'null'
          description: The target account they moved into.
        change_type:
          type: string
          description: >-
            new_hire: joined the company. promotion: a new role at a company
            they were already at. unknown: not reported either way.
          x-values:
            - new_hire
            - promotion
            - unknown
        started_role_on:
          type:
            - string
            - 'null'
          description: When they started the role, YYYY-MM.
        first_seen_at:
          type: string
          format: date-time
          description: When we first collected this change. since/until filter on it.
        last_seen_at:
          type: string
          format: date-time
          description: The latest daily run that still reported it.
    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.