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

# Risk Score

> Quick risk assessment using country risk + sanctions only.

Faster than /entity/check (2 sources vs up to 8). Returns risk_score
where 0 = lowest risk, 100 = highest risk.



## OpenAPI

````yaml /api-reference/openapi.json post /v1/risk/score
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/risk/score:
    post:
      summary: Risk Score
      description: |-
        Quick risk assessment using country risk + sanctions only.

        Faster than /entity/check (2 sources vs up to 8). Returns risk_score
        where 0 = lowest risk, 100 = highest risk.
      operationId: risk_score_v1_risk_score_post
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/app__models__request__RiskScoreRequest'
        required: true
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/RiskResponse'
        '404':
          description: 'Not cached (X-Response-Quality: cached); no data source was called'
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '422':
          description: Validation error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '500':
          description: Internal error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
      security:
        - APIKeyHeader: []
components:
  schemas:
    app__models__request__RiskScoreRequest:
      properties:
        entity_name:
          type: string
          maxLength: 500
          minLength: 1
          title: Entity Name
          description: Legal entity name
        country:
          type: string
          maxLength: 2
          minLength: 2
          title: Country
          description: ISO 3166-1 alpha-2 country code
      additionalProperties: false
      type: object
      required:
        - entity_name
        - country
      title: RiskScoreRequest
      description: Lighter risk-only request - faster, fewer sources.
    RiskResponse:
      properties:
        risk_score:
          type: integer
          maximum: 100
          minimum: 0
          title: Risk Score
          description: Risk score (100 = highest risk)
        risk_level:
          $ref: '#/components/schemas/TrustLevel'
        recommendation:
          $ref: '#/components/schemas/Recommendation'
        top_factors:
          items:
            $ref: '#/components/schemas/TopFactor'
          type: array
          maxItems: 3
          title: Top Factors
        processing_time_ms:
          type: integer
          minimum: 0
          title: Processing Time Ms
        response_quality:
          type: string
          title: Response Quality
          description: 'Quality tier used for this response: cached or fresh'
          default: fresh
        disclaimers:
          items:
            type: string
          type: array
          title: Disclaimers
          description: Notes about this response, e.g. a retired pricing tier
      type: object
      required:
        - risk_score
        - risk_level
        - recommendation
        - top_factors
        - processing_time_ms
      title: RiskResponse
      description: Lighter risk-only response from /v1/risk/score.
    ErrorResponse:
      properties:
        type:
          type: string
          title: Type
          default: about:blank
        title:
          type: string
          title: Title
        status:
          type: integer
          title: Status
        detail:
          anyOf:
            - type: string
            - type: 'null'
          title: Detail
        instance:
          anyOf:
            - type: string
            - type: 'null'
          title: Instance
      type: object
      required:
        - title
        - status
      title: ErrorResponse
      description: RFC 7807 Problem Details response.
    TrustLevel:
      type: string
      enum:
        - high
        - medium
        - low
        - critical
      title: TrustLevel
    Recommendation:
      type: string
      enum:
        - proceed
        - review
        - enhanced_due_diligence
        - block
      title: Recommendation
    TopFactor:
      properties:
        source:
          type: string
          title: Source
          description: Data source name
        signal:
          type: string
          title: Signal
          description: What was found
        impact:
          type: string
          title: Impact
          description: positive, negative, or neutral
        weight:
          type: number
          title: Weight
          description: Contribution to score (0-1)
      type: object
      required:
        - source
        - signal
        - impact
        - weight
      title: TopFactor
  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.