> ## 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: Trust Intelligence API - Entity verification and risk scoring
  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
      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

````