{ "$schema": "https://json-schema.org/draft/2020-12/schema", "$id": "https://raw.githubusercontent.com/api-evangelist/unstoppable-finance/main/json-schema/unstoppable-finance-identification-create-params-v2-schema.json", "title": "IdentificationCreateParamsV2", "description": "Identification Create Params V2\n\nThe params required to create an identification v2, we support three types of identification:\n- Link: where a link is provided to the customer for access to the identification process.\n- Token: where a token is provided in the request from which verification data can be extracted and where the token is generated by the third party provider\n- Person: where the identification details of the person for which the identification process is being created are provided in the request\n", "x-generated": "2026-10-12", "x-method": "derived", "x-generator": "derive-json-schema.py", "x-source": "openapi/unstoppable-finance-customer-api-openapi.yml#/components/schemas/IdentificationCreateParamsV2", "anyOf": [ { "$ref": "#/$defs/IdentificationCreateParamsV2_IdentificationLinkparams" }, { "$ref": "#/$defs/IdentificationCreateParamsV2_IdentificationTokenParams" }, { "$ref": "#/$defs/IdentificationCreateParamsV2_IdentificationPersonParams" }, { "$ref": "#/$defs/IdentificationCreateParamsV2_IdentificationBusinessParams" } ], "type": "object", "$defs": { "Address": { "description": "Address", "properties": { "city": { "description": "city", "type": "string" }, "country": { "description": "country (2-character ISO 3166)", "type": "string" }, "state": { "description": "state/province/region", "type": "string" }, "street_1": { "description": "street address", "type": "string" }, "street_2": { "description": "street address (additional)", "type": "string" }, "zip_code": { "description": "zip code", "type": "string" } }, "required": [ "street_1", "city", "zip_code", "country" ], "title": "Address", "type": "object" }, "ApproximateNetWorth": { "description": "Approximate Net Worth\n\nThe approximate net worth of the person\n", "enum": [ "UpTo25000", "Between25001And50000", "Between50001And100000", "Between100001And300000", "Between300001And500000", "Between500001And1000000", "Over1000001" ], "type": "string" }, "BeneficiaryIdentity": { "description": "Beneficiary Identity Document\n\nIdentity document and biometric information for a person beneficiary.\nMirrors ApiPersonIdentity but excludes ip_address (collected at the business level).\n", "properties": { "identity_country_code": { "description": "ISO 3166-1 alpha-2 country code of the person's identity document", "type": "string" }, "identity_document_back": { "description": "Base64 encoded image of identity document back (10MB max)", "type": "string" }, "identity_document_front": { "description": "Base64 encoded image of identity document front (10MB max)", "type": "string" }, "identity_document_type": { "$ref": "#/$defs/IdentityDocumentType" }, "identity_number": { "description": "The identity number of the document being submitted", "type": "string" }, "nationality": { "description": "ISO 3166-1 alpha-2 nationality country code", "type": "string" }, "selfie": { "description": "Base64 encoded selfie image (10MB max).\nRequired for beneficiaries with Director or Representative roles; omit for UBO-only.", "type": "string" }, "selfie_collected_at": { "description": "timestamp in ISO 8601 format when the selfie was captured.\nRequired when selfie is provided.", "type": "string" } }, "required": [ "identity_country_code", "identity_document_type", "identity_document_front", "nationality" ], "title": "BeneficiaryIdentity", "type": "object" }, "BirthPlace": { "description": "Birth place\n\nThe place of birth of the person\n", "properties": { "country": { "description": "ISO 3166-1 alpha-2 (2 letter) country code of the place of birth", "type": "string" }, "place": { "description": "place of birth", "type": "string" }, "state": { "description": "state of birth", "type": "string" } }, "required": [ "place", "state", "country" ], "title": "BirthPlace", "type": "object" }, "BusinessBeneficiaryInfo": { "description": "Business Beneficiary Info\n\nA company that itself owns or controls the parent business. Carries the\nsame `ApiCompanyData` as the root identification: company info, its own\nbeneficiaries (which may include further nested businesses up to the\nconfigured depth limit), and supporting documents.\n", "properties": { "company_data": { "$ref": "#/$defs/CompanyData" } }, "required": [ "company_data" ], "title": "BusinessBeneficiaryInfo", "type": "object" }, "BusinessEstimatedAnnualRevenue": { "description": "Estimated Annual Revenue\n\nCompany's estimated annual revenue in EUR\n", "enum": [ "Under100K", "From100KTo1M", "From1MTo10M", "From10MTo50M", "From50MTo250M", "Over250M" ], "type": "string" }, "BusinessEstimatedMonthlyTransactions": { "description": "Estimated Monthly Transaction Count\n\nExpected number of transactions per month\n", "enum": [ "LessThanTen", "TenToTwentyFive", "TwentyFiveToFifty", "FiftyToOneHundred", "MoreThanOneHundred" ], "type": "string" }, "BusinessEstimatedMonthlyVolume": { "description": "Estimated Monthly Transaction Volume\n\nExpected monthly transaction volume in EUR\n", "enum": [ "TenToTwentyFiveThousand", "TwentyFiveToFiftyThousand", "FiftyToOneHundredThousand", "OneHundredToTwoHundredFiftyThousand", "TwoHundredFiftyToFiveHundredThousand", "MoreThanFiveHundredThousand" ], "type": "string" }, "BusinessIndustryType": { "description": "Industry Type\n\nBusiness industry/sector classification\n", "enum": [ "Agriculture", "Automotive", "BankingAndFinancialServices", "ConstructionAndRealEstate", "CryptocurrencyAndBlockchain", "CryptocurrencyMining", "DecentralisedFinance", "NftPlatforms", "CryptoPaymentProcessors", "CryptoWalletProviders", "CryptoExchanges", "CryptoCustodyServices", "EcommerceAndOnlineMarketplaces", "EducationAndTraining", "EnergyAndUtilities", "EntertainmentAndMedia", "GamingAndEsports", "HealthcareAndPharmaceuticals", "HospitalityAndTourism", "InformationTechnologyAndSoftware", "Insurance", "LegalAndProfessionalServices", "LogisticsAndTransportation", "ManufacturingAndIndustrial", "MetaversePlatforms", "MiningAndNaturalResources", "NonProfitAndCharitable", "RetailAndWholesaleTrade", "Telecommunications", "VentureCapitalAndPrivateEquity", "CasinosAndGambling", "MoneyServiceBusinesses", "SocialMediaAndNetworking", "CrowdfundingPlatforms", "RegTech", "Other" ], "type": "string" }, "BusinessPurposeAndIntendedUse": { "description": "Purpose and Intended Use\n\nThe intended purpose of the business account\n", "enum": [ "ReceivingBusinessIncome", "BusinessPurchasesAndExpenses", "EmployeeAndContractorPayouts", "EcommerceSales", "TreasuryManagement", "PaymentIntermediary", "Investments", "TaxPlanning", "AssetProtection", "Other" ], "type": "string" }, "BusinessQuestionnaire": { "anyOf": [ { "$ref": "#/$defs/BusinessQuestionnaire_GenericBusinessQuestionnaire" }, { "$ref": "#/$defs/BusinessQuestionnaire_SolePropBusinessQuestionnaire" } ], "description": "KYB compliance questionnaire\n\nUse `GenericBusinessQuestionnaire` for all company types except sole proprietorships.\nUse `SolePropBusinessQuestionnaire` for sole proprietorships.\n", "type": "object" }, "BusinessQuestionnaireBusinessDetails": { "description": "Business Details Section\n\nIndustry classification and operational information about the company\n", "properties": { "business_model_description": { "description": "Description of business model and target clients", "type": "string" }, "estimated_annual_revenue": { "$ref": "#/$defs/BusinessEstimatedAnnualRevenue" }, "has_licenses_or_registrations": { "description": "Does the company maintain any licenses or registrations", "type": "boolean" }, "industry_type": { "$ref": "#/$defs/BusinessIndustryType" }, "main_business_countries": { "description": "Main countries of business operation (ISO 3166-1 alpha-2 codes)", "items": { "type": "string" }, "type": "array" }, "requires_aml_program": { "description": "Is the company required to have an AML/CFT compliance program", "type": "boolean" } }, "required": [ "industry_type", "business_model_description", "main_business_countries", "has_licenses_or_registrations", "requires_aml_program", "estimated_annual_revenue" ], "title": "BusinessQuestionnaireBusinessDetails", "type": "object" }, "BusinessQuestionnairePlannedActivities": { "description": "Planned Activities Section\n\nInformation about the company's intended account use and transaction patterns\n", "properties": { "estimated_monthly_transactions": { "$ref": "#/$defs/BusinessEstimatedMonthlyTransactions" }, "estimated_monthly_volume": { "$ref": "#/$defs/BusinessEstimatedMonthlyVolume" }, "flow_of_funds_diagram": { "description": "Base64 encoded flow of funds diagram (required when sends_funds_on_customer_behalf is true)", "type": "string" }, "purpose_and_intended_use": { "$ref": "#/$defs/BusinessPurposeAndIntendedUse" }, "sends_funds_on_customer_behalf": { "description": "Does the company send funds on behalf of customers/third parties", "type": "boolean" }, "sends_funds_on_customer_behalf_description": { "description": "Description of how funds are sent on customer behalf (required if sends_funds_on_customer_behalf is true)", "type": "string" }, "source_of_funds_document": { "description": "Base64 encoded source of funds supporting document (required when sends_funds_on_customer_behalf is true)", "type": "string" } }, "required": [ "purpose_and_intended_use", "estimated_monthly_volume", "estimated_monthly_transactions", "sends_funds_on_customer_behalf" ], "title": "BusinessQuestionnairePlannedActivities", "type": "object" }, "BusinessQuestionnaireSourceOfFunds": { "description": "Source of Funds Section\n\nInformation about where the company's funds originate\n", "properties": { "customer_funds_handling_details": { "description": "Details on how customer funds are handled, including business model and transaction flow (required)", "type": "string" }, "source_of_funds": { "$ref": "#/$defs/RevenueSource" }, "source_of_funds_description": { "description": "Detailed description of source of funds (required)", "type": "string" } }, "required": [ "source_of_funds", "source_of_funds_description", "customer_funds_handling_details" ], "title": "BusinessQuestionnaireSourceOfFunds", "type": "object" }, "BusinessQuestionnaire_GenericBusinessQuestionnaire": { "allOf": [ { "properties": { "type": { "enum": [ "Generic" ], "type": "string" } }, "required": [ "type" ], "type": "object" }, { "$ref": "#/$defs/GenericBusinessQuestionnaire" } ], "description": "KYB compliance questionnaire\n\nUse `GenericBusinessQuestionnaire` for all company types except sole proprietorships.\nUse `SolePropBusinessQuestionnaire` for sole proprietorships.\n" }, "BusinessQuestionnaire_SolePropBusinessQuestionnaire": { "allOf": [ { "properties": { "type": { "enum": [ "SoleProp" ], "type": "string" } }, "required": [ "type" ], "type": "object" }, { "$ref": "#/$defs/SolePropBusinessQuestionnaire" } ], "description": "KYB compliance questionnaire\n\nUse `GenericBusinessQuestionnaire` for all company types except sole proprietorships.\nUse `SolePropBusinessQuestionnaire` for sole proprietorships.\n" }, "CompanyBeneficiary": { "description": "Company Beneficial Owner\n\nThe beneficial owner of the company\n", "properties": { "attested_at": { "description": "When the beneficiary certified the information (RFC 3339, in the past).\nRequired when attesting_party is true.", "type": "string" }, "attesting_party": { "description": "Marks this beneficiary as certifying the beneficial-ownership information\n(31 CFR 1010.230). Root-level person holding a Director role only.\nBefore setting this flag, present the collected beneficial-ownership\ninformation to this beneficiary and obtain their confirmation that it is\ncomplete and correct — Iron renders a certification naming them from the\nsubmitted data. For US non-sole-props the generated form is always\nsubmitted to the provider; when no IncorporationArticles document is\nsupplied it also satisfies the legal-presence document requirement.\nLimited to simple ownership structures (at most two levels of\nbeneficiaries); deeper structures cannot self-attest and must attach\nthe legal presence document instead.", "type": "boolean" }, "beneficiary_info": { "$ref": "#/$defs/CompanyBeneficiaryInfo" }, "roles": { "description": "The primary role of the beneficial owner", "items": { "$ref": "#/$defs/CompanyPrimaryBeneficiaryRole" }, "type": "array" }, "share_percentage": { "description": "Share percentage of the beneficial owner (0-100). The combined shares of\nUltimateBeneficialOwner beneficiaries must not exceed 100 per company.", "format": "decimal", "type": "string" } }, "required": [ "roles", "beneficiary_info" ], "title": "CompanyBeneficiary", "type": "object" }, "CompanyBeneficiaryInfo": { "anyOf": [ { "$ref": "#/$defs/PersonBeneficiaryInfo" }, { "$ref": "#/$defs/BusinessBeneficiaryInfo" } ], "description": "Company Beneficiary Info\n\nThe beneficiary info of the company\n", "type": "object" }, "CompanyData": { "description": "Company Data\n\nFull company submission: identifying info, beneficiaries, and supporting\ndocuments. Reused by the root identification request and by each nested\nbusiness beneficiary.\n", "properties": { "beneficiaries": { "description": "The beneficiaries of the company. Each level (root or nested business)\nrequires at least one Director; UBOs and Representatives are also\npermitted at every level.", "items": { "$ref": "#/$defs/CompanyBeneficiary" }, "type": "array" }, "company_info": { "$ref": "#/$defs/CompanyInfo" }, "documents": { "description": "The company documents (max 4). Optional at submission: when the set is\nincomplete for the company's region, the identification is returned as\nPending with a resume URL to collect the missing documents.", "items": { "$ref": "#/$defs/CompanyDocParams" }, "type": "array" } }, "required": [ "company_info", "beneficiaries", "documents" ], "title": "CompanyData", "type": "object" }, "CompanyDocParams": { "description": "Company document params\n\nThe params required to create a company document\n", "properties": { "country": { "description": "ISO 3166-1 alpha-2 (2 letter) country code of the country that issued the document", "type": "string" }, "file": { "description": "Base64 encoded document without prefix (10MB max)", "type": "string" }, "type": { "$ref": "#/$defs/CompanyDocType" } }, "required": [ "type", "country", "file" ], "title": "CompanyDocParams", "type": "object" }, "CompanyDocType": { "description": "Company document type\n\nThe type of company document\n", "enum": [ "PowerOfAttorney", "TransparencyRegistryExtract", "DirectorsRegistry", "GoodStandingCert", "IncorporationArticles", "IncorporationCert", "IncumbencyCert", "InformationStatement", "PartnershipAgreement", "ProofOfAddress", "ProofOfNatureOfBusiness", "RegulatoryLicense", "SelfDeclarationForm", "ShareholderRegistry", "StateRegistry", "TradeLicense", "TrustAgreement", "Other" ], "type": "string" }, "CompanyInfo": { "description": "Company Info\n\nIdentifying details about a company. Shared between the root identification\nrequest and any nested business beneficiaries so the same fields are\ncollected at every level of the corporate structure.\n", "properties": { "address": { "$ref": "#/$defs/Address" }, "alternative_names": { "description": "The list of alternative names for the company", "items": { "type": "string" }, "type": "array" }, "company_name": { "description": "The legal name of the company", "type": "string" }, "company_type": { "$ref": "#/$defs/CompanyType" }, "country": { "description": "The ISO 3166-1 alpha-2 (2 letter) country code where the company is legally registered", "type": "string" }, "email": { "description": "The email address of the company", "type": "string" }, "incorporation_date": { "description": "The date of legal incorporation in YYYY-MM-DD format", "type": "string" }, "legal_address": { "description": "The address used during legal registration", "type": "string" }, "postal_address": { "description": "The postal address of the company", "type": "string" }, "registration_number": { "description": "The unique number assigned to the company when legally registered", "type": "string" }, "tax_identification_number": { "description": "The tax identification number of the company", "type": "string" }, "website": { "description": "The website of the company", "type": "string" } }, "required": [ "company_name", "registration_number", "country", "incorporation_date", "legal_address", "postal_address", "address", "email", "tax_identification_number", "website", "company_type" ], "title": "CompanyInfo", "type": "object" }, "CompanyPrimaryBeneficiaryRole": { "description": "Beneficial Owner Role\n\nThe role of the beneficial owner in the company\n", "enum": [ "UltimateBeneficialOwner", "Representative", "Director", "Shareholder" ], "type": "string" }, "CompanyType": { "description": "Company Type\n\nThe type of company\n", "enum": [ "LimitedLiabilityCompany", "PubliclyListedCompany", "SoleProprietorship", "Partnership", "Corporation", "Trust", "PrivateFoundation", "Charity", "NonprofitCorporation", "NonprofitOrganization", "PublicAgenciesOrAuthorities", "StockCorporationOutOfStock", "GeneralCorporation" ], "type": "string" }, "DocumentType": { "description": "Document Type\n\nThe type of document used in the KYB process\n", "enum": [ "BusinessRegistrationDocument", "MemorandumOfAssociation", "ShareholdersRegistry", "Other", "ProofOfAddress" ], "type": "string" }, "EddQuestionnaire": { "description": "EDD Questionnaire\n\nThe questionnaire for a reliance person residing in a country considered high risk\n", "properties": { "approximate_net_worth": { "$ref": "#/$defs/ApproximateNetWorth" }, "occupation": { "$ref": "#/$defs/Occupation" }, "source_of_funds_proof": { "description": "Source of funds proof document, provided as a base64-encoded string.\nSupported formats: jpg, png, pdf, doc, docx, xls, xlsx, odt, ods, txt.\nMaximum size: 10MB", "type": "string" } }, "required": [ "occupation", "approximate_net_worth", "source_of_funds_proof" ], "title": "EddQuestionnaire", "type": "object" }, "EmploymentStatus": { "description": "Employment Status\n\nThe employment status of the person\n", "enum": [ "Employed", "SelfEmployed", "Unemployed", "Retired", "Student" ], "type": "string" }, "GenericBusinessQuestionnaire": { "description": "KYB compliance questionnaire for standard company types\n", "properties": { "business_details": { "$ref": "#/$defs/BusinessQuestionnaireBusinessDetails" }, "planned_activities": { "$ref": "#/$defs/BusinessQuestionnairePlannedActivities" }, "source_of_funds": { "$ref": "#/$defs/BusinessQuestionnaireSourceOfFunds" } }, "required": [ "planned_activities", "source_of_funds", "business_details" ], "title": "GenericBusinessQuestionnaire", "type": "object" }, "IdentificationBusinessParams": { "description": "Business Identification Params\n\nThe params required to create an identification\n", "properties": { "company_data": { "$ref": "#/$defs/CompanyData" }, "ip_address": { "description": "The IP address of the device used to submit the identification", "type": "string" }, "phone": { "description": "The phone number of the company", "type": "string" }, "questionnaire": { "$ref": "#/$defs/BusinessQuestionnaire" } }, "required": [ "company_data", "phone", "ip_address", "questionnaire" ], "title": "IdentificationBusinessParams", "type": "object" }, "IdentificationCreateParamsV2_IdentificationBusinessParams": { "allOf": [ { "properties": { "type": { "enum": [ "Business" ], "type": "string" } }, "required": [ "type" ], "type": "object" }, { "$ref": "#/$defs/IdentificationBusinessParams" } ], "description": "Identification Create Params V2\n\nThe params required to create an identification v2, we support three types of identification:\n- Link: where a link is provided to the customer for access to the identification process.\n- Token: where a token is provided in the request from which verification data can be extracted and where the token is generated by the third party provider\n- Person: where the identification details of the person for which the identification process is being created are provided in the request\n" }, "IdentificationCreateParamsV2_IdentificationLinkparams": { "allOf": [ { "properties": { "type": { "enum": [ "Link" ], "type": "string" } }, "required": [ "type" ], "type": "object" }, { "$ref": "#/$defs/IdentificationLinkparams" } ], "description": "Identification Create Params V2\n\nThe params required to create an identification v2, we support three types of identification:\n- Link: where a link is provided to the customer for access to the identification process.\n- Token: where a token is provided in the request from which verification data can be extracted and where the token is generated by the third party provider\n- Person: where the identification details of the person for which the identification process is being created are provided in the request\n" }, "IdentificationCreateParamsV2_IdentificationPersonParams": { "allOf": [ { "properties": { "type": { "enum": [ "Person" ], "type": "string" } }, "required": [ "type" ], "type": "object" }, { "$ref": "#/$defs/IdentificationPersonParams" } ], "description": "Identification Create Params V2\n\nThe params required to create an identification v2, we support three types of identification:\n- Link: where a link is provided to the customer for access to the identification process.\n- Token: where a token is provided in the request from which verification data can be extracted and where the token is generated by the third party provider\n- Person: where the identification details of the person for which the identification process is being created are provided in the request\n" }, "IdentificationCreateParamsV2_IdentificationTokenParams": { "allOf": [ { "properties": { "type": { "enum": [ "Token" ], "type": "string" } }, "required": [ "type" ], "type": "object" }, { "$ref": "#/$defs/IdentificationTokenParams" } ], "description": "Identification Create Params V2\n\nThe params required to create an identification v2, we support three types of identification:\n- Link: where a link is provided to the customer for access to the identification process.\n- Token: where a token is provided in the request from which verification data can be extracted and where the token is generated by the third party provider\n- Person: where the identification details of the person for which the identification process is being created are provided in the request\n" }, "IdentificationLinkparams": { "description": "Direct Identification Params\n\nThe params required to create an identification\n", "properties": { "with_edd": { "description": "whether to initialize the identification with the full EDD process", "type": "boolean" } }, "title": "IdentificationLinkparams", "type": "object" }, "IdentificationPersonParams": { "description": "Person Identification Params\n\nThe params required to create an identification\n", "properties": { "address": { "$ref": "#/$defs/Address" }, "consent_collected_at": { "description": "Date and time when explicit consent was given to share identity\ntimestamp must be UTC timestamp e.g. 2025-02-01T15:38:21.775210Z", "type": "string" }, "date_of_birth": { "description": "date of birth in YYYY-MM-DD format", "type": "string" }, "documents": { "description": "documents associated with the person", "items": { "$ref": "#/$defs/IdentityDocument" }, "type": "array" }, "edd_questionnaire": { "$ref": "#/$defs/EddQuestionnaire" }, "email_address": { "description": "email address of the person", "type": "string" }, "first_name": { "description": "first name", "type": "string" }, "full_name": { "description": "full name", "type": "string" }, "identity": { "$ref": "#/$defs/PersonIdentity" }, "intended_use": { "$ref": "#/$defs/IntendedUse" }, "kyc_questionnaire": { "$ref": "#/$defs/KycQuestionnaire" }, "last_name": { "description": "last name", "type": "string" }, "phone_number": { "description": "phone number of the person (E.164 format)", "type": "string" }, "sharing_consent": { "description": "explicitly given consent to share identity information with iron", "type": "boolean" }, "tax_identification_number": { "description": "tax identification number (US residents only: SSN or TIN)", "type": "string" } }, "required": [ "sharing_consent", "consent_collected_at", "first_name", "last_name", "full_name", "date_of_birth", "phone_number", "email_address", "address", "identity", "intended_use", "kyc_questionnaire" ], "title": "IdentificationPersonParams", "type": "object" }, "IdentificationTokenParams": { "description": "Token Identification Params\n\nThe params required to create an identification\n", "properties": { "edd_questionnaire": { "$ref": "#/$defs/EddQuestionnaire" }, "intended_use": { "$ref": "#/$defs/IntendedUse" }, "ip_address": { "description": "The IP address of the customer associated with the token\nNot required if IP address is passed by token provided", "type": "string" }, "kyc_questionnaire": { "$ref": "#/$defs/KycQuestionnaire" }, "token": { "description": "The shareable token generated by the third party provider", "type": "string" } }, "required": [ "token", "intended_use" ], "title": "IdentificationTokenParams", "type": "object" }, "IdentityDocument": { "description": "Identity Document\n\nA base64 document that can be used to identify the business\n", "properties": { "file": { "description": "Base64 encoded document without prefix (10MB max)", "type": "string" }, "name": { "description": "The name of the document with the file extension", "type": "string" }, "type": { "$ref": "#/$defs/DocumentType" } }, "required": [ "name", "file", "type" ], "title": "IdentityDocument", "type": "object" }, "IdentityDocumentType": { "description": "Identity Document Type\n\nThe type of identity document useful to KYB process\n", "enum": [ "Passport", "NationalId", "DriverLicense", "ResidencePermit" ], "type": "string" }, "IntendedUse": { "description": "Intended Purpose\n\nThe intended purpose the person wants to use the account for\n", "enum": [ "Investing", "PaymentToFriendsFamilyorOthers", "PurchaseDigitalAssets", "OnlinePurchasesOfGoodsOrServices", "Trading" ], "type": "string" }, "KycQuestionnaire": { "description": "KYC Questionnaire\n\nThe questionnaire for a person\n", "properties": { "employment_status": { "$ref": "#/$defs/EmploymentStatus" }, "expected_monthly_transaction_count": { "$ref": "#/$defs/PersonProfileExpectedMonthlyTransactionCount" }, "expected_monthly_transaction_volume": { "$ref": "#/$defs/PersonProfileExpectedMonthlyTransactionVolumeV2" }, "source_of_wealth": { "$ref": "#/$defs/PersonProfileSourceOfWealth" }, "yearly_gross_income": { "$ref": "#/$defs/PersonProfileYearlyGrossIncome" } }, "required": [ "employment_status", "yearly_gross_income", "source_of_wealth", "expected_monthly_transaction_count", "expected_monthly_transaction_volume" ], "title": "KycQuestionnaire", "type": "object" }, "Occupation": { "description": "Occupation\n\nThe occupation of the person\n", "enum": [ "Agriculture", "ArtsAndEntertainment", "Construction", "Education", "FinancialServices", "InformationAndTechnology", "Retail", "RealEstate", "Other", "BusinessOwner", "Healthcare", "Industrial", "LegalServices", "PublicSector", "SeniorManagement" ], "type": "string" }, "PersonBeneficiaryInfo": { "description": "Company Person Beneficiary Info\n\nThe beneficiary info of the person\n", "properties": { "address": { "$ref": "#/$defs/Address" }, "birth_place": { "$ref": "#/$defs/BirthPlace" }, "date_of_birth": { "description": "date of birth in YYYY-MM-DD format", "type": "string" }, "email_address": { "description": "email address of the person", "type": "string" }, "first_name": { "description": "first name", "type": "string" }, "identity": { "$ref": "#/$defs/BeneficiaryIdentity" }, "last_name": { "description": "last name", "type": "string" }, "middle_name": { "description": "middle name", "type": "string" }, "phone_number": { "description": "phone number of the person (international format with leading +)", "type": "string" }, "proof_of_address": { "description": "Base64 encoded proof of address document (10MB max).\nOptional at submission: where policy requires one, a missing POA returns the\nidentification as Pending with a resume URL to collect it via resubmission.", "type": "string" }, "tax_identification_number": { "description": "tax identification number (SSN for US residents, national TIN otherwise).\nRequired for the UltimateBeneficialOwner of a sole proprietorship regardless of country.", "type": "string" }, "tax_jurisdiction_country_code": { "description": "ISO 3166-1 alpha-2 country code of the person's tax jurisdiction", "type": "string" } }, "required": [ "first_name", "last_name", "date_of_birth", "address", "email_address", "phone_number", "tax_jurisdiction_country_code", "birth_place", "identity" ], "title": "PersonBeneficiaryInfo", "type": "object" }, "PersonIdentity": { "description": "Person Identity\n\nThe required identity information of a person\n", "properties": { "identity_country_code": { "description": "country (2-character ISO 3166)", "type": "string" }, "identity_document_back": { "description": "Base64 encoded image of ident document back without prefix (10MB max)", "type": "string" }, "identity_document_front": { "description": "Base64 encoded image of ident document front without prefix (10MB max)", "type": "string" }, "identity_document_type": { "$ref": "#/$defs/IdentityDocumentType" }, "identity_number": { "description": "The identity number or identity document being submitted.", "type": "string" }, "ip_address": { "description": "ip address of device used to collect selfie", "type": "string" }, "nationality": { "description": "nationality (2-character ISO 3166 country code)", "type": "string" }, "selfie": { "description": "Base64 encoded image of selfie without prefix (10MB max)", "type": "string" }, "selfie_collected_at": { "description": "timestamp in ISO 8601 format", "type": "string" } }, "required": [ "identity_country_code", "identity_document_type", "identity_document_front", "selfie", "selfie_collected_at", "ip_address", "nationality" ], "title": "PersonIdentity", "type": "object" }, "PersonProfileExpectedMonthlyTransactionCount": { "description": "Expected Monthly Transaction Count\n\nThe expected monthly transaction volume of the person\n", "enum": [ "LessThan5", "Between5And10", "MoreThan10" ], "type": "string" }, "PersonProfileExpectedMonthlyTransactionVolumeV2": { "enum": [ "LessThan500", "MoreThan500LessThan2000", "MoreThan2000" ], "type": "string" }, "PersonProfileSourceOfWealth": { "description": "Source of Wealth\n\nThe source of wealth of the person\n", "enum": [ "Salary", "Savings", "Investments", "CryptoTrading", "Other" ], "type": "string" }, "PersonProfileYearlyGrossIncome": { "description": "Yearly Gross Income\n\nThe yearly gross income of the person\n", "enum": [ "LessThan20000", "From20001To30000", "From30001To40000", "From40001To50000", "From50001To60000", "From60001To70000", "From70001To80000", "From80001To90000", "From90001To100000", "From100001To110000", "From110001To120000", "From120001To130000", "From130001To140000", "From140001To150000", "MoreThan150000", "From150001To200000", "From200001To500000", "MoreThan500000" ], "type": "string" }, "RevenueSource": { "description": "Revenue Source\n\nPrimary source of company funds\n", "enum": [ "BusinessRevenue", "ShareholderFunds", "VcPrivateEquity", "AssetSale", "IcoProceeds", "CryptoActivityProceeds", "LoanProceeds", "Other" ], "type": "string" }, "SolePropBusinessDetails": { "description": "Sole Prop Business Details Section\n", "properties": { "business_model_description": { "description": "Description of business model and target clients", "type": "string" }, "estimated_annual_revenue": { "$ref": "#/$defs/BusinessEstimatedAnnualRevenue" }, "industry_type": { "$ref": "#/$defs/BusinessIndustryType" }, "main_business_countries": { "description": "Main countries of business operation (ISO 3166-1 alpha-2 codes)", "items": { "type": "string" }, "type": "array" } }, "required": [ "industry_type", "business_model_description", "main_business_countries", "estimated_annual_revenue" ], "title": "SolePropBusinessDetails", "type": "object" }, "SolePropBusinessQuestionnaire": { "description": "KYB compliance questionnaire for sole proprietorships\n", "properties": { "business_details": { "$ref": "#/$defs/SolePropBusinessDetails" }, "planned_activities": { "$ref": "#/$defs/SolePropPlannedActivities" }, "source_of_funds": { "$ref": "#/$defs/SolePropSourceOfFunds" } }, "required": [ "planned_activities", "source_of_funds", "business_details" ], "title": "SolePropBusinessQuestionnaire", "type": "object" }, "SolePropPlannedActivities": { "description": "Sole Prop Planned Activities Section\n", "properties": { "estimated_monthly_transactions": { "$ref": "#/$defs/BusinessEstimatedMonthlyTransactions" }, "estimated_monthly_volume": { "$ref": "#/$defs/BusinessEstimatedMonthlyVolume" }, "purpose_and_intended_use": { "$ref": "#/$defs/BusinessPurposeAndIntendedUse" } }, "required": [ "purpose_and_intended_use", "estimated_monthly_volume", "estimated_monthly_transactions" ], "title": "SolePropPlannedActivities", "type": "object" }, "SolePropSourceOfFunds": { "description": "Sole Prop Source of Funds Section\n", "properties": { "source_of_funds": { "$ref": "#/$defs/RevenueSource" } }, "required": [ "source_of_funds" ], "title": "SolePropSourceOfFunds", "type": "object" } } }