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

# Get Score History

> Get trust score history for an entity (requires authentication).

Args:
    subject: Entity name/domain/wallet address
    limit: Maximum number of entries to return (default: 50, max: 1000)

Returns:
    ScoreHistoryResponse with entries and trend analysis



## OpenAPI

````yaml /api-reference/openapi.json get /v1/scores/{subject}/history
openapi: 3.1.0
info:
  title: Limitguard.ai
  description: >-
    Lead validation API: the company behind each lead checked against the NL and
    BE business registers, EU VAT and sanctions lists, plus company, KYB and
    agent wallet checks for developers and AI agents
  version: 0.1.0
servers:
  - url: https://api.limitguard.ai
security: []
paths:
  /v1/scores/{subject}/history:
    get:
      summary: Get Score History
      description: |-
        Get trust score history for an entity (requires authentication).

        Args:
            subject: Entity name/domain/wallet address
            limit: Maximum number of entries to return (default: 50, max: 1000)

        Returns:
            ScoreHistoryResponse with entries and trend analysis
      operationId: get_score_history_v1_scores__subject__history_get
      parameters:
        - name: subject
          in: path
          required: true
          schema:
            type: string
            title: Subject
        - name: limit
          in: query
          required: false
          schema:
            type: integer
            default: 50
            title: Limit
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ScoreHistoryResponse'
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
      security:
        - APIKeyHeader: []
components:
  schemas:
    ScoreHistoryResponse:
      properties:
        subject_hash:
          type: string
          title: Subject Hash
        entries:
          items:
            $ref: '#/components/schemas/ScoreHistoryEntry'
          type: array
          title: Entries
        total_entries:
          type: integer
          title: Total Entries
        trend:
          type: string
          enum:
            - improving
            - declining
            - stable
            - insufficient_data
          title: Trend
      type: object
      required:
        - subject_hash
        - entries
        - total_entries
        - trend
      title: ScoreHistoryResponse
      description: Trust score history for a subject with trend analysis.
    HTTPValidationError:
      properties:
        detail:
          items:
            $ref: '#/components/schemas/ValidationError'
          type: array
          title: Detail
      type: object
      title: HTTPValidationError
    ScoreHistoryEntry:
      properties:
        entry_id:
          type: string
          title: Entry Id
        subject:
          type: string
          title: Subject
          description: Entity name/domain/wallet address
        subject_hash:
          type: string
          title: Subject Hash
          description: SHA-256 hash of subject for privacy
        trust_score:
          type: integer
          maximum: 100
          minimum: 0
          title: Trust Score
          description: Trust score at this timestamp
        trust_level:
          type: string
          title: Trust Level
          description: high, medium, low, critical
        recorded_at:
          type: string
          format: date-time
          title: Recorded At
        source:
          type: string
          title: Source
          description: Source of this score
          default: api_check
        metadata:
          additionalProperties: true
          type: object
          title: Metadata
          description: Additional context
      type: object
      required:
        - subject
        - subject_hash
        - trust_score
        - trust_level
      title: ScoreHistoryEntry
      description: Single trust score history entry for an entity.
    ValidationError:
      properties:
        loc:
          items:
            anyOf:
              - type: string
              - type: integer
          type: array
          title: Location
        msg:
          type: string
          title: Message
        type:
          type: string
          title: Error Type
        input:
          title: Input
        ctx:
          type: object
          title: Context
      type: object
      required:
        - loc
        - msg
        - type
      title: ValidationError
  securitySchemes:
    APIKeyHeader:
      type: apiKey
      in: header
      name: X-API-Key

````

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