name: kyc-entity-verification
title: Moody's KYC Entity Verification (Kompany / Maxsight)
description: >-
  Verify a business entity in real time against authoritative primary-source
  government registers; return legal entity records, ultimate beneficial
  owners, and registered documents to satisfy KYC, KYB, AML, and CDD
  requirements.
provider: moodys-corporation
api: moodys-kyc-api
version: 0.1.0

inputs:
  - name: company_name
    type: string
    required: false
  - name: country
    type: string
    required: true
  - name: registration_number
    type: string
    required: false

outputs:
  - name: entity
    type: object
  - name: documents
    type: array
  - name: ubos
    type: array

operations:
  - operationId: liveSearch
    method: GET
    path: /v2/live/search
  - operationId: getEntity
    method: GET
    path: /v2/entities/{id}
  - operationId: getUbos
    method: GET
    path: /v2/entities/{id}/ubos

failure_modes:
  - code: register_unavailable
    description: Source government register temporarily unreachable.
  - code: not_found
    description: No matching entity in target register.