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

# Why a company scores what it scores

> The unified score decomposed into its pillars (fit from the ICP Builder or the model, intent from the Intent Builder, persona-matched visitors, engagement), with the rules matched and missed, the pages viewed in the window, the observed facts and what the data cannot tell. Defaults to the 90-day engagement window.



## OpenAPI

````yaml /api-reference/openapi.json get /v1/trackers/{tracker_code}/companies/{company_id}/score
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:
    get:
      tags:
        - traffic
      summary: Why a company scores what it scores
      description: >-
        The unified score decomposed into its pillars (fit from the ICP Builder
        or the model, intent from the Intent Builder, persona-matched visitors,
        engagement), with the rules matched and missed, the pages viewed in the
        window, the observed facts and what the data cannot tell. Defaults to
        the 90-day engagement window.
      operationId: >-
        explain_company_score_v1_trackers__tracker_code__companies__company_id__score_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: start_date
          in: query
          required: false
          schema:
            anyOf:
              - type: string
                format: date
              - type: 'null'
            title: Start Date
        - name: end_date
          in: query
          required: false
          schema:
            anyOf:
              - type: string
                format: date
              - type: 'null'
            title: End Date
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/CompanyScoreExplanation'
        '401':
          description: Invalid credentials.
        '403':
          description: Tracker not owned by this client.
        '404':
          description: Company not seen on this tracker in the window.
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
      security:
        - HTTPBearer: []
components:
  schemas:
    CompanyScoreExplanation:
      properties:
        company:
          $ref: '#/components/schemas/CompanyRow'
        start_date:
          type: string
          format: date
          title: Start Date
        end_date:
          type: string
          format: date
          title: End Date
        scoring:
          anyOf:
            - $ref: '#/components/schemas/ScoringMeta'
            - type: 'null'
        pillars:
          items:
            $ref: '#/components/schemas/ScorePillar'
          type: array
          title: Pillars
        events:
          items:
            $ref: '#/components/schemas/ScoreEvent'
          type: array
          title: Events
          description: >-
            Stored scores only: the events that contribute most to the score
            today.
        pages:
          items:
            $ref: '#/components/schemas/CompanyPage'
          type: array
          title: Pages
          description: Pages the company viewed in the window, most viewed first.
        known:
          items:
            type: string
          type: array
          title: Known
          description: Observed facts.
        unknown:
          items:
            type: string
          type: array
          title: Unknown
          description: What the data cannot tell.
      type: object
      required:
        - company
        - start_date
        - end_date
        - pillars
      title: CompanyScoreExplanation
    HTTPValidationError:
      properties:
        detail:
          items:
            $ref: '#/components/schemas/ValidationError'
          type: array
          title: Detail
      type: object
      title: HTTPValidationError
    CompanyRow:
      properties:
        company_id:
          type: integer
          title: Company Id
        name:
          anyOf:
            - type: string
            - type: 'null'
          title: Name
        domain:
          anyOf:
            - type: string
            - type: 'null'
          title: Domain
        website_url:
          anyOf:
            - type: string
            - type: 'null'
          title: Website Url
        country:
          anyOf:
            - type: string
            - type: 'null'
          title: Country
        city:
          anyOf:
            - type: string
            - type: 'null'
          title: City
        province:
          anyOf:
            - type: string
            - type: 'null'
          title: Province
        postal_code:
          anyOf:
            - type: string
            - type: 'null'
          title: Postal Code
        employee_range:
          anyOf:
            - type: string
            - type: 'null'
          title: Employee Range
        employees:
          anyOf:
            - type: integer
            - type: 'null'
          title: Employees
        branch_code:
          anyOf:
            - type: integer
            - type: 'null'
          title: Branch Code
        branch_local:
          anyOf:
            - type: string
            - type: 'null'
          title: Branch Local
        branch_international:
          anyOf:
            - type: string
            - type: 'null'
          title: Branch International
        legal_form:
          anyOf:
            - type: string
            - type: 'null'
          title: Legal Form
        sales_volume:
          anyOf:
            - type: integer
            - type: 'null'
          title: Sales Volume
        founding_date:
          anyOf:
            - type: string
              format: date
            - type: 'null'
          title: Founding Date
        linkedin:
          anyOf:
            - type: string
            - type: 'null'
          title: Linkedin
        logo:
          anyOf:
            - type: string
            - type: 'null'
          title: Logo
        sessions:
          type: integer
          title: Sessions
        pages:
          type: integer
          title: Pages
        duration:
          type: integer
          title: Duration
        unique_visitors:
          type: integer
          title: Unique Visitors
          description: >-
            Distinct IP addresses seen for the company in the window; an
            approximation of distinct people.
        active_days:
          type: integer
          title: Active Days
        first_seen:
          type: string
          format: date-time
          title: First Seen
        last_seen:
          type: string
          format: date-time
          title: Last Seen
        last_source:
          anyOf:
            - type: string
            - type: 'null'
          title: Last Source
        last_medium:
          anyOf:
            - type: string
            - type: 'null'
          title: Last Medium
        visitors:
          type: integer
          title: Visitors
          default: 0
        persona_visitors:
          type: integer
          title: Persona Visitors
          description: >-
            Identified visitors in the window whose job title and country match
            one of your personas.
          default: 0
        form_submissions:
          type: integer
          title: Form Submissions
          default: 0
        leadbot_submissions:
          type: integer
          title: Leadbot Submissions
          default: 0
        sessions_total:
          type: integer
          title: Sessions Total
          description: >-
            Sessions in the last two years (the retention window), not bounded
            by the date window.
        pages_total:
          type: integer
          title: Pages Total
        duration_total:
          type: integer
          title: Duration Total
        is_new:
          type: boolean
          title: Is New
          description: No sessions before the date window.
        is_returning:
          type: boolean
          title: Is Returning
          description: Had sessions before the date window.
        lead_score:
          type: integer
          title: Lead Score
          description: >-
            Leadinfo lead score, 0-100, based on the company's visit days,
            sessions and pages on this tracker.
        is_ai_agent:
          type: boolean
          title: Is Ai Agent
          description: >-
            An AI assistant (Claude, ChatGPT, Perplexity, Meta AI or Gemini)
            fetching pages on a user's behalf or crawling. Useful for GEO; never
            a sales target and excluded from opportunities.
          default: false
        in_crm:
          type: boolean
          title: In Crm
          description: >-
            Linked to a record in one of the account's connected CRMs: an
            existing relationship Sales already knows about.
          default: false
        crm_integrations:
          items:
            type: string
          type: array
          title: Crm Integrations
          description: The connected CRMs holding this company, e.g. ['hubspot'].
        engagement_sessions:
          type: integer
          title: Engagement Sessions
          description: Sessions over the 90 days up to end_date.
          default: 0
        engagement_pages:
          type: integer
          title: Engagement Pages
          description: Pages over the 90 days up to end_date.
          default: 0
        engagement_unique_visitors:
          type: integer
          title: Engagement Unique Visitors
          description: Distinct IP addresses over the 90 days up to end_date.
          default: 0
        is_shared_network:
          type: boolean
          title: Is Shared Network
          description: >-
            Many distinct visitors with about one page per session over the 90
            days up to end_date: the signature of an ISP or shared office
            network rather than buying interest. Excluded from opportunities and
            from relationship=prospects.
          default: false
        engagement_score:
          type: integer
          title: Engagement Score
          description: >-
            0-100 engagement over the 90 days up to end_date, independent of
            start_date: the company's sessions and their extra pages, decayed
            with a 14-day half-life. Forms, Leadbot and identified visitors
            count in people_score instead.
        engagement_tier:
          type: string
          enum:
            - cold
            - warm
            - hot
          title: Engagement Tier
        icp_score:
          anyOf:
            - type: integer
            - type: 'null'
          title: Icp Score
          description: >-
            100 when the company matches every rule of an active ICP Builder
            profile, 0 otherwise; null when the account has no active ICP
            profile (the fit pillar then drops out of score).
        intent_score:
          anyOf:
            - type: integer
            - type: 'null'
          title: Intent Score
          description: >-
            0-100 from the page rules of the best-matching active Intent Builder
            profile the company triggered in the 90 days up to end_date: one
            rule about 50, two about 75, three about 85; null without a profile.
        score:
          type: integer
          title: Score
          description: >-
            Unified 0-100 score: fit (active ICP profiles), intent, engagement
            and people, weighted as in meta.scoring.weights; a pillar without an
            active profile drops out.
          default: 0
        score_tier:
          anyOf:
            - type: string
              enum:
                - hot
                - warm
                - cool
                - cold
            - type: 'null'
          title: Score Tier
          description: >-
            Tier of the unified score: hot 70 and up, warm 50 to 69, cool 30 to
            49, cold below 30.
        people_score:
          anyOf:
            - type: integer
            - type: 'null'
          title: People Score
          description: >-
            The people pillar, 0-100: contacts' actions, fading over time, in
            full for the best-matching persona's contacts and at half for anyone
            else; stored scores also count 30 when the contact database has
            persona matches at the company.
        score_as_of:
          anyOf:
            - type: string
              format: date
            - type: 'null'
          title: Score As Of
          description: >-
            Stored scores only: the date the stored score was last recomputed
            with a change.
        tags:
          items:
            $ref: '#/components/schemas/TagRef'
          type: array
          title: Tags
        score_breakdown:
          items:
            $ref: '#/components/schemas/ScorePillar'
          type: array
          title: Score Breakdown
        profile_scores:
          anyOf:
            - $ref: '#/components/schemas/ProfileScores'
            - type: 'null'
          description: >-
            Stored scores only: the pillar value for every active ICP, Intent
            profile and persona. fit, intent and people hold the best of each;
            to see the score for another profile, swap its value in and
            recombine with the pillar weights of score_breakdown.
      type: object
      required:
        - company_id
        - sessions
        - pages
        - duration
        - unique_visitors
        - active_days
        - first_seen
        - last_seen
        - sessions_total
        - pages_total
        - duration_total
        - is_new
        - is_returning
        - lead_score
        - engagement_score
        - engagement_tier
      title: CompanyRow
      description: >-
        A company row with its score breakdown, as the score explanation shows
        it.
    ScoringMeta:
      properties:
        icp_profiles:
          items:
            $ref: '#/components/schemas/ProfileName'
          type: array
          title: Icp Profiles
          description: Every active ICP Builder profile; fit is the best match among them.
        intent_profiles:
          items:
            $ref: '#/components/schemas/ProfileName'
          type: array
          title: Intent Profiles
          description: >-
            Every active Intent Builder profile; intent is the best match among
            them.
        weights:
          additionalProperties:
            type: integer
          type: object
          title: Weights
          description: >-
            Effective pillar weights in percent; pillars without a profile, and
            the persona pillar when inactive, are dropped and the rest
            renormalised.
        source:
          type: string
          enum:
            - live
            - stored
          title: Source
          description: >-
            stored: scores come from the scoring job, refreshed every 15 minutes
            and nightly, with history and an event feed; live: computed per
            request.
          default: live
        scored_at:
          anyOf:
            - type: string
              format: date-time
            - type: 'null'
          title: Scored At
          description: When the scoring job last ran for this account (stored only).
        scoring_version:
          anyOf:
            - type: string
            - type: 'null'
          title: Scoring Version
          description: Version of the scoring formula (stored only).
      type: object
      required:
        - weights
      title: ScoringMeta
    ScorePillar:
      properties:
        pillar:
          type: string
          enum:
            - fit
            - intent
            - engagement
            - people
          title: Pillar
          description: >-
            fit, intent, engagement (company activity) and people (contacts'
            actions), live and stored.
        source:
          type: string
          title: Source
          description: icp_builder, intent_builder, persona_builder or signals
        weight:
          type: integer
          title: Weight
          description: Share of the total score, in percent
        value:
          type: integer
          title: Value
          description: The pillar's own 0-100 value
        points:
          type: number
          title: Points
          description: weight/100 x value; the pillars sum to score
        profile:
          anyOf:
            - type: string
            - type: 'null'
          title: Profile
          description: >-
            fit and intent: the profile the company matches best (for fit
            without a match, the closest ICP), whose rules matched and unmatched
            list; people in stored scores: the best-matching persona.
        matched:
          items:
            type: string
          type: array
          title: Matched
        unmatched:
          items:
            type: string
          type: array
          title: Unmatched
      type: object
      required:
        - pillar
        - source
        - weight
        - value
        - points
      title: ScorePillar
    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
    CompanyPage:
      properties:
        url_pathname:
          anyOf:
            - type: string
            - type: 'null'
          title: Url Pathname
        views:
          type: integer
          title: Views
        first_seen:
          type: string
          format: date-time
          title: First Seen
        last_seen:
          type: string
          format: date-time
          title: Last Seen
        avg_duration_seconds:
          anyOf:
            - type: number
            - type: 'null'
          title: Avg Duration Seconds
      type: object
      required:
        - views
        - first_seen
        - last_seen
      title: CompanyPage
    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
    TagRef:
      properties:
        id:
          type: integer
          title: Id
        name:
          anyOf:
            - type: string
            - type: 'null'
          title: Name
      type: object
      required:
        - id
      title: TagRef
    ProfileScores:
      properties:
        icp:
          items:
            $ref: '#/components/schemas/ProfileScore'
          type: array
          title: Icp
          description: >-
            Fit per active ICP: 100 when the company matches all its rules, else
            0.
        intent:
          items:
            $ref: '#/components/schemas/ProfileScore'
          type: array
          title: Intent
          description: Intent per active Intent Builder profile.
        persona:
          items:
            $ref: '#/components/schemas/ProfileScore'
          type: array
          title: Persona
          description: >-
            People per active persona (that persona's contacts in full, others
            at half).
      type: object
      title: ProfileScores
    ProfileName:
      properties:
        id:
          type: integer
          title: Id
        name:
          type: string
          title: Name
      type: object
      required:
        - id
        - name
      title: ProfileName
    ProfileScore:
      properties:
        id:
          anyOf:
            - type: integer
            - type: 'null'
          title: Id
        name:
          anyOf:
            - type: string
            - type: 'null'
          title: Name
        value:
          anyOf:
            - type: integer
            - type: 'null'
          title: Value
          description: The pillar value (0-100) with only this profile.
      type: object
      title: ProfileScore
  securitySchemes:
    HTTPBearer:
      type: http
      scheme: bearer

````

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