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

# Companies whose score moved in a period, and why

> The movers feed for accounts on stored scoring: who rose, who fell and who became hot or warm in the last `days`, each with the score before and after, the tier, the causes merged per pillar and one plain-language summary such as 'Quillis rose from 58 to 63 and is now warm. New activity: form submissions'. Companies scored for the first time in the period only appear with `became`, as new entrants into that tier; the first scores of an account's very first scoring run are the baseline, not news. By default only movements driven by the companies themselves count (new activity, fading activity, company or contact data); changes caused by your own profile or setting edits are left out unless `include_setting_changes` is true. Tiers: hot 70 and up, warm 50 to 69, cool 30 to 49, cold below 30.



## OpenAPI

````yaml /api-reference/openapi.json get /v1/trackers/{tracker_code}/score-changes
openapi: 3.1.0
info:
  title: Leadinfo Data API
  version: 0.1.0
  x-logo:
    url: https://asset.leadinfo.com/assets/email_logo.png
servers:
  - url: https://data.leadinfo.com
    description: Production
security: []
paths:
  /v1/trackers/{tracker_code}/score-changes:
    get:
      tags:
        - traffic
      summary: Companies whose score moved in a period, and why
      description: >-
        The movers feed for accounts on stored scoring: who rose, who fell and
        who became hot or warm in the last `days`, each with the score before
        and after, the tier, the causes merged per pillar and one plain-language
        summary such as 'Quillis rose from 58 to 63 and is now warm. New
        activity: form submissions'. Companies scored for the first time in the
        period only appear with `became`, as new entrants into that tier; the
        first scores of an account's very first scoring run are the baseline,
        not news. By default only movements driven by the companies themselves
        count (new activity, fading activity, company or contact data); changes
        caused by your own profile or setting edits are left out unless
        `include_setting_changes` is true. Tiers: hot 70 and up, warm 50 to 69,
        cool 30 to 49, cold below 30.
      operationId: score_changes_v1_trackers__tracker_code__score_changes_get
      parameters:
        - name: tracker_code
          in: path
          required: true
          schema:
            type: string
            title: Tracker Code
        - name: days
          in: query
          required: false
          schema:
            type: integer
            maximum: 30
            minimum: 1
            description: Look back this many days
            default: 1
            title: Days
          description: Look back this many days
        - name: direction
          in: query
          required: false
          schema:
            enum:
              - up
              - down
              - any
            type: string
            default: up
            title: Direction
        - name: became
          in: query
          required: false
          schema:
            anyOf:
              - type: string
                enum:
                  - hot
                  - warm
              - type: 'null'
            description: Only companies that moved up into this tier in the period
            title: Became
          description: Only companies that moved up into this tier in the period
        - name: min_delta
          in: query
          required: false
          schema:
            type: integer
            maximum: 100
            minimum: 1
            default: 5
            title: Min Delta
        - name: relationship
          in: query
          required: false
          schema:
            enum:
              - all
              - prospects
              - existing
            type: string
            default: prospects
            title: Relationship
        - name: tag_ids
          in: query
          required: false
          schema:
            anyOf:
              - type: string
              - type: 'null'
            description: Comma-separated tag ids; company must carry any of them.
            title: Tag Ids
          description: Comma-separated tag ids; company must carry any of them.
        - name: exclude_tag_ids
          in: query
          required: false
          schema:
            anyOf:
              - type: string
              - type: 'null'
            description: Comma-separated tag ids; company must carry none of them.
            title: Exclude Tag Ids
          description: Comma-separated tag ids; company must carry none of them.
        - name: include_setting_changes
          in: query
          required: false
          schema:
            type: boolean
            default: false
            title: Include Setting Changes
        - name: limit
          in: query
          required: false
          schema:
            type: integer
            maximum: 200
            minimum: 1
            default: 20
            title: Limit
        - name: offset
          in: query
          required: false
          schema:
            type: integer
            maximum: 2000
            minimum: 0
            description: Movers to skip; use meta.next_offset for the next page.
            default: 0
            title: Offset
          description: Movers to skip; use meta.next_offset for the next page.
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ScoreChangesResponse'
        '401':
          description: Invalid credentials.
        '403':
          description: Tracker not owned by this client.
        '404':
          description: No stored scores for this account.
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
      security:
        - HTTPBearer: []
components:
  schemas:
    ScoreChangesResponse:
      properties:
        data:
          items:
            $ref: '#/components/schemas/ScoreMover'
          type: array
          title: Data
        meta:
          $ref: '#/components/schemas/ScoreChangesMeta'
      type: object
      required:
        - data
        - meta
      title: ScoreChangesResponse
    HTTPValidationError:
      properties:
        detail:
          items:
            $ref: '#/components/schemas/ValidationError'
          type: array
          title: Detail
      type: object
      title: HTTPValidationError
    ScoreMover:
      properties:
        company_id:
          type: integer
          title: Company Id
        name:
          anyOf:
            - type: string
            - type: 'null'
          title: Name
        domain:
          anyOf:
            - type: string
            - type: 'null'
          title: Domain
        country:
          anyOf:
            - type: string
            - type: 'null'
          title: Country
        previous_score:
          anyOf:
            - type: integer
            - type: 'null'
          title: Previous Score
          description: Score before the period; null for a first score
        score:
          type: integer
          title: Score
        delta:
          type: integer
          title: Delta
        previous_tier:
          anyOf:
            - type: string
              enum:
                - hot
                - warm
                - cool
                - cold
            - type: 'null'
          title: Previous Tier
        tier:
          type: string
          enum:
            - hot
            - warm
            - cool
            - cold
          title: Tier
        became:
          anyOf:
            - type: string
              enum:
                - hot
                - warm
            - type: 'null'
          title: Became
          description: Set when the company moved up into this tier during the period
        scored_at:
          type: string
          format: date-time
          title: Scored At
          description: The latest change in the period
        summary:
          type: string
          title: Summary
          description: What happened, in one or two plain sentences
        changes:
          items:
            $ref: '#/components/schemas/ScoreChange'
          type: array
          title: Changes
          description: Causes over the period, merged per cause and pillar, largest first
        in_crm:
          type: boolean
          title: In Crm
          default: false
        tag_ids:
          items:
            type: integer
          type: array
          title: Tag Ids
      type: object
      required:
        - company_id
        - score
        - delta
        - tier
        - scored_at
        - summary
        - changes
      title: ScoreMover
    ScoreChangesMeta:
      properties:
        total:
          anyOf:
            - type: integer
            - type: 'null'
          title: Total
        has_more:
          type: boolean
          title: Has More
          description: >-
            More movers match than were returned; ask again with
            offset=next_offset.
          default: false
        returned:
          type: integer
          title: Returned
        limit:
          anyOf:
            - type: integer
            - type: 'null'
          title: Limit
        offset:
          type: integer
          title: Offset
          default: 0
        next_offset:
          anyOf:
            - type: integer
            - type: 'null'
          title: Next Offset
          description: The offset of the next page; null on the last page.
        since:
          type: string
          format: date-time
          title: Since
        until:
          type: string
          format: date-time
          title: Until
        scored_at:
          anyOf:
            - type: string
              format: date-time
            - type: 'null'
          title: Scored At
        scoring_version:
          anyOf:
            - type: string
            - type: 'null'
          title: Scoring Version
      type: object
      required:
        - returned
        - since
        - until
      title: ScoreChangesMeta
    ValidationError:
      properties:
        loc:
          items:
            anyOf:
              - type: string
              - type: integer
          type: array
          title: Location
        msg:
          type: string
          title: Message
        type:
          type: string
          title: Error Type
      type: object
      required:
        - loc
        - msg
        - type
      title: ValidationError
    ScoreChange:
      properties:
        cause:
          type: string
          enum:
            - first_score
            - new_events
            - decay
            - profile_changed
            - company_data_changed
            - contact_data_changed
            - settings_changed
            - method_changed
          title: Cause
        pillar:
          anyOf:
            - type: string
            - type: 'null'
          title: Pillar
        points:
          anyOf:
            - type: number
            - type: 'null'
          title: Points
          description: Score points this cause added or removed
        summary:
          anyOf:
            - type: string
            - type: 'null'
          title: Summary
          description: The change in one plain sentence
        detail:
          type: object
          title: Detail
      type: object
      required:
        - cause
      title: ScoreChange
  securitySchemes:
    HTTPBearer:
      type: http
      scheme: bearer

````

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