didit-sdk 1.0.0

data/lib/didit/types/kyb.rb

@@ -0,0 +1,1391 @@
+# Code generated by codegen from openapi/*.json. DO NOT EDIT.
+# frozen_string_literal: true
+
+module Didit
+  module Types
+    # Whether the owner is a natural person or a corporate entity.
+    module KybListShareholdersResponse202KybRegistryBeneficialOwnersEntityType
+      PERSON = "person"
+      COMPANY = "company"
+
+      VALUES = [PERSON, COMPANY].freeze
+    end
+
+    # Known values of an open enum: the API may send others.
+    module KybListShareholdersResponse202KybRegistryBeneficialOwnersKycStatus
+      APPROVED = "Approved"
+      DECLINED = "Declined"
+      PENDING = "Pending"
+
+      VALUES = [APPROVED, DECLINED, PENDING].freeze
+    end
+
+    # Registry fetch lifecycle. Mirrored by `data_resolved`.
+    module KybListShareholdersResponse202KybRegistryFetchStatus
+      PENDING = "pending"
+      RESOLVED = "resolved"
+
+      VALUES = [PENDING, RESOLVED].freeze
+    end
+
+    # Status of an associated KYC session, when one was started for this officer. `null` otherwise.
+    module KybListShareholdersResponse202KybRegistryOfficersKycStatus
+      APPROVED = "Approved"
+      DECLINED = "Declined"
+      PENDING = "Pending"
+
+      VALUES = [APPROVED, DECLINED, PENDING].freeze
+    end
+
+    # Normalized role derived from the designation. Full 17-value model set; registry parsing on this endpoint
+    # typically emits director, non_executive_director, secretary, chairman, or company_officer.
+    module KybListShareholdersResponse202KybRegistryOfficersRole
+      DIRECTOR = "director"
+      NON_EXECUTIVE_DIRECTOR = "non_executive_director"
+      SECRETARY = "secretary"
+      CHAIRMAN = "chairman"
+      UBO = "ubo"
+      SHAREHOLDER = "shareholder"
+      REPRESENTATIVE = "representative"
+      FOUNDER = "founder"
+      LEGAL_ADVISOR = "legal_advisor"
+      AUTHORIZED_SIGNATORY = "authorized_signatory"
+      TRUSTEE = "trustee"
+      BENEFICIARY = "beneficiary"
+      COMPANY_OFFICER = "company_officer"
+      SETTLOR = "settlor"
+      PROTECTOR = "protector"
+      INVESTOR = "investor"
+      OTHER = "other"
+
+      VALUES = [DIRECTOR, NON_EXECUTIVE_DIRECTOR, SECRETARY, CHAIRMAN, UBO, SHAREHOLDER, REPRESENTATIVE, FOUNDER, LEGAL_ADVISOR, AUTHORIZED_SIGNATORY, TRUSTEE, BENEFICIARY, COMPANY_OFFICER, SETTLOR, PROTECTOR, INVESTOR, OTHER].freeze
+    end
+
+    # `delivered` when the ownership data came back, `not_held` when the ownership registry answered and does not list
+    # this company (see `registry_data.ownership_error`), `unavailable` when an ownership tier was requested but the
+    # registry had none for this company or could not be asked (see `registry_data.ownership_error`), `pending` when
+    # the ownership section has not been retrieved from the registry yet and Didit is still completing it,
+    # `not_requested` on the Lite tier.
+    module KybListShareholdersResponse202KybRegistryRegistryOwnershipStatus
+      NOT_REQUESTED = "not_requested"
+      DELIVERED = "delivered"
+      NOT_HELD = "not_held"
+      UNAVAILABLE = "unavailable"
+      PENDING = "pending"
+
+      VALUES = [NOT_REQUESTED, DELIVERED, NOT_HELD, UNAVAILABLE, PENDING].freeze
+    end
+
+    # Normalized company status as reported by the registry.
+    module KybListShareholdersResponse202KybRegistryRegistryStatus
+      ACTIVE = "active"
+      DISSOLVED = "dissolved"
+      DEREGISTERED = "deregistered"
+      SEE_FULL_DETAILS = "see full details"
+      AUTHORISED = "authorised"
+      APPOINTED_REPRESENTATIVE = "appointed representative"
+      UNAUTHORISED = "unauthorised"
+      INACTIVE = "inactive"
+      NO_LONGER_AUTHORISED = "no longer authorised"
+      CLOSED = "closed"
+      STRUCK_OFF = "struck off"
+
+      VALUES = [ACTIVE, DISSOLVED, DEREGISTERED, SEE_FULL_DETAILS, AUTHORISED, APPOINTED_REPRESENTATIVE, UNAUTHORISED, INACTIVE, NO_LONGER_AUTHORISED, CLOSED, STRUCK_OFF].freeze
+    end
+
+    # Same as the top-level `registry_tier_delivered`.
+    module KybListShareholdersResponse202KybRegistryRegistryTierDelivered
+      BASIC = "basic"
+      SHAREHOLDERS = "shareholders"
+      UBO = "ubo"
+
+      VALUES = [BASIC, SHAREHOLDERS, UBO].freeze
+    end
+
+    # Didit's assessment of the registry check (e.g. `In Review` when the company is not active in the registry or
+    # ownership data could not be derived).
+    module KybListShareholdersResponse202KybRegistryStatus
+      NOT_FINISHED = "Not Finished"
+      APPROVED = "Approved"
+      DECLINED = "Declined"
+      IN_REVIEW = "In Review"
+
+      VALUES = [NOT_FINISHED, APPROVED, DECLINED, IN_REVIEW].freeze
+    end
+
+    # The source that decided `vat_validation_status`: an official registry, or `format_rules`. `null` when no check
+    # ran.
+    module KybListShareholdersResponse202KybRegistryVatValidationSource
+      EU_VIES = "eu_vies"
+      PL_VAT_WHITE_LIST = "pl_vat_white_list"
+      NO_BRREG = "no_brreg"
+      CH_UID_REGISTER = "ch_uid_register"
+      BR_RECEITA_FEDERAL = "br_receita_federal"
+      CO_RUES = "co_rues"
+      CR_HACIENDA = "cr_hacienda"
+      EC_SRI = "ec_sri"
+      PY_DNIT = "py_dnit"
+      FORMAT_RULES = "format_rules"
+
+      VALUES = [EU_VIES, PL_VAT_WHITE_LIST, NO_BRREG, CH_UID_REGISTER, BR_RECEITA_FEDERAL, CO_RUES, CR_HACIENDA, EC_SRI, PY_DNIT, FORMAT_RULES].freeze
+    end
+
+    # Result of validating the VAT number or, when there is none, the `tax_number`, at registry submit. `valid` /
+    # `invalid`: decided by the official registry of the country (EU VIES, Norway, Switzerland, Brazil, Colombia,
+    # Costa Rica, Ecuador, Paraguay; Poland also by its domestic VAT register). `format_valid` / `invalid_format`:
+    # decided by the country's format and check-digit rules where no registry can be queried. `could_not_validate`:
+    # the registry was unavailable. `not_applicable`: no number, a country without registry or rules, or a sandbox
+    # session.
+    module KybListShareholdersResponse202KybRegistryVatValidationStatus
+      VALID = "valid"
+      INVALID = "invalid"
+      FORMAT_VALID = "format_valid"
+      INVALID_FORMAT = "invalid_format"
+      COULD_NOT_VALIDATE = "could_not_validate"
+      NOT_APPLICABLE = "not_applicable"
+
+      VALUES = [VALID, INVALID, FORMAT_VALID, INVALID_FORMAT, COULD_NOT_VALIDATE, NOT_APPLICABLE].freeze
+    end
+
+    # The tier actually delivered and billed. Lower than requested when the country's registries hold no ownership
+    # data, or the registry has no ownership record for this company.
+    module KybListShareholdersResponse202RegistryTierDelivered
+      BASIC = "basic"
+      SHAREHOLDERS = "shareholders"
+      UBO = "ubo"
+
+      VALUES = [BASIC, SHAREHOLDERS, UBO].freeze
+    end
+
+    # The tier this endpoint sells: `basic` (Lite) for select, `shareholders`, `ubo`.
+    module KybListShareholdersResponse202RegistryTierRequested
+      BASIC = "basic"
+      SHAREHOLDERS = "shareholders"
+      UBO = "ubo"
+
+      VALUES = [BASIC, SHAREHOLDERS, UBO].freeze
+    end
+
+    # Whether the owner is a natural person or a corporate entity.
+    module KybListShareholdersResponseKybRegistryBeneficialOwnersEntityType
+      PERSON = "person"
+      COMPANY = "company"
+
+      VALUES = [PERSON, COMPANY].freeze
+    end
+
+    # Known values of an open enum: the API may send others.
+    module KybListShareholdersResponseKybRegistryBeneficialOwnersKycStatus
+      APPROVED = "Approved"
+      DECLINED = "Declined"
+      PENDING = "Pending"
+
+      VALUES = [APPROVED, DECLINED, PENDING].freeze
+    end
+
+    # Registry fetch lifecycle. Mirrored by `data_resolved`.
+    module KybListShareholdersResponseKybRegistryFetchStatus
+      PENDING = "pending"
+      RESOLVED = "resolved"
+
+      VALUES = [PENDING, RESOLVED].freeze
+    end
+
+    # Status of an associated KYC session, when one was started for this officer. `null` otherwise.
+    module KybListShareholdersResponseKybRegistryOfficersKycStatus
+      APPROVED = "Approved"
+      DECLINED = "Declined"
+      PENDING = "Pending"
+
+      VALUES = [APPROVED, DECLINED, PENDING].freeze
+    end
+
+    # Normalized role derived from the designation. Full 17-value model set; registry parsing on this endpoint
+    # typically emits director, non_executive_director, secretary, chairman, or company_officer.
+    module KybListShareholdersResponseKybRegistryOfficersRole
+      DIRECTOR = "director"
+      NON_EXECUTIVE_DIRECTOR = "non_executive_director"
+      SECRETARY = "secretary"
+      CHAIRMAN = "chairman"
+      UBO = "ubo"
+      SHAREHOLDER = "shareholder"
+      REPRESENTATIVE = "representative"
+      FOUNDER = "founder"
+      LEGAL_ADVISOR = "legal_advisor"
+      AUTHORIZED_SIGNATORY = "authorized_signatory"
+      TRUSTEE = "trustee"
+      BENEFICIARY = "beneficiary"
+      COMPANY_OFFICER = "company_officer"
+      SETTLOR = "settlor"
+      PROTECTOR = "protector"
+      INVESTOR = "investor"
+      OTHER = "other"
+
+      VALUES = [DIRECTOR, NON_EXECUTIVE_DIRECTOR, SECRETARY, CHAIRMAN, UBO, SHAREHOLDER, REPRESENTATIVE, FOUNDER, LEGAL_ADVISOR, AUTHORIZED_SIGNATORY, TRUSTEE, BENEFICIARY, COMPANY_OFFICER, SETTLOR, PROTECTOR, INVESTOR, OTHER].freeze
+    end
+
+    # `delivered` when the ownership data came back, `not_held` when the ownership registry answered and does not list
+    # this company (see `registry_data.ownership_error`), `unavailable` when an ownership tier was requested but the
+    # registry had none for this company or could not be asked (see `registry_data.ownership_error`), `pending` when
+    # the ownership section has not been retrieved from the registry yet and Didit is still completing it,
+    # `not_requested` on the Lite tier.
+    module KybListShareholdersResponseKybRegistryRegistryOwnershipStatus
+      NOT_REQUESTED = "not_requested"
+      DELIVERED = "delivered"
+      NOT_HELD = "not_held"
+      UNAVAILABLE = "unavailable"
+      PENDING = "pending"
+
+      VALUES = [NOT_REQUESTED, DELIVERED, NOT_HELD, UNAVAILABLE, PENDING].freeze
+    end
+
+    # Normalized company status as reported by the registry.
+    module KybListShareholdersResponseKybRegistryRegistryStatus
+      ACTIVE = "active"
+      DISSOLVED = "dissolved"
+      DEREGISTERED = "deregistered"
+      SEE_FULL_DETAILS = "see full details"
+      AUTHORISED = "authorised"
+      APPOINTED_REPRESENTATIVE = "appointed representative"
+      UNAUTHORISED = "unauthorised"
+      INACTIVE = "inactive"
+      NO_LONGER_AUTHORISED = "no longer authorised"
+      CLOSED = "closed"
+      STRUCK_OFF = "struck off"
+
+      VALUES = [ACTIVE, DISSOLVED, DEREGISTERED, SEE_FULL_DETAILS, AUTHORISED, APPOINTED_REPRESENTATIVE, UNAUTHORISED, INACTIVE, NO_LONGER_AUTHORISED, CLOSED, STRUCK_OFF].freeze
+    end
+
+    # Same as the top-level `registry_tier_delivered`.
+    module KybListShareholdersResponseKybRegistryRegistryTierDelivered
+      BASIC = "basic"
+      SHAREHOLDERS = "shareholders"
+      UBO = "ubo"
+
+      VALUES = [BASIC, SHAREHOLDERS, UBO].freeze
+    end
+
+    # Didit's assessment of the registry check (e.g. `In Review` when the company is not active in the registry or
+    # ownership data could not be derived).
+    module KybListShareholdersResponseKybRegistryStatus
+      NOT_FINISHED = "Not Finished"
+      APPROVED = "Approved"
+      DECLINED = "Declined"
+      IN_REVIEW = "In Review"
+
+      VALUES = [NOT_FINISHED, APPROVED, DECLINED, IN_REVIEW].freeze
+    end
+
+    # The source that decided `vat_validation_status`: an official registry, or `format_rules`. `null` when no check
+    # ran.
+    module KybListShareholdersResponseKybRegistryVatValidationSource
+      EU_VIES = "eu_vies"
+      PL_VAT_WHITE_LIST = "pl_vat_white_list"
+      NO_BRREG = "no_brreg"
+      CH_UID_REGISTER = "ch_uid_register"
+      BR_RECEITA_FEDERAL = "br_receita_federal"
+      CO_RUES = "co_rues"
+      CR_HACIENDA = "cr_hacienda"
+      EC_SRI = "ec_sri"
+      PY_DNIT = "py_dnit"
+      FORMAT_RULES = "format_rules"
+
+      VALUES = [EU_VIES, PL_VAT_WHITE_LIST, NO_BRREG, CH_UID_REGISTER, BR_RECEITA_FEDERAL, CO_RUES, CR_HACIENDA, EC_SRI, PY_DNIT, FORMAT_RULES].freeze
+    end
+
+    # Result of validating the VAT number or, when there is none, the `tax_number`, at registry submit. `valid` /
+    # `invalid`: decided by the official registry of the country (EU VIES, Norway, Switzerland, Brazil, Colombia,
+    # Costa Rica, Ecuador, Paraguay; Poland also by its domestic VAT register). `format_valid` / `invalid_format`:
+    # decided by the country's format and check-digit rules where no registry can be queried. `could_not_validate`:
+    # the registry was unavailable. `not_applicable`: no number, a country without registry or rules, or a sandbox
+    # session.
+    module KybListShareholdersResponseKybRegistryVatValidationStatus
+      VALID = "valid"
+      INVALID = "invalid"
+      FORMAT_VALID = "format_valid"
+      INVALID_FORMAT = "invalid_format"
+      COULD_NOT_VALIDATE = "could_not_validate"
+      NOT_APPLICABLE = "not_applicable"
+
+      VALUES = [VALID, INVALID, FORMAT_VALID, INVALID_FORMAT, COULD_NOT_VALIDATE, NOT_APPLICABLE].freeze
+    end
+
+    # The tier actually delivered and billed. Lower than requested when the country's registries hold no ownership
+    # data, or the registry has no ownership record for this company.
+    module KybListShareholdersResponseRegistryTierDelivered
+      BASIC = "basic"
+      SHAREHOLDERS = "shareholders"
+      UBO = "ubo"
+
+      VALUES = [BASIC, SHAREHOLDERS, UBO].freeze
+    end
+
+    # The tier this endpoint sells: `basic` (Lite) for select, `shareholders`, `ubo`.
+    module KybListShareholdersResponseRegistryTierRequested
+      BASIC = "basic"
+      SHAREHOLDERS = "shareholders"
+      UBO = "ubo"
+
+      VALUES = [BASIC, SHAREHOLDERS, UBO].freeze
+    end
+
+    # Whether the owner is a natural person or a corporate entity.
+    module KybListUbosResponse202KybRegistryBeneficialOwnersEntityType
+      PERSON = "person"
+      COMPANY = "company"
+
+      VALUES = [PERSON, COMPANY].freeze
+    end
+
+    # Known values of an open enum: the API may send others.
+    module KybListUbosResponse202KybRegistryBeneficialOwnersKycStatus
+      APPROVED = "Approved"
+      DECLINED = "Declined"
+      PENDING = "Pending"
+
+      VALUES = [APPROVED, DECLINED, PENDING].freeze
+    end
+
+    # Registry fetch lifecycle. Mirrored by `data_resolved`.
+    module KybListUbosResponse202KybRegistryFetchStatus
+      PENDING = "pending"
+      RESOLVED = "resolved"
+
+      VALUES = [PENDING, RESOLVED].freeze
+    end
+
+    # Status of an associated KYC session, when one was started for this officer. `null` otherwise.
+    module KybListUbosResponse202KybRegistryOfficersKycStatus
+      APPROVED = "Approved"
+      DECLINED = "Declined"
+      PENDING = "Pending"
+
+      VALUES = [APPROVED, DECLINED, PENDING].freeze
+    end
+
+    # Normalized role derived from the designation. Full 17-value model set; registry parsing on this endpoint
+    # typically emits director, non_executive_director, secretary, chairman, or company_officer.
+    module KybListUbosResponse202KybRegistryOfficersRole
+      DIRECTOR = "director"
+      NON_EXECUTIVE_DIRECTOR = "non_executive_director"
+      SECRETARY = "secretary"
+      CHAIRMAN = "chairman"
+      UBO = "ubo"
+      SHAREHOLDER = "shareholder"
+      REPRESENTATIVE = "representative"
+      FOUNDER = "founder"
+      LEGAL_ADVISOR = "legal_advisor"
+      AUTHORIZED_SIGNATORY = "authorized_signatory"
+      TRUSTEE = "trustee"
+      BENEFICIARY = "beneficiary"
+      COMPANY_OFFICER = "company_officer"
+      SETTLOR = "settlor"
+      PROTECTOR = "protector"
+      INVESTOR = "investor"
+      OTHER = "other"
+
+      VALUES = [DIRECTOR, NON_EXECUTIVE_DIRECTOR, SECRETARY, CHAIRMAN, UBO, SHAREHOLDER, REPRESENTATIVE, FOUNDER, LEGAL_ADVISOR, AUTHORIZED_SIGNATORY, TRUSTEE, BENEFICIARY, COMPANY_OFFICER, SETTLOR, PROTECTOR, INVESTOR, OTHER].freeze
+    end
+
+    # `delivered` when the ownership data came back, `not_held` when the ownership registry answered and does not list
+    # this company (see `registry_data.ownership_error`), `unavailable` when an ownership tier was requested but the
+    # registry had none for this company or could not be asked (see `registry_data.ownership_error`), `pending` when
+    # the ownership section has not been retrieved from the registry yet and Didit is still completing it,
+    # `not_requested` on the Lite tier.
+    module KybListUbosResponse202KybRegistryRegistryOwnershipStatus
+      NOT_REQUESTED = "not_requested"
+      DELIVERED = "delivered"
+      NOT_HELD = "not_held"
+      UNAVAILABLE = "unavailable"
+      PENDING = "pending"
+
+      VALUES = [NOT_REQUESTED, DELIVERED, NOT_HELD, UNAVAILABLE, PENDING].freeze
+    end
+
+    # Normalized company status as reported by the registry.
+    module KybListUbosResponse202KybRegistryRegistryStatus
+      ACTIVE = "active"
+      DISSOLVED = "dissolved"
+      DEREGISTERED = "deregistered"
+      SEE_FULL_DETAILS = "see full details"
+      AUTHORISED = "authorised"
+      APPOINTED_REPRESENTATIVE = "appointed representative"
+      UNAUTHORISED = "unauthorised"
+      INACTIVE = "inactive"
+      NO_LONGER_AUTHORISED = "no longer authorised"
+      CLOSED = "closed"
+      STRUCK_OFF = "struck off"
+
+      VALUES = [ACTIVE, DISSOLVED, DEREGISTERED, SEE_FULL_DETAILS, AUTHORISED, APPOINTED_REPRESENTATIVE, UNAUTHORISED, INACTIVE, NO_LONGER_AUTHORISED, CLOSED, STRUCK_OFF].freeze
+    end
+
+    # Same as the top-level `registry_tier_delivered`.
+    module KybListUbosResponse202KybRegistryRegistryTierDelivered
+      BASIC = "basic"
+      SHAREHOLDERS = "shareholders"
+      UBO = "ubo"
+
+      VALUES = [BASIC, SHAREHOLDERS, UBO].freeze
+    end
+
+    # Didit's assessment of the registry check (e.g. `In Review` when the company is not active in the registry or
+    # ownership data could not be derived).
+    module KybListUbosResponse202KybRegistryStatus
+      NOT_FINISHED = "Not Finished"
+      APPROVED = "Approved"
+      DECLINED = "Declined"
+      IN_REVIEW = "In Review"
+
+      VALUES = [NOT_FINISHED, APPROVED, DECLINED, IN_REVIEW].freeze
+    end
+
+    # The source that decided `vat_validation_status`: an official registry, or `format_rules`. `null` when no check
+    # ran.
+    module KybListUbosResponse202KybRegistryVatValidationSource
+      EU_VIES = "eu_vies"
+      PL_VAT_WHITE_LIST = "pl_vat_white_list"
+      NO_BRREG = "no_brreg"
+      CH_UID_REGISTER = "ch_uid_register"
+      BR_RECEITA_FEDERAL = "br_receita_federal"
+      CO_RUES = "co_rues"
+      CR_HACIENDA = "cr_hacienda"
+      EC_SRI = "ec_sri"
+      PY_DNIT = "py_dnit"
+      FORMAT_RULES = "format_rules"
+
+      VALUES = [EU_VIES, PL_VAT_WHITE_LIST, NO_BRREG, CH_UID_REGISTER, BR_RECEITA_FEDERAL, CO_RUES, CR_HACIENDA, EC_SRI, PY_DNIT, FORMAT_RULES].freeze
+    end
+
+    # Result of validating the VAT number or, when there is none, the `tax_number`, at registry submit. `valid` /
+    # `invalid`: decided by the official registry of the country (EU VIES, Norway, Switzerland, Brazil, Colombia,
+    # Costa Rica, Ecuador, Paraguay; Poland also by its domestic VAT register). `format_valid` / `invalid_format`:
+    # decided by the country's format and check-digit rules where no registry can be queried. `could_not_validate`:
+    # the registry was unavailable. `not_applicable`: no number, a country without registry or rules, or a sandbox
+    # session.
+    module KybListUbosResponse202KybRegistryVatValidationStatus
+      VALID = "valid"
+      INVALID = "invalid"
+      FORMAT_VALID = "format_valid"
+      INVALID_FORMAT = "invalid_format"
+      COULD_NOT_VALIDATE = "could_not_validate"
+      NOT_APPLICABLE = "not_applicable"
+
+      VALUES = [VALID, INVALID, FORMAT_VALID, INVALID_FORMAT, COULD_NOT_VALIDATE, NOT_APPLICABLE].freeze
+    end
+
+    # The tier actually delivered and billed. Lower than requested when the country's registries hold no ownership
+    # data, when the registry has no ownership record for this company, or when the resolved report of a `ubo` request
+    # names no natural person as a beneficial owner.
+    module KybListUbosResponse202RegistryTierDelivered
+      BASIC = "basic"
+      SHAREHOLDERS = "shareholders"
+      UBO = "ubo"
+
+      VALUES = [BASIC, SHAREHOLDERS, UBO].freeze
+    end
+
+    # The tier this endpoint sells: `basic` (Lite) for select, `shareholders`, `ubo`.
+    module KybListUbosResponse202RegistryTierRequested
+      BASIC = "basic"
+      SHAREHOLDERS = "shareholders"
+      UBO = "ubo"
+
+      VALUES = [BASIC, SHAREHOLDERS, UBO].freeze
+    end
+
+    # Whether the owner is a natural person or a corporate entity.
+    module KybListUbosResponseKybRegistryBeneficialOwnersEntityType
+      PERSON = "person"
+      COMPANY = "company"
+
+      VALUES = [PERSON, COMPANY].freeze
+    end
+
+    # Known values of an open enum: the API may send others.
+    module KybListUbosResponseKybRegistryBeneficialOwnersKycStatus
+      APPROVED = "Approved"
+      DECLINED = "Declined"
+      PENDING = "Pending"
+
+      VALUES = [APPROVED, DECLINED, PENDING].freeze
+    end
+
+    # Registry fetch lifecycle. Mirrored by `data_resolved`.
+    module KybListUbosResponseKybRegistryFetchStatus
+      PENDING = "pending"
+      RESOLVED = "resolved"
+
+      VALUES = [PENDING, RESOLVED].freeze
+    end
+
+    # Status of an associated KYC session, when one was started for this officer. `null` otherwise.
+    module KybListUbosResponseKybRegistryOfficersKycStatus
+      APPROVED = "Approved"
+      DECLINED = "Declined"
+      PENDING = "Pending"
+
+      VALUES = [APPROVED, DECLINED, PENDING].freeze
+    end
+
+    # Normalized role derived from the designation. Full 17-value model set; registry parsing on this endpoint
+    # typically emits director, non_executive_director, secretary, chairman, or company_officer.
+    module KybListUbosResponseKybRegistryOfficersRole
+      DIRECTOR = "director"
+      NON_EXECUTIVE_DIRECTOR = "non_executive_director"
+      SECRETARY = "secretary"
+      CHAIRMAN = "chairman"
+      UBO = "ubo"
+      SHAREHOLDER = "shareholder"
+      REPRESENTATIVE = "representative"
+      FOUNDER = "founder"
+      LEGAL_ADVISOR = "legal_advisor"
+      AUTHORIZED_SIGNATORY = "authorized_signatory"
+      TRUSTEE = "trustee"
+      BENEFICIARY = "beneficiary"
+      COMPANY_OFFICER = "company_officer"
+      SETTLOR = "settlor"
+      PROTECTOR = "protector"
+      INVESTOR = "investor"
+      OTHER = "other"
+
+      VALUES = [DIRECTOR, NON_EXECUTIVE_DIRECTOR, SECRETARY, CHAIRMAN, UBO, SHAREHOLDER, REPRESENTATIVE, FOUNDER, LEGAL_ADVISOR, AUTHORIZED_SIGNATORY, TRUSTEE, BENEFICIARY, COMPANY_OFFICER, SETTLOR, PROTECTOR, INVESTOR, OTHER].freeze
+    end
+
+    # `delivered` when the ownership data came back, `not_held` when the ownership registry answered and does not list
+    # this company (see `registry_data.ownership_error`), `unavailable` when an ownership tier was requested but the
+    # registry had none for this company or could not be asked (see `registry_data.ownership_error`), `pending` when
+    # the ownership section has not been retrieved from the registry yet and Didit is still completing it,
+    # `not_requested` on the Lite tier.
+    module KybListUbosResponseKybRegistryRegistryOwnershipStatus
+      NOT_REQUESTED = "not_requested"
+      DELIVERED = "delivered"
+      NOT_HELD = "not_held"
+      UNAVAILABLE = "unavailable"
+      PENDING = "pending"
+
+      VALUES = [NOT_REQUESTED, DELIVERED, NOT_HELD, UNAVAILABLE, PENDING].freeze
+    end
+
+    # Normalized company status as reported by the registry.
+    module KybListUbosResponseKybRegistryRegistryStatus
+      ACTIVE = "active"
+      DISSOLVED = "dissolved"
+      DEREGISTERED = "deregistered"
+      SEE_FULL_DETAILS = "see full details"
+      AUTHORISED = "authorised"
+      APPOINTED_REPRESENTATIVE = "appointed representative"
+      UNAUTHORISED = "unauthorised"
+      INACTIVE = "inactive"
+      NO_LONGER_AUTHORISED = "no longer authorised"
+      CLOSED = "closed"
+      STRUCK_OFF = "struck off"
+
+      VALUES = [ACTIVE, DISSOLVED, DEREGISTERED, SEE_FULL_DETAILS, AUTHORISED, APPOINTED_REPRESENTATIVE, UNAUTHORISED, INACTIVE, NO_LONGER_AUTHORISED, CLOSED, STRUCK_OFF].freeze
+    end
+
+    # Same as the top-level `registry_tier_delivered`.
+    module KybListUbosResponseKybRegistryRegistryTierDelivered
+      BASIC = "basic"
+      SHAREHOLDERS = "shareholders"
+      UBO = "ubo"
+
+      VALUES = [BASIC, SHAREHOLDERS, UBO].freeze
+    end
+
+    # Didit's assessment of the registry check (e.g. `In Review` when the company is not active in the registry or
+    # ownership data could not be derived).
+    module KybListUbosResponseKybRegistryStatus
+      NOT_FINISHED = "Not Finished"
+      APPROVED = "Approved"
+      DECLINED = "Declined"
+      IN_REVIEW = "In Review"
+
+      VALUES = [NOT_FINISHED, APPROVED, DECLINED, IN_REVIEW].freeze
+    end
+
+    # The source that decided `vat_validation_status`: an official registry, or `format_rules`. `null` when no check
+    # ran.
+    module KybListUbosResponseKybRegistryVatValidationSource
+      EU_VIES = "eu_vies"
+      PL_VAT_WHITE_LIST = "pl_vat_white_list"
+      NO_BRREG = "no_brreg"
+      CH_UID_REGISTER = "ch_uid_register"
+      BR_RECEITA_FEDERAL = "br_receita_federal"
+      CO_RUES = "co_rues"
+      CR_HACIENDA = "cr_hacienda"
+      EC_SRI = "ec_sri"
+      PY_DNIT = "py_dnit"
+      FORMAT_RULES = "format_rules"
+
+      VALUES = [EU_VIES, PL_VAT_WHITE_LIST, NO_BRREG, CH_UID_REGISTER, BR_RECEITA_FEDERAL, CO_RUES, CR_HACIENDA, EC_SRI, PY_DNIT, FORMAT_RULES].freeze
+    end
+
+    # Result of validating the VAT number or, when there is none, the `tax_number`, at registry submit. `valid` /
+    # `invalid`: decided by the official registry of the country (EU VIES, Norway, Switzerland, Brazil, Colombia,
+    # Costa Rica, Ecuador, Paraguay; Poland also by its domestic VAT register). `format_valid` / `invalid_format`:
+    # decided by the country's format and check-digit rules where no registry can be queried. `could_not_validate`:
+    # the registry was unavailable. `not_applicable`: no number, a country without registry or rules, or a sandbox
+    # session.
+    module KybListUbosResponseKybRegistryVatValidationStatus
+      VALID = "valid"
+      INVALID = "invalid"
+      FORMAT_VALID = "format_valid"
+      INVALID_FORMAT = "invalid_format"
+      COULD_NOT_VALIDATE = "could_not_validate"
+      NOT_APPLICABLE = "not_applicable"
+
+      VALUES = [VALID, INVALID, FORMAT_VALID, INVALID_FORMAT, COULD_NOT_VALIDATE, NOT_APPLICABLE].freeze
+    end
+
+    # The tier actually delivered and billed. Lower than requested when the country's registries hold no ownership
+    # data, when the registry has no ownership record for this company, or when the resolved report of a `ubo` request
+    # names no natural person as a beneficial owner.
+    module KybListUbosResponseRegistryTierDelivered
+      BASIC = "basic"
+      SHAREHOLDERS = "shareholders"
+      UBO = "ubo"
+
+      VALUES = [BASIC, SHAREHOLDERS, UBO].freeze
+    end
+
+    # The tier this endpoint sells: `basic` (Lite) for select, `shareholders`, `ubo`.
+    module KybListUbosResponseRegistryTierRequested
+      BASIC = "basic"
+      SHAREHOLDERS = "shareholders"
+      UBO = "ubo"
+
+      VALUES = [BASIC, SHAREHOLDERS, UBO].freeze
+    end
+
+    # Name-matching strategy applied by the registry search. `contains` is the only accepted value: no registry source
+    # behind the search offers a prefix or fuzzy mode, so `start_with` and `fuzzy` are rejected with `400` (`not a
+    # valid choice`).
+    module KybSearchParamsSearchType
+      CONTAINS = "contains"
+
+      VALUES = [CONTAINS].freeze
+    end
+
+    # Registry tier whose provider chain this search runs on. `basic` (default) searches the country's Lite chain;
+    # `shareholders` and `ubo` search that tier's ownership chain, which can be a different source, so an empty Lite
+    # search does not prove the registry lacks the company. A country that does not offer the named tier is searched
+    # at the highest tier it offers up to that one. Retrieve the candidate from the endpoint that sells the tier you
+    # searched: `POST /v3/kyb/select/` (Lite), `POST /v3/kyb/shareholders/` or `POST /v3/kyb/ubo/`.
+    module KybSearchParamsTier
+      BASIC = "basic"
+      SHAREHOLDERS = "shareholders"
+      UBO = "ubo"
+
+      VALUES = [BASIC, SHAREHOLDERS, UBO].freeze
+    end
+
+    # Whether the owner is a natural person or a corporate entity.
+    module KybSelectResponseKybRegistryBeneficialOwnersEntityType
+      PERSON = "person"
+      COMPANY = "company"
+
+      VALUES = [PERSON, COMPANY].freeze
+    end
+
+    # Known values of an open enum: the API may send others.
+    module KybSelectResponseKybRegistryBeneficialOwnersKycStatus
+      APPROVED = "Approved"
+      DECLINED = "Declined"
+      PENDING = "Pending"
+
+      VALUES = [APPROVED, DECLINED, PENDING].freeze
+    end
+
+    # Registry fetch lifecycle. Mirrored by `data_resolved`.
+    module KybSelectResponseKybRegistryFetchStatus
+      PENDING = "pending"
+      RESOLVED = "resolved"
+
+      VALUES = [PENDING, RESOLVED].freeze
+    end
+
+    # Status of an associated KYC session, when one was started for this officer. `null` otherwise.
+    module KybSelectResponseKybRegistryOfficersKycStatus
+      APPROVED = "Approved"
+      DECLINED = "Declined"
+      PENDING = "Pending"
+
+      VALUES = [APPROVED, DECLINED, PENDING].freeze
+    end
+
+    # Normalized role derived from the designation. Full 17-value model set; registry parsing on this endpoint
+    # typically emits director, non_executive_director, secretary, chairman, or company_officer.
+    module KybSelectResponseKybRegistryOfficersRole
+      DIRECTOR = "director"
+      NON_EXECUTIVE_DIRECTOR = "non_executive_director"
+      SECRETARY = "secretary"
+      CHAIRMAN = "chairman"
+      UBO = "ubo"
+      SHAREHOLDER = "shareholder"
+      REPRESENTATIVE = "representative"
+      FOUNDER = "founder"
+      LEGAL_ADVISOR = "legal_advisor"
+      AUTHORIZED_SIGNATORY = "authorized_signatory"
+      TRUSTEE = "trustee"
+      BENEFICIARY = "beneficiary"
+      COMPANY_OFFICER = "company_officer"
+      SETTLOR = "settlor"
+      PROTECTOR = "protector"
+      INVESTOR = "investor"
+      OTHER = "other"
+
+      VALUES = [DIRECTOR, NON_EXECUTIVE_DIRECTOR, SECRETARY, CHAIRMAN, UBO, SHAREHOLDER, REPRESENTATIVE, FOUNDER, LEGAL_ADVISOR, AUTHORIZED_SIGNATORY, TRUSTEE, BENEFICIARY, COMPANY_OFFICER, SETTLOR, PROTECTOR, INVESTOR, OTHER].freeze
+    end
+
+    # `delivered` when the ownership data came back, `not_held` when the ownership registry answered and does not list
+    # this company (see `registry_data.ownership_error`), `unavailable` when an ownership tier was requested but the
+    # registry had none for this company or could not be asked (see `registry_data.ownership_error`), `not_requested`
+    # on the Lite tier.
+    module KybSelectResponseKybRegistryRegistryOwnershipStatus
+      NOT_REQUESTED = "not_requested"
+      DELIVERED = "delivered"
+      NOT_HELD = "not_held"
+      UNAVAILABLE = "unavailable"
+
+      VALUES = [NOT_REQUESTED, DELIVERED, NOT_HELD, UNAVAILABLE].freeze
+    end
+
+    # Normalized company status as reported by the registry.
+    module KybSelectResponseKybRegistryRegistryStatus
+      ACTIVE = "active"
+      DISSOLVED = "dissolved"
+      DEREGISTERED = "deregistered"
+      SEE_FULL_DETAILS = "see full details"
+      AUTHORISED = "authorised"
+      APPOINTED_REPRESENTATIVE = "appointed representative"
+      UNAUTHORISED = "unauthorised"
+      INACTIVE = "inactive"
+      NO_LONGER_AUTHORISED = "no longer authorised"
+      CLOSED = "closed"
+      STRUCK_OFF = "struck off"
+
+      VALUES = [ACTIVE, DISSOLVED, DEREGISTERED, SEE_FULL_DETAILS, AUTHORISED, APPOINTED_REPRESENTATIVE, UNAUTHORISED, INACTIVE, NO_LONGER_AUTHORISED, CLOSED, STRUCK_OFF].freeze
+    end
+
+    # Same as the top-level `registry_tier_delivered`.
+    module KybSelectResponseKybRegistryRegistryTierDelivered
+      BASIC = "basic"
+      SHAREHOLDERS = "shareholders"
+      UBO = "ubo"
+
+      VALUES = [BASIC, SHAREHOLDERS, UBO].freeze
+    end
+
+    # Didit's assessment of the registry check (e.g. `In Review` when the company is not active in the registry or
+    # ownership data could not be derived).
+    module KybSelectResponseKybRegistryStatus
+      NOT_FINISHED = "Not Finished"
+      APPROVED = "Approved"
+      DECLINED = "Declined"
+      IN_REVIEW = "In Review"
+
+      VALUES = [NOT_FINISHED, APPROVED, DECLINED, IN_REVIEW].freeze
+    end
+
+    # The source that decided `vat_validation_status`: an official registry, or `format_rules`. `null` when no check
+    # ran.
+    module KybSelectResponseKybRegistryVatValidationSource
+      EU_VIES = "eu_vies"
+      PL_VAT_WHITE_LIST = "pl_vat_white_list"
+      NO_BRREG = "no_brreg"
+      CH_UID_REGISTER = "ch_uid_register"
+      BR_RECEITA_FEDERAL = "br_receita_federal"
+      CO_RUES = "co_rues"
+      CR_HACIENDA = "cr_hacienda"
+      EC_SRI = "ec_sri"
+      PY_DNIT = "py_dnit"
+      FORMAT_RULES = "format_rules"
+
+      VALUES = [EU_VIES, PL_VAT_WHITE_LIST, NO_BRREG, CH_UID_REGISTER, BR_RECEITA_FEDERAL, CO_RUES, CR_HACIENDA, EC_SRI, PY_DNIT, FORMAT_RULES].freeze
+    end
+
+    # Result of validating the VAT number or, when there is none, the `tax_number`, at registry submit. `valid` /
+    # `invalid`: decided by the official registry of the country (EU VIES, Norway, Switzerland, Brazil, Colombia,
+    # Costa Rica, Ecuador, Paraguay; Poland also by its domestic VAT register). `format_valid` / `invalid_format`:
+    # decided by the country's format and check-digit rules where no registry can be queried. `could_not_validate`:
+    # the registry was unavailable. `not_applicable`: no number, a country without registry or rules, or a sandbox
+    # session.
+    module KybSelectResponseKybRegistryVatValidationStatus
+      VALID = "valid"
+      INVALID = "invalid"
+      FORMAT_VALID = "format_valid"
+      INVALID_FORMAT = "invalid_format"
+      COULD_NOT_VALIDATE = "could_not_validate"
+      NOT_APPLICABLE = "not_applicable"
+
+      VALUES = [VALID, INVALID, FORMAT_VALID, INVALID_FORMAT, COULD_NOT_VALIDATE, NOT_APPLICABLE].freeze
+    end
+
+    # The tier actually delivered and billed. Lower than requested when the country's registries hold no ownership
+    # data, or the registry has no ownership record for this company.
+    module KybSelectResponseRegistryTierDelivered
+      BASIC = "basic"
+      SHAREHOLDERS = "shareholders"
+      UBO = "ubo"
+
+      VALUES = [BASIC, SHAREHOLDERS, UBO].freeze
+    end
+
+    # The tier this endpoint sells: `basic` (Lite) for select, `shareholders`, `ubo`.
+    module KybSelectResponseRegistryTierRequested
+      BASIC = "basic"
+      SHAREHOLDERS = "shareholders"
+      UBO = "ubo"
+
+      VALUES = [BASIC, SHAREHOLDERS, UBO].freeze
+    end
+
+    class KybListShareholdersResponse < Didit::Model
+      field :request_id, "request_id", :string
+      field :registry_tier_requested, "registry_tier_requested", :string
+      field :registry_tier_delivered, "registry_tier_delivered", :string
+      field :kyb_registry, "kyb_registry", "KybListShareholdersResponseKybRegistry"
+      field :vendor_data, "vendor_data", :string
+      field :metadata, "metadata", :any
+      field :created_at, "created_at", :datetime
+    end
+
+    class KybListShareholdersResponse202 < Didit::Model
+      field :request_id, "request_id", :string
+      field :registry_tier_requested, "registry_tier_requested", :string
+      field :registry_tier_delivered, "registry_tier_delivered", :string
+      field :kyb_registry, "kyb_registry", "KybListShareholdersResponse202KybRegistry"
+      field :vendor_data, "vendor_data", :string
+      field :metadata, "metadata", :any
+      field :created_at, "created_at", :datetime
+    end
+
+    # Full registry company profile.
+    class KybListShareholdersResponse202KybRegistry < Didit::Model
+      field :uuid, "uuid", :string
+      field :node_id, "node_id", :string
+      field :status, "status", :string
+      field :registry_status, "registry_status", :string
+      field :data_resolved, "data_resolved", :boolean
+      field :company_name, "company_name", :string
+      field :registration_number, "registration_number", :string
+      field :country_code, "country_code", :string
+      field :region, "region", :string
+      field :company_type, "company_type", :string
+      field :incorporation_date, "incorporation_date", :date
+      field :registered_address, "registered_address", :string
+      field :tax_number, "tax_number", :string
+      field :risk_level, "risk_level", :string
+      field :verification_status, "verification_status", :string
+      field :is_from_registry, "is_from_registry", :boolean
+      field :fetch_status, "fetch_status", :string
+      field :alternative_names, "alternative_names", :string
+      field :nature_of_business, "nature_of_business", :string
+      field :registered_capital, "registered_capital", :string
+      field :registered_capital_amount, "registered_capital_amount", :string
+      field :registered_capital_currency, "registered_capital_currency", :string
+      field :website, "website", :string
+      field :email, "email", :string
+      field :phone, "phone", :string
+      field :legal_entity_identifier, "legal_entity_identifier", :string
+      field :location_of_registration, "location_of_registration", :string
+      field :vat_number, "vat_number", :string
+      field :vat_validation_status, "vat_validation_status", :string
+      field :vat_validated_number, "vat_validated_number", :string
+      field :vat_validation_source, "vat_validation_source", :string
+      field :vat_validated_name, "vat_validated_name", :string
+      field :vat_validated_address, "vat_validated_address", :string
+      field :vat_checked_at, "vat_checked_at", :datetime
+      field :financial_summary, "financial_summary", :any
+      field :officers, "officers", [:array, "KybListShareholdersResponse202KybRegistryOfficers"]
+      field :beneficial_owners, "beneficial_owners", [:array, "KybListShareholdersResponse202KybRegistryBeneficialOwners"]
+      field :addresses, "addresses", [:array, "KYBRegistryAddress"]
+      field :industries, "industries", [:array, "KYBRegistryIndustry"]
+      field :accounts, "accounts", :any
+      field :registry_data, "registry_data", :any
+      field :user_provided_data, "user_provided_data", :any
+      field :confirmed_by_user_at, "confirmed_by_user_at", :datetime
+      field :last_console_edit_at, "last_console_edit_at", :datetime
+      field :is_editable, "is_editable", :boolean
+      field :registry_tier_delivered, "registry_tier_delivered", :string
+      field :registry_ownership_status, "registry_ownership_status", :string
+      field :ownership, "ownership", "KYBRegistryOwnership"
+      field :registry_tier, "registry_tier", :string
+    end
+
+    class KybListShareholdersResponse202KybRegistryBeneficialOwners < Didit::Model
+      field :uuid, "uuid", :string
+      field :name, "name", :string
+      field :first_name, "first_name", :string
+      field :last_name, "last_name", :string
+      field :entity_type, "entity_type", :string
+      field :roles, "roles", [:array, :string]
+      field :ownership_min_shares, "ownership_min_shares", :string
+      field :ownership_max_shares, "ownership_max_shares", :string
+      field :is_active, "is_active", :boolean
+      field :kyc_status, "kyc_status", :string
+      field :kyc_session_url, "kyc_session_url", :string
+      field :effective_ownership_percent, "effective_ownership_percent", :float
+      field :company_name, "company_name", :string
+      field :registration_number, "registration_number", :string
+      field :country_of_birth, "country_of_birth", :string
+      field :email, "email", :string
+      field :nationality, "nationality", :string
+      field :designation, "designation", :string
+      field :voting_min_shares, "voting_min_shares", :string
+      field :voting_max_shares, "voting_max_shares", :string
+      field :date_of_birth, "date_of_birth", :date
+      field :appointment_date, "appointment_date", :date
+      field :shareholding, "shareholding", "KYBRegistryShareholding"
+    end
+
+    class KybListShareholdersResponse202KybRegistryOfficers < Didit::Model
+      field :uuid, "uuid", :string
+      field :name, "name", :string
+      field :designation, "designation", :string
+      field :role, "role", :string
+      field :nationality, "nationality", :string
+      field :is_active, "is_active", :boolean
+      field :kyc_status, "kyc_status", :string
+      field :kyc_session_url, "kyc_session_url", :string
+      field :first_name, "first_name", :string
+      field :last_name, "last_name", :string
+      field :address, "address", :string
+      field :appointment_date, "appointment_date", :date
+      field :termination_date, "termination_date", :date
+      field :date_of_birth, "date_of_birth", :date
+      field :date_of_birth_year, "date_of_birth_year", :integer
+      field :date_of_birth_month, "date_of_birth_month", :integer
+    end
+
+    # Full registry company profile.
+    class KybListShareholdersResponseKybRegistry < Didit::Model
+      field :uuid, "uuid", :string
+      field :node_id, "node_id", :string
+      field :status, "status", :string
+      field :registry_status, "registry_status", :string
+      field :data_resolved, "data_resolved", :boolean
+      field :company_name, "company_name", :string
+      field :registration_number, "registration_number", :string
+      field :country_code, "country_code", :string
+      field :region, "region", :string
+      field :company_type, "company_type", :string
+      field :incorporation_date, "incorporation_date", :date
+      field :registered_address, "registered_address", :string
+      field :tax_number, "tax_number", :string
+      field :risk_level, "risk_level", :string
+      field :verification_status, "verification_status", :string
+      field :is_from_registry, "is_from_registry", :boolean
+      field :fetch_status, "fetch_status", :string
+      field :alternative_names, "alternative_names", :string
+      field :nature_of_business, "nature_of_business", :string
+      field :registered_capital, "registered_capital", :string
+      field :registered_capital_amount, "registered_capital_amount", :string
+      field :registered_capital_currency, "registered_capital_currency", :string
+      field :website, "website", :string
+      field :email, "email", :string
+      field :phone, "phone", :string
+      field :legal_entity_identifier, "legal_entity_identifier", :string
+      field :location_of_registration, "location_of_registration", :string
+      field :vat_number, "vat_number", :string
+      field :vat_validation_status, "vat_validation_status", :string
+      field :vat_validated_number, "vat_validated_number", :string
+      field :vat_validation_source, "vat_validation_source", :string
+      field :vat_validated_name, "vat_validated_name", :string
+      field :vat_validated_address, "vat_validated_address", :string
+      field :vat_checked_at, "vat_checked_at", :datetime
+      field :financial_summary, "financial_summary", :any
+      field :officers, "officers", [:array, "KybListShareholdersResponseKybRegistryOfficers"]
+      field :beneficial_owners, "beneficial_owners", [:array, "KybListShareholdersResponseKybRegistryBeneficialOwners"]
+      field :addresses, "addresses", [:array, "KYBRegistryAddress"]
+      field :industries, "industries", [:array, "KYBRegistryIndustry"]
+      field :accounts, "accounts", :any
+      field :registry_data, "registry_data", :any
+      field :user_provided_data, "user_provided_data", :any
+      field :confirmed_by_user_at, "confirmed_by_user_at", :datetime
+      field :last_console_edit_at, "last_console_edit_at", :datetime
+      field :is_editable, "is_editable", :boolean
+      field :registry_tier_delivered, "registry_tier_delivered", :string
+      field :registry_ownership_status, "registry_ownership_status", :string
+      field :ownership, "ownership", "KYBRegistryOwnership"
+      field :registry_tier, "registry_tier", :string
+    end
+
+    class KybListShareholdersResponseKybRegistryBeneficialOwners < Didit::Model
+      field :uuid, "uuid", :string
+      field :name, "name", :string
+      field :first_name, "first_name", :string
+      field :last_name, "last_name", :string
+      field :entity_type, "entity_type", :string
+      field :roles, "roles", [:array, :string]
+      field :ownership_min_shares, "ownership_min_shares", :string
+      field :ownership_max_shares, "ownership_max_shares", :string
+      field :is_active, "is_active", :boolean
+      field :kyc_status, "kyc_status", :string
+      field :kyc_session_url, "kyc_session_url", :string
+      field :effective_ownership_percent, "effective_ownership_percent", :float
+      field :company_name, "company_name", :string
+      field :registration_number, "registration_number", :string
+      field :country_of_birth, "country_of_birth", :string
+      field :email, "email", :string
+      field :nationality, "nationality", :string
+      field :designation, "designation", :string
+      field :voting_min_shares, "voting_min_shares", :string
+      field :voting_max_shares, "voting_max_shares", :string
+      field :date_of_birth, "date_of_birth", :date
+      field :appointment_date, "appointment_date", :date
+      field :shareholding, "shareholding", "KYBRegistryShareholding"
+    end
+
+    class KybListShareholdersResponseKybRegistryOfficers < Didit::Model
+      field :uuid, "uuid", :string
+      field :name, "name", :string
+      field :designation, "designation", :string
+      field :role, "role", :string
+      field :nationality, "nationality", :string
+      field :is_active, "is_active", :boolean
+      field :kyc_status, "kyc_status", :string
+      field :kyc_session_url, "kyc_session_url", :string
+      field :first_name, "first_name", :string
+      field :last_name, "last_name", :string
+      field :address, "address", :string
+      field :appointment_date, "appointment_date", :date
+      field :termination_date, "termination_date", :date
+      field :date_of_birth, "date_of_birth", :date
+      field :date_of_birth_year, "date_of_birth_year", :integer
+      field :date_of_birth_month, "date_of_birth_month", :integer
+    end
+
+    class KybListUbosResponse < Didit::Model
+      field :request_id, "request_id", :string
+      field :registry_tier_requested, "registry_tier_requested", :string
+      field :registry_tier_delivered, "registry_tier_delivered", :string
+      field :kyb_registry, "kyb_registry", "KybListUbosResponseKybRegistry"
+      field :vendor_data, "vendor_data", :string
+      field :metadata, "metadata", :any
+      field :created_at, "created_at", :datetime
+    end
+
+    class KybListUbosResponse202 < Didit::Model
+      field :request_id, "request_id", :string
+      field :registry_tier_requested, "registry_tier_requested", :string
+      field :registry_tier_delivered, "registry_tier_delivered", :string
+      field :kyb_registry, "kyb_registry", "KybListUbosResponse202KybRegistry"
+      field :vendor_data, "vendor_data", :string
+      field :metadata, "metadata", :any
+      field :created_at, "created_at", :datetime
+    end
+
+    # Full registry company profile.
+    class KybListUbosResponse202KybRegistry < Didit::Model
+      field :uuid, "uuid", :string
+      field :node_id, "node_id", :string
+      field :status, "status", :string
+      field :registry_status, "registry_status", :string
+      field :data_resolved, "data_resolved", :boolean
+      field :company_name, "company_name", :string
+      field :registration_number, "registration_number", :string
+      field :country_code, "country_code", :string
+      field :region, "region", :string
+      field :company_type, "company_type", :string
+      field :incorporation_date, "incorporation_date", :date
+      field :registered_address, "registered_address", :string
+      field :tax_number, "tax_number", :string
+      field :risk_level, "risk_level", :string
+      field :verification_status, "verification_status", :string
+      field :is_from_registry, "is_from_registry", :boolean
+      field :fetch_status, "fetch_status", :string
+      field :alternative_names, "alternative_names", :string
+      field :nature_of_business, "nature_of_business", :string
+      field :registered_capital, "registered_capital", :string
+      field :registered_capital_amount, "registered_capital_amount", :string
+      field :registered_capital_currency, "registered_capital_currency", :string
+      field :website, "website", :string
+      field :email, "email", :string
+      field :phone, "phone", :string
+      field :legal_entity_identifier, "legal_entity_identifier", :string
+      field :location_of_registration, "location_of_registration", :string
+      field :vat_number, "vat_number", :string
+      field :vat_validation_status, "vat_validation_status", :string
+      field :vat_validated_number, "vat_validated_number", :string
+      field :vat_validation_source, "vat_validation_source", :string
+      field :vat_validated_name, "vat_validated_name", :string
+      field :vat_validated_address, "vat_validated_address", :string
+      field :vat_checked_at, "vat_checked_at", :datetime
+      field :financial_summary, "financial_summary", :any
+      field :officers, "officers", [:array, "KybListUbosResponse202KybRegistryOfficers"]
+      field :beneficial_owners, "beneficial_owners", [:array, "KybListUbosResponse202KybRegistryBeneficialOwners"]
+      field :addresses, "addresses", [:array, "KYBRegistryAddress"]
+      field :industries, "industries", [:array, "KYBRegistryIndustry"]
+      field :accounts, "accounts", :any
+      field :registry_data, "registry_data", :any
+      field :user_provided_data, "user_provided_data", :any
+      field :confirmed_by_user_at, "confirmed_by_user_at", :datetime
+      field :last_console_edit_at, "last_console_edit_at", :datetime
+      field :is_editable, "is_editable", :boolean
+      field :registry_tier_delivered, "registry_tier_delivered", :string
+      field :registry_ownership_status, "registry_ownership_status", :string
+      field :ownership, "ownership", "KYBRegistryOwnership"
+      field :registry_tier, "registry_tier", :string
+    end
+
+    class KybListUbosResponse202KybRegistryBeneficialOwners < Didit::Model
+      field :uuid, "uuid", :string
+      field :name, "name", :string
+      field :first_name, "first_name", :string
+      field :last_name, "last_name", :string
+      field :entity_type, "entity_type", :string
+      field :roles, "roles", [:array, :string]
+      field :ownership_min_shares, "ownership_min_shares", :string
+      field :ownership_max_shares, "ownership_max_shares", :string
+      field :is_active, "is_active", :boolean
+      field :kyc_status, "kyc_status", :string
+      field :kyc_session_url, "kyc_session_url", :string
+      field :effective_ownership_percent, "effective_ownership_percent", :float
+      field :company_name, "company_name", :string
+      field :registration_number, "registration_number", :string
+      field :country_of_birth, "country_of_birth", :string
+      field :email, "email", :string
+      field :nationality, "nationality", :string
+      field :designation, "designation", :string
+      field :voting_min_shares, "voting_min_shares", :string
+      field :voting_max_shares, "voting_max_shares", :string
+      field :date_of_birth, "date_of_birth", :date
+      field :appointment_date, "appointment_date", :date
+      field :shareholding, "shareholding", "KYBRegistryShareholding"
+    end
+
+    class KybListUbosResponse202KybRegistryOfficers < Didit::Model
+      field :uuid, "uuid", :string
+      field :name, "name", :string
+      field :designation, "designation", :string
+      field :role, "role", :string
+      field :nationality, "nationality", :string
+      field :is_active, "is_active", :boolean
+      field :kyc_status, "kyc_status", :string
+      field :kyc_session_url, "kyc_session_url", :string
+      field :first_name, "first_name", :string
+      field :last_name, "last_name", :string
+      field :address, "address", :string
+      field :appointment_date, "appointment_date", :date
+      field :termination_date, "termination_date", :date
+      field :date_of_birth, "date_of_birth", :date
+      field :date_of_birth_year, "date_of_birth_year", :integer
+      field :date_of_birth_month, "date_of_birth_month", :integer
+    end
+
+    # Full registry company profile.
+    class KybListUbosResponseKybRegistry < Didit::Model
+      field :uuid, "uuid", :string
+      field :node_id, "node_id", :string
+      field :status, "status", :string
+      field :registry_status, "registry_status", :string
+      field :data_resolved, "data_resolved", :boolean
+      field :company_name, "company_name", :string
+      field :registration_number, "registration_number", :string
+      field :country_code, "country_code", :string
+      field :region, "region", :string
+      field :company_type, "company_type", :string
+      field :incorporation_date, "incorporation_date", :date
+      field :registered_address, "registered_address", :string
+      field :tax_number, "tax_number", :string
+      field :risk_level, "risk_level", :string
+      field :verification_status, "verification_status", :string
+      field :is_from_registry, "is_from_registry", :boolean
+      field :fetch_status, "fetch_status", :string
+      field :alternative_names, "alternative_names", :string
+      field :nature_of_business, "nature_of_business", :string
+      field :registered_capital, "registered_capital", :string
+      field :registered_capital_amount, "registered_capital_amount", :string
+      field :registered_capital_currency, "registered_capital_currency", :string
+      field :website, "website", :string
+      field :email, "email", :string
+      field :phone, "phone", :string
+      field :legal_entity_identifier, "legal_entity_identifier", :string
+      field :location_of_registration, "location_of_registration", :string
+      field :vat_number, "vat_number", :string
+      field :vat_validation_status, "vat_validation_status", :string
+      field :vat_validated_number, "vat_validated_number", :string
+      field :vat_validation_source, "vat_validation_source", :string
+      field :vat_validated_name, "vat_validated_name", :string
+      field :vat_validated_address, "vat_validated_address", :string
+      field :vat_checked_at, "vat_checked_at", :datetime
+      field :financial_summary, "financial_summary", :any
+      field :officers, "officers", [:array, "KybListUbosResponseKybRegistryOfficers"]
+      field :beneficial_owners, "beneficial_owners", [:array, "KybListUbosResponseKybRegistryBeneficialOwners"]
+      field :addresses, "addresses", [:array, "KYBRegistryAddress"]
+      field :industries, "industries", [:array, "KYBRegistryIndustry"]
+      field :accounts, "accounts", :any
+      field :registry_data, "registry_data", :any
+      field :user_provided_data, "user_provided_data", :any
+      field :confirmed_by_user_at, "confirmed_by_user_at", :datetime
+      field :last_console_edit_at, "last_console_edit_at", :datetime
+      field :is_editable, "is_editable", :boolean
+      field :registry_tier_delivered, "registry_tier_delivered", :string
+      field :registry_ownership_status, "registry_ownership_status", :string
+      field :ownership, "ownership", "KYBRegistryOwnership"
+      field :registry_tier, "registry_tier", :string
+    end
+
+    class KybListUbosResponseKybRegistryBeneficialOwners < Didit::Model
+      field :uuid, "uuid", :string
+      field :name, "name", :string
+      field :first_name, "first_name", :string
+      field :last_name, "last_name", :string
+      field :entity_type, "entity_type", :string
+      field :roles, "roles", [:array, :string]
+      field :ownership_min_shares, "ownership_min_shares", :string
+      field :ownership_max_shares, "ownership_max_shares", :string
+      field :is_active, "is_active", :boolean
+      field :kyc_status, "kyc_status", :string
+      field :kyc_session_url, "kyc_session_url", :string
+      field :effective_ownership_percent, "effective_ownership_percent", :float
+      field :company_name, "company_name", :string
+      field :registration_number, "registration_number", :string
+      field :country_of_birth, "country_of_birth", :string
+      field :email, "email", :string
+      field :nationality, "nationality", :string
+      field :designation, "designation", :string
+      field :voting_min_shares, "voting_min_shares", :string
+      field :voting_max_shares, "voting_max_shares", :string
+      field :date_of_birth, "date_of_birth", :date
+      field :appointment_date, "appointment_date", :date
+      field :shareholding, "shareholding", "KYBRegistryShareholding"
+    end
+
+    class KybListUbosResponseKybRegistryOfficers < Didit::Model
+      field :uuid, "uuid", :string
+      field :name, "name", :string
+      field :designation, "designation", :string
+      field :role, "role", :string
+      field :nationality, "nationality", :string
+      field :is_active, "is_active", :boolean
+      field :kyc_status, "kyc_status", :string
+      field :kyc_session_url, "kyc_session_url", :string
+      field :first_name, "first_name", :string
+      field :last_name, "last_name", :string
+      field :address, "address", :string
+      field :appointment_date, "appointment_date", :date
+      field :termination_date, "termination_date", :date
+      field :date_of_birth, "date_of_birth", :date
+      field :date_of_birth_year, "date_of_birth_year", :integer
+      field :date_of_birth_month, "date_of_birth_month", :integer
+    end
+
+    class KybSearchResponse < Didit::Model
+      field :request_id, "request_id", :string
+      field :kyb_registry, "kyb_registry", "KYBRegistrySearchResults"
+      field :vendor_data, "vendor_data", :string
+      field :metadata, "metadata", :any
+      field :created_at, "created_at", :datetime
+    end
+
+    class KybSelectResponse < Didit::Model
+      field :request_id, "request_id", :string
+      field :registry_tier_requested, "registry_tier_requested", :string
+      field :registry_tier_delivered, "registry_tier_delivered", :string
+      field :kyb_registry, "kyb_registry", "KybSelectResponseKybRegistry"
+      field :vendor_data, "vendor_data", :string
+      field :metadata, "metadata", :any
+      field :created_at, "created_at", :datetime
+    end
+
+    # Full registry company profile.
+    class KybSelectResponseKybRegistry < Didit::Model
+      field :uuid, "uuid", :string
+      field :node_id, "node_id", :string
+      field :status, "status", :string
+      field :registry_status, "registry_status", :string
+      field :data_resolved, "data_resolved", :boolean
+      field :company_name, "company_name", :string
+      field :registration_number, "registration_number", :string
+      field :country_code, "country_code", :string
+      field :region, "region", :string
+      field :company_type, "company_type", :string
+      field :incorporation_date, "incorporation_date", :date
+      field :registered_address, "registered_address", :string
+      field :tax_number, "tax_number", :string
+      field :risk_level, "risk_level", :string
+      field :verification_status, "verification_status", :string
+      field :is_from_registry, "is_from_registry", :boolean
+      field :fetch_status, "fetch_status", :string
+      field :alternative_names, "alternative_names", :string
+      field :nature_of_business, "nature_of_business", :string
+      field :registered_capital, "registered_capital", :string
+      field :registered_capital_amount, "registered_capital_amount", :string
+      field :registered_capital_currency, "registered_capital_currency", :string
+      field :website, "website", :string
+      field :email, "email", :string
+      field :phone, "phone", :string
+      field :legal_entity_identifier, "legal_entity_identifier", :string
+      field :location_of_registration, "location_of_registration", :string
+      field :vat_number, "vat_number", :string
+      field :vat_validation_status, "vat_validation_status", :string
+      field :vat_validated_number, "vat_validated_number", :string
+      field :vat_validation_source, "vat_validation_source", :string
+      field :vat_validated_name, "vat_validated_name", :string
+      field :vat_validated_address, "vat_validated_address", :string
+      field :vat_checked_at, "vat_checked_at", :datetime
+      field :financial_summary, "financial_summary", :any
+      field :officers, "officers", [:array, "KybSelectResponseKybRegistryOfficers"]
+      field :beneficial_owners, "beneficial_owners", [:array, "KybSelectResponseKybRegistryBeneficialOwners"]
+      field :addresses, "addresses", [:array, "KYBRegistryAddress"]
+      field :industries, "industries", [:array, "KYBRegistryIndustry"]
+      field :accounts, "accounts", :any
+      field :registry_data, "registry_data", :any
+      field :user_provided_data, "user_provided_data", :any
+      field :confirmed_by_user_at, "confirmed_by_user_at", :datetime
+      field :last_console_edit_at, "last_console_edit_at", :datetime
+      field :is_editable, "is_editable", :boolean
+      field :registry_tier_delivered, "registry_tier_delivered", :string
+      field :registry_ownership_status, "registry_ownership_status", :string
+      field :ownership, "ownership", "KYBRegistryOwnership"
+      field :registry_tier, "registry_tier", :string
+    end
+
+    class KybSelectResponseKybRegistryBeneficialOwners < Didit::Model
+      field :uuid, "uuid", :string
+      field :name, "name", :string
+      field :first_name, "first_name", :string
+      field :last_name, "last_name", :string
+      field :entity_type, "entity_type", :string
+      field :roles, "roles", [:array, :string]
+      field :ownership_min_shares, "ownership_min_shares", :string
+      field :ownership_max_shares, "ownership_max_shares", :string
+      field :is_active, "is_active", :boolean
+      field :kyc_status, "kyc_status", :string
+      field :kyc_session_url, "kyc_session_url", :string
+      field :effective_ownership_percent, "effective_ownership_percent", :float
+      field :company_name, "company_name", :string
+      field :registration_number, "registration_number", :string
+      field :country_of_birth, "country_of_birth", :string
+      field :email, "email", :string
+      field :nationality, "nationality", :string
+      field :designation, "designation", :string
+      field :voting_min_shares, "voting_min_shares", :string
+      field :voting_max_shares, "voting_max_shares", :string
+      field :date_of_birth, "date_of_birth", :date
+      field :appointment_date, "appointment_date", :date
+      field :shareholding, "shareholding", "KYBRegistryShareholding"
+    end
+
+    class KybSelectResponseKybRegistryOfficers < Didit::Model
+      field :uuid, "uuid", :string
+      field :name, "name", :string
+      field :designation, "designation", :string
+      field :role, "role", :string
+      field :nationality, "nationality", :string
+      field :is_active, "is_active", :boolean
+      field :kyc_status, "kyc_status", :string
+      field :kyc_session_url, "kyc_session_url", :string
+      field :first_name, "first_name", :string
+      field :last_name, "last_name", :string
+      field :address, "address", :string
+      field :appointment_date, "appointment_date", :date
+      field :termination_date, "termination_date", :date
+      field :date_of_birth, "date_of_birth", :date
+      field :date_of_birth_year, "date_of_birth_year", :integer
+      field :date_of_birth_month, "date_of_birth_month", :integer
+    end
+  end
+end