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

# How a company's score changed over time, and why

> Every recorded change of the stored score, newest first: the score, the previous score and delta, the pillar values, the causes (new events, fading activity, a profile change, company data or signal weights) and the events that arrived. Changes of 2 points or more, or with a cause other than fading activity, are recorded. Only for accounts on stored scoring.



## OpenAPI

````yaml /api-reference/openapi.json get /v1/trackers/{tracker_code}/companies/{company_id}/score/history
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}/companies/{company_id}/score/history:
    get:
      tags:
        - traffic
      summary: How a company's score changed over time, and why
      description: >-
        Every recorded change of the stored score, newest first: the score, the
        previous score and delta, the pillar values, the causes (new events,
        fading activity, a profile change, company data or signal weights) and
        the events that arrived. Changes of 2 points or more, or with a cause
        other than fading activity, are recorded. Only for accounts on stored
        scoring.
      operationId: >-
        company_score_history_v1_trackers__tracker_code__companies__company_id__score_history_get
      parameters:
        - name: tracker_code
          in: path
          required: true
          schema:
            type: string
            title: Tracker Code
        - name: company_id
          in: path
          required: true
          schema:
            type: integer
            title: Company Id
        - name: limit
          in: query
          required: false
          schema:
            type: integer
            maximum: 500
            minimum: 1
            title: Limit
            default: 50
        - name: offset
          in: query
          required: false
          schema:
            type: integer
            maximum: 100000
            minimum: 0
            description: Changes to skip; use meta.next_offset for the next page.
            default: 0
            title: Offset
          description: Changes to skip; use meta.next_offset for the next page.
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ScoreHistoryResponse'
        '401':
          description: Invalid credentials.
        '403':
          description: Tracker not owned by this client.
        '404':
          description: No stored scores for this account, or company not scored.
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
      security:
        - HTTPBearer: []
components:
  schemas:
    ScoreHistoryResponse:
      properties:
        company_id:
          type: integer
          title: Company Id
        current_score:
          anyOf:
            - type: integer
            - type: 'null'
          title: Current Score
        data:
          items:
            $ref: '#/components/schemas/ScoreHistoryItem'
          type: array
          title: Data
        meta:
          $ref: '#/components/schemas/ScoreHistoryMeta'
      type: object
      required:
        - company_id
        - data
        - meta
      title: ScoreHistoryResponse
    HTTPValidationError:
      properties:
        detail:
          items:
            $ref: '#/components/schemas/ValidationError'
          type: array
          title: Detail
      type: object
      title: HTTPValidationError
    ScoreHistoryItem:
      properties:
        scored_at:
          type: string
          format: date-time
          title: Scored At
        as_of:
          type: string
          format: date
          title: As Of
        score:
          type: integer
          title: Score
        previous_score:
          anyOf:
            - type: integer
            - type: 'null'
          title: Previous Score
        delta:
          anyOf:
            - type: integer
            - type: 'null'
          title: Delta
        tier:
          anyOf:
            - type: string
              enum:
                - hot
                - warm
                - cool
                - cold
            - type: 'null'
          title: Tier
        previous_tier:
          anyOf:
            - type: string
              enum:
                - hot
                - warm
                - cool
                - cold
            - type: 'null'
          title: Previous Tier
        summary:
          anyOf:
            - type: string
            - type: 'null'
          title: Summary
          description: What happened, in one or two plain sentences
        pillars:
          additionalProperties:
            anyOf:
              - type: integer
              - type: 'null'
          type: object
          title: Pillars
        changes:
          items:
            $ref: '#/components/schemas/ScoreChange'
          type: array
          title: Changes
        new_events:
          items:
            $ref: '#/components/schemas/ScoreEvent'
          type: array
          title: New Events
      type: object
      required:
        - scored_at
        - as_of
        - score
        - pillars
        - changes
      title: ScoreHistoryItem
    ScoreHistoryMeta:
      properties:
        total:
          anyOf:
            - type: integer
            - type: 'null'
          title: Total
        has_more:
          type: boolean
          title: Has More
        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.
        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:
        - has_more
        - returned
      title: ScoreHistoryMeta
    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
    ScoreEvent:
      properties:
        type:
          type: string
          title: Type
          description: Signal type, e.g. contact.email.replied_to_user
        label:
          type: string
          title: Label
          description: Human name of the signal
        at:
          type: string
          format: date
          title: At
        points:
          type: number
          title: Points
          description: Points the event adds today, after fading
        pillar:
          type: string
          enum:
            - engagement
            - people
          title: Pillar
          description: engagement for company activity, people for a contact's actions
          default: engagement
        persona:
          anyOf:
            - type: string
            - type: 'null'
          title: Persona
          description: 'people: the persona the contact matches, if any'
        count:
          type: integer
          title: Count
          description: Events of this type that day
          default: 1
        contact_id:
          anyOf:
            - type: integer
            - type: 'null'
          title: Contact Id
          description: Leads contact, when known
        detail:
          type: object
          title: Detail
        source:
          type: object
          title: Source
          description: 'Where the event lives: tracker code, or table and id'
        site:
          anyOf:
            - type: string
            - type: 'null'
          title: Site
          description: Domain of the tracker the event happened on
      type: object
      required:
        - type
        - label
        - at
        - points
      title: ScoreEvent
  securitySchemes:
    HTTPBearer:
      type: http
      scheme: bearer

````

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