Changelog

​

Schema Example Improvements

• Updated examples to use valid enum values instead of invalid string literals
• Corrected date formats to match schema requirements (YYYY-MM-DD)
• Added missing conditional fields required by validation rules to OpenAPI documentation examples

​

Documentation Accuracy Improvements

• Fixed expectedAverageDailyBalance field documentation: Changed from Optional to Required
• Fixed cashOnHandUsd field documentation: Changed from Optional to Required
• Updated hasUsBankAccount field documentation: Clarified that it’s required for non-US businesses and optional for US businesses

​

Documentation Enhancements

• Business Classification codes
• Industry types
• Stock Exchange lists
• Regulatory bodies
• Control Person roles and document types

• Streamlined Layout: Combined “API Field” and “Condition” columns for better readability.
• Direct Links: Enum fields now link directly to their specific allowed values in the new Customer Enums reference.
• Unified Formats: Standardized table structures across all sections (KYB Documents, Business Form, etc.).

​

Date Validation Enhancements

​

Terms of Service Acceptance

• termsOfServiceAcceptance.date (string): Now validates that the acceptance date cannot be in the future. Must be in YYYY-MM-DD format.
• termsOfServiceAcceptance.isAuthenticated (boolean): Now required to be true. Users must be authenticated when accepting terms of service.

​

Business Information

• businessInformation.registeredDate (string): Now validates that the registration date cannot be in the future. Must be in YYYY-MM-DD format.

​

Control Person Information

• controlPersons[].birthDate (string): Now validates that the birth date cannot be in the future.
• controlPersons[].identityInfo.documentIssueDate (string): Now validates that the document issue date cannot be in the future.
• controlPersons[].identityInfo.documentExpiryDate (string, optional): Now validates that the document expiry date must be today or in the future (cannot be in the past).

• Terms of service acceptance dates reflect actual acceptance times
• Business registration dates are historically accurate
• Control person birth dates are valid
• Identity document dates are logically consistent (issue date ≤ today ≤ expiry date)

​

⚠️ Breaking Change

​

New Business Information Fields

​

Business Classification

• hasDBA (boolean): Indicates if the business operates under a DBA name
• businessTradeName (string, optional): The registered DBA name (required when hasDBA is true)
• isStockExchangeListed (boolean): Whether the company is publicly listed
• stockExchange (enum, optional): Stock exchange name (required when isStockExchangeListed is true)
• stockExchangeOther (string, optional): Custom stock exchange name (required when stockExchange is Other)
• tickerSymbol (string, optional): Company ticker symbol (required when isStockExchangeListed is true)
• entityTaxedAs (enum, optional): Tax classification (S-Corporation, C-Corporation, Partnership)
• taxClassification (string, optional): Additional tax classification information
• describeIndustry (string, optional): Industry description (required when industry is Other)

​

Business Activity & Risk Profile

• entityType (enum, optional): Type of financial entity (Bank, Insurance Company, Securities Broker, etc.)
• accountPurpose (enum): Purpose of the account with Conduit
• accountPurposeDescription (string, optional): Description of goods/services (required when accountPurpose is Payments for Goods or Services)
• productsOrServices (array): List of products or services the company offers
• highRiskIndustry (enum): High-risk industry exposure
• highRiskIndustryDetails (string, optional): Details about high-risk industry activities (required when highRiskIndustry is not None)
• hasNestedFlows (boolean): Whether the company operates on behalf of third parties
• nestedFlowDescription (string, optional): Description of third-party flows (required when hasNestedFlows is true)
• certifiesOwnTreasuryUse (boolean): Certification that accounts will only be used for own treasury management
• keyGeographicBusinessCountries (array): ISO 3166-1 alpha-3 country codes where 20%+ of business is conducted
• hasAdvisor (boolean, optional): Whether the company has a financial or business advisor
• regulatorName (enum, optional): Regulatory authority name (required when isFinancialInstitution is true)
• regulatoryAuthorityOther (string, optional): Custom regulatory authority (required when regulatorName is Other)
• regulatoryLicenseNumber (string, optional): License number or registration ID (required when isFinancialInstitution is true)
• hasIndependentAmlAuditReport (object, optional): Independent AML audit report information
  • answer (boolean): Whether company has an independent AML audit report
  • explanation (string, optional): Explanation if no audit report (required when answer is false and isFinancialInstitution is true)
  • timeline (string, optional): Timeline for obtaining audit report (required when answer is false and isFinancialInstitution is true)
• flowOfFundsDescription (string, optional): Description of fund flow (required when isFinancialInstitution is false). Note: Financial institutions must upload a Flow of Funds document instead (see Compliance Requirements guide).

​

Transaction Volume, Financials & Operations

• anticipatedMonthlyVolume (number): Anticipated average monthly transaction volume in USD
• expectedAverageDailyBalance (number, optional): Expected average daily balance in USD
• anticipatedTransactionsVolume (number): Estimated number of transactions per month
• usesBlockChainWallets (boolean): Whether the company will use blockchain wallet addresses
• blockchainWallets (array, optional): List of blockchain wallet addresses (required when usesBlockChainWallets is true)
  • walletAddress (string): Blockchain wallet address
  • associatedPlatformType (enum): Platform type (exchange, custodian, platform, self_custodied)
  • associatedPlatformName (string): Name of the exchange, custodian, or platform
• sourceOfFunds (string): Primary source of funds
• isGeneratingRevenues (boolean): Whether the company is currently generating revenue
• revenueCoverage (enum, optional): Revenue coverage percentage (required when isGeneratingRevenues is true)
• revenueCoverageExplanation (string, optional): Explanation for low revenue coverage (required when revenueCoverage is Less than 25% of expenses)
• hasInstitutionalInvestors (boolean): Whether the company has institutional investors (VC or PE)
• runwayDurationMonths (number): Financial runway duration in months
• runwayDurationExplanation (string, optional): Explanation for financial runway (required when runwayDurationMonths is less than 12)
• cashOnHandUsd (number, optional): Current cash on hand in USD

​

Non-US Onboarding Requirements

• hasUsBankAccount (boolean, optional): Whether business has an existing US bank account (required for non-US businesses)
• deniedUsBankAccount (object, optional): Information about denied US bank account (required for non-US businesses)
  • answer (boolean): Whether business has been denied a US bank account
  • explanation (string, optional): Explanation if denied (required when answer is true)
• businessAuditHistory (object, optional): Business audit history information (required for non-US businesses)
  • answer (boolean): Whether business has audit history
  • explanation (string, optional): Details if yes (required when answer is true)
• ownersAuditHistory (object, optional): Owners audit history information (required for non-US businesses)
  • answer (boolean): Whether owners have audit history
  • explanation (string, optional): Details if yes (required when answer is true)
• pepInvolved (object, optional): PEP involvement information (required for non-US businesses)
  • answer (boolean): Whether any owner/director/officer is a PEP
  • explanation (string, optional): Details if yes (required when answer is true)

​

Terms of Service Acceptance

• termsOfServiceAcceptance (object): Terms of service acceptance information
  • date (string): Date of acceptance in YYYY-MM-DD format. Cannot be in the future.
  • ipAddress (string): IP address of the user accepting terms
  • isAuthenticated (boolean): Whether the user was authenticated when accepting. Must be true.

​

API Improvements

• Type Safety: Fixed type compatibility issues where undefined values are now properly normalized to null for explanation fields in nested objects (deniedUsBankAccount, businessAuditHistory, ownersAuditHistory, pepInvolved, hasIndependentAmlAuditReport)
• Conditional Validation: Enhanced validation rules to enforce field requirements based on conditional logic (e.g., regulatorName required when isFinancialInstitution is true)
• ISO3 Country Codes: All country-related fields now strictly validate ISO 3166-1 alpha-3 format (e.g., USA, GBR, FRA)

​

Documentation Updates

• Compliance Requirements Guide: Renamed and expanded the Compliance Requirements guide.
  • Added mandatory KYB documents (SHAREHOLDER_REGISTRY, TERMS_OF_SERVICE).
  • Detailed specific requirements for Non-US Onboarding.
  • Explicitly listed PROOF_OF_ADDRESS and Liveness Check requirements for AUTHORIZED_REPRESENTATIVE roles.
• Webhooks Reference: Overhauled the Webhooks section.
  • Added comprehensive payload examples for all transaction types (Offramp, Onramp, Deposit, Withdrawal, Conversion).
  • Audited and documented all possible status values for Transactions and Counterparties.
  • Centralized webhook examples to the developer section for better maintainability.

​

API Schema Improvements

• Conditional Validation: Updated BusinessInformationSchema to make regulatorName required only when isFinancialInstitution is true.
• ISO3 Country Validation: Enhanced validation for nationality and country fields to strictly enforce ISO 3166-1 alpha-3 codes.
• Schema Refactoring: Improved internal schema definitions to fix issues with partial updates on refined schemas.
• Sandbox API Visibility: Exposed simulation endpoints (Deposit, Compliance, KYB) in the main API reference for easier integration testing.

​

Customer API documentation updates

​

Liveness Check links only returned for authorized representative role

​

Sandbox URL update

​

Customer create field name fix