> ## 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 Badge JSON

> Return JSON badge data for entity.

Public endpoint (no auth) with CORS headers.

Args:
    entity_id: Entity identifier

Returns:
    BadgeData with trust score and metadata



## OpenAPI

````yaml /api-reference/openapi.json get /v1/badge/{entity_id}.json
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/badge/{entity_id}.json:
    get:
      summary: Get Badge JSON
      description: |-
        Return JSON badge data for entity.

        Public endpoint (no auth) with CORS headers.

        Args:
            entity_id: Entity identifier

        Returns:
            BadgeData with trust score and metadata
      operationId: get_badge_json_v1_badge__entity_id__json_get
      parameters:
        - name: entity_id
          in: path
          required: true
          schema:
            type: string
            title: Entity Id
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/BadgeData'
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
components:
  schemas:
    BadgeData:
      properties:
        entity_id:
          type: string
          title: Entity Id
          description: Entity identifier (email, domain, wallet)
        trust_score:
          type: integer
          maximum: 100
          minimum: 0
          title: Trust Score
          description: Trust score 0-100
        trust_level:
          type: string
          title: Trust Level
          description: Trust level (HIGH, MEDIUM, LOW)
        cluster:
          type: string
          title: Cluster
          description: Entity cluster classification
        last_verified:
          type: string
          format: date-time
          title: Last Verified
          description: Last verification timestamp
        sources_checked:
          type: integer
          minimum: 0
          title: Sources Checked
          description: Number of sources verified
      type: object
      required:
        - entity_id
        - trust_score
        - trust_level
        - cluster
        - last_verified
        - sources_checked
      title: BadgeData
      description: Badge data returned by /v1/badge/{entity_id}.json endpoint.
    HTTPValidationError:
      properties:
        detail:
          items:
            $ref: '#/components/schemas/ValidationError'
          type: array
          title: Detail
      type: object
      title: HTTPValidationError
    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

````

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