IdentificationCreateParamsV2

Identification Create Params V2 The params required to create an identification v2, we support three types of identification: - Link: where a link is provided to the customer for access to the identification process. - 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 - Person: where the identification details of the person for which the identification process is being created are provided in the request

CompanyStablecoinsPaymentsOn-RampOff-RampCryptocurrencyBankingFintechCompliance
View JSON Schema on GitHub

JSON Schema

unstoppable-finance-identification-create-params-v2-schema.json Raw ↑
{
  "$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 Do

# --- truncated at 32 KB (42 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/unstoppable-finance/refs/heads/main/json-schema/unstoppable-finance-identification-create-params-v2-schema.json

Work with this as data

Every JSON Schema here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for schemas

4 MCP tools reach this
  • find_json_schemasBrowse and filter every JSON Schema in the catalog.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This JSON Schema
curl "https://apis.io/api/v1/json-schemas/unstoppable-finance-identification-create-params-v2"
All schemas
curl "https://apis.io/api/v1/json-schemas?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

A second provider on the same verified email joins the account you already have.