CorporateForm

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://raw.githubusercontent.com/api-evangelist/monerium/main/json-schema/monerium-corporate-form-schema.json",
  "title": "CorporateForm",
  "description": "Corporate form capturing service description, legal form, purpose, activity, fund origins, and financial information for risk assessment.",
  "x-generated": "2026-10-27",
  "x-method": "derived",
  "x-generator": "derive-json-schema.py",
  "x-source": "openapi/monerium-openapi.yml#/components/schemas/CorporateForm",
  "type": "object",
  "properties": {
    "service": {
      "description": "A brief description of the company's services.",
      "type": "string"
    },
    "legalForm": {
      "description": "The legal form of the company.",
      "type": "string",
      "enum": [
        "LEGAL_FORM_PUBLIC_LIMITED",
        "LEGAL_FORM_PRIVATE_LIMITED",
        "LEGAL_FORM_PARTNERSHIPS",
        "LEGAL_FORM_SOLE_TRADERS_PROPRIETORSHIPS",
        "LEGAL_FORM_PUBLIC_AUTHORITIES",
        "LEGAL_FORM_NON_PROFIT",
        "LEGAL_FORM_BRANCHES",
        "LEGAL_FORM_OTHER"
      ]
    },
    "purpose": {
      "description": "The code representing the primary purpose of the company.",
      "type": "string",
      "enum": [
        "PURPOSE_COLLECTING_PAYMENTS",
        "PURPOSE_PAYING_FOR_GOODS",
        "PURPOSE_BUY_SELL_CRYPTO_CURRENCIES",
        "PURPOSE_ENGAGE_IN_DEFI",
        "PURPOSE_OTHER"
      ]
    },
    "activity": {
      "description": "The code representing the company's main activity.",
      "type": "string",
      "enum": [
        "ACTIVITY_ACCOMMODATION_FOOD_TRAVEL",
        "ACTIVITY_ACCOUNTING_LEGAL_CONSULTANCY",
        "ACTIVITY_ADULT_ENTERTAINMENT",
        "ACTIVITY_ADVERTISING",
        "ACTIVITY_AGRICULTURE",
        "ACTIVITY_ARTS_ENTERTAINMENT",
        "ACTIVITY_CHARITY",
        "ACTIVITY_CONSTRUCTION",
        "ACTIVITY_DEALER_HIGH_VALUE_GOODS",
        "ACTIVITY_ECOMMERCE",
        "ACTIVITY_EDUCATION",
        "ACTIVITY_EXTRACTIVE_INDUSTRY",
        "ACTIVITY_GAMBLING",
        "ACTIVITY_HEALTH_SERVICES",
        "ACTIVITY_MANUFACTURING",
        "ACTIVITY_MARKETPLACE",
        "ACTIVITY_MEDIA",
        "ACTIVITY_MULTI_LEVEL_MARKETING",
        "ACTIVITY_PERSONAL_INVESTMENT",
        "ACTIVITY_PUBLIC_SECTOR",
        "ACTIVITY_REAL_ESTATE",
        "ACTIVITY_RETAIL",
        "ACTIVITY_SOCIAL_WORK",
        "ACTIVITY_SOFTWARE_TECHNOLOGY",
        "ACTIVITY_TELECOM",
        "ACTIVITY_TRANSPORTATION",
        "ACTIVITY_UTILITIES",
        "ACTIVITY_CRYPTO_SERVICES",
        "ACTIVITY_FINANCIAL_INSTITUTION",
        "ACTIVITY_OTHER"
      ]
    },
    "fundOrigin": {
      "description": "The code representing the origins of the company's funds.",
      "type": "string",
      "enum": [
        "FUND_ORIGIN_REVENUE",
        "FUND_ORIGIN_PROFIT_DIVIDENDS",
        "FUND_ORIGIN_LOAN",
        "FUND_ORIGIN_INVESTMENTS",
        "FUND_ORIGIN_CUSTOMER_FUNDS",
        "FUND_ORIGIN_THIRD_PARTIES_FUNDS"
      ]
    },
    "monthlyTurnover": {
      "description": "The code representing the company's monthly turnover range.",
      "type": "string",
      "enum": [
        "TURNOVER_UNDER_100K",
        "TURNOVER_100K_TO_250K",
        "TURNOVER_MORE_THAN_250K"
      ]
    },
    "monthlyTransactionCount": {
      "description": "The code representing the number of transactions the company typically makes each month.",
      "type": "string",
      "enum": [
        "TRANSACTION_COUNT_UNDER_100",
        "TRANSACTION_COUNT_100_TO_250",
        "TRANSACTION_COUNT_MORE_THAN_250"
      ]
    }
  },
  "required": [
    "service",
    "purpose",
    "activity",
    "fundOrigin",
    "monthlyTurnover",
    "monthlyTransactionCount"
  ]
}