---
title: "Create KYB Identity"
method: POST
path: "/api/identity-service/v1/identities"
tags: ["Know Your Business (KYB)"]
---

# Create KYB Identity

`POST /api/identity-service/v1/identities`

Create an identity with requested products. Requires User-Id header to associate the identity with the creating user.

## Request body

- union
  - CreateIndividualIdentityBody
    - `type` 'individual', required — Identity type
    - `userId` string, required — The ID of the user
    - `individual` Individual
      - `nameFirst` string — First name of the individual
      - `nameLast` string — Last name of the individual
      - `birthdate` Birthdate — Birthdate
        - `month` string, required — birthdate month (MM, e.g. "06")
        - `day` string, required — birthdate day (DD, e.g. "15")
        - `year` string, required — birthdate year (YYYY, e.g. "1990")
      - `phoneNumber` object
        - `countryCode` string, required — Country code of the phone number
        - `phoneNumber` string, required — Phone number (without country code)
      - `email` string, email — Email address of the individual
      - `occupation` 'Agriculture' | 'Art Dealer / Auctioneer / Import / Export Company' | 'Financial Services (Asset Mgmt., Bank, Broker Dealer, Commodities, Mutual Fund, Ins. Co)' | 'Casinos and Gambling Establishments' | 'Charity/NGO/Non-Profit/Foundation/Endowment' | 'Computer Programmer / Administrator / Software Engineer / IT or Software / Technology Company' | 'Crypto Services (ATM, Exchange, Lender, Coins/Token)' | 'Education / Teacher' | 'Extractive Industry (Oil, Gas, etc.) / Jewels / Gemstones / Precious Metals' | 'Family Office' | 'Film / TV / Entertainment (not adult)' | 'Government/State owned/Political Org. (i.e. Sovereign Wealth Fund)' | 'Healthcare' | 'Law Enforcement / Military / Protective Services' | 'Miner / Mining Pool' | 'Money Service Business' | 'Other' | 'Private Equity / Venture Capital' | 'Professional Service Providers (lawyers accountants etc.)' | 'Real estate brokers developers and appraisers' | 'Recreation / Hospitality' | 'Student / Unemployed / Retired' | 'Traders / Trading (High Frequency, Proprietary, Market Maker)' | 'Weapons Dealers' — Occupation category. Use OccupationEnum values.
      - `countryOfCitizenship` unknown
      - `countryOfResidence` unknown
      - `govIdCountryOfIssuance` unknown
      - `govIdClass` 'cct' | 'cid' | 'dl' | 'foid' | 'hic' | 'id' | 'ipp' | 'keyp' | 'ltpass' | 'munid' | 'myn' | 'nbi' | 'nric' | 'ofw' | 'rp' | 'pan' | 'pid' | 'pp' | 'ppc' | 'pr' | 'sss' | 'td' | 'tribalid' | 'umid' | 'vid' | 'visa' | 'wp' | 'computerizedPayslips' | 'incomeTaxAssessment' | 'employmentLetterContract' | 'bankStatement' | 'dptHoldingStatement' | 'investmentHoldingsStatement' | 'titleDeeds' | 'propertyTaxCpfStatement' | 'other' — Class of government ID. Valid values: cct - Citizenship Certificate, cid - Consular ID, dl - Driver's License, foid - CO Foreigner ID, hic - Health Insurance Card, id - Identification Card, ipp - Internal Passport, keyp - AU Keypass ID, ltpass - Long Term Pass, munid - US Municipal ID (e.g. NYC ID), myn - JP My Number Card (SSN), nbi - PH National Bureau of Investigation Certificate, nric - SG National Residency ID, ofw - PH Overseas Foreign Worker Card, rp - Residence Permit, pan - IN Permanent Account Number card (SSN), pid - PH Postal Identity Card, pp - Passport, ppc - Passport Card, pr - Permanent Residence Card, sss - PH Social Security System Card (SSN), td - US Travel Document, tribalid - US/CA Tribal ID, umid - PH Unified Multi Purpose ID, vid - Voter ID, visa - Visa, wp - Work Permit
      - `address` object
        - `street1` string, required — Street address line 1
        - `street2` string — Street address line 2
        - `city` string, required — City name
        - `subdivision` string — State, province, or region (formatted as subdivision section of ISO 3166-2, excludes country code)
        - `zip` string, required — ZIP or postal code
        - `country` unknown, required
      - `identificationNumber` string — National identification number (e.g., SSN, passport number)
      - `politicallyExposedPerson` boolean — Whether the individual is a politically exposed person
      - `multipleCitizenship` string[] — Additional citizenships beyond primary (ISO 3166-1 alpha-3 codes)
      - `sourceOfFundOrigin` string — Origin of funds to be deposited (e.g., employment, savings)
      - `sourceOfFundOriginOfTransfer` string — Specific transfer origin: bank name for fiat, platform/wallet name for digital assets
      - `occupationDetails` string — Free-text occupation description (required when occupation is self-employed or other)
      - `employerName` string — Name of employer
      - `jobTitle` string — Job title
      - `annualIncome` 'Under $50,000' | '$50,001 - $100,000' | '$100,001 - $300,000' | '$300,001 - $500,000' | '$500,001 and over' — Annual income bracket in SGD
      - `accountOpeningPurpose` string — Purpose of opening a BitGo Singapore account
      - `sourceOfWealth` 'employmentIncome' | 'inheritance' | 'saleOfBusinessOrProperty' | 'other' — Source of wealth category (required for high-CRR individuals)
      - `sourceOfWealthDetails` string — Free-text source of wealth details (required when sourceOfWealth is "other")
      - `netWorth` 'Under $100,000' | '$100,001 - $500,000' | '$500,001 - $1,000,000' | '$1,000,001 - $5,000,000' | '$5,000,001 and over' — Net worth bracket in SGD (required for high-CRR individuals)
      - `digitalAssetWalletAddress` string — Digital asset wallet address (required for high-CRR when source of wealth involves digital assets). Format varies by chain; validated downstream.
      - `accreditedInvestorOptedIn` boolean — Whether the individual has opted in as an Accredited Investor under MAS
      - `accreditedInvestorQualifyingCriteria` 'income' | 'netAssets' | 'financialAssets' — Qualifying criteria for AI status (required when accreditedInvestorOptedIn is true)
      - `raaPassed` boolean — Whether the individual passed the Risk Awareness Assessment (required when accreditedInvestorOptedIn is false)
      - `clientAttestationDate` string, date-time — ISO 8601 date when the CaaS client attested RAA completion (Phase 1 reliance model)
      - `clientAttestationReference` string — CaaS client reference for RAA attestation record (Phase 1 reliance model)
    - `requestedProducts` object[], required — List of requested bitgo products (can be empty for associated people)
      - `name` 'Trade' | 'Instant Fee Wallets' | 'Hot Self-Custody' | 'Cold Self-Custody' | 'Custody' | 'DeFi' | 'Staking' | 'Go Account' | 'ACH Debits' | 'Distributed Custody', required — Name of the BitGo product
      - `bitgoOrg` 'BitGo Trust' | 'BitGo New York' | 'BitGo Germany' | 'BitGo Switzerland' | 'BitGo Europe ApS' | 'Frankfurt DE Trust' | 'BitGo Singapore' | 'BitGo Korea' | 'BitGo Mena Fze' | 'BitGo Custody MENA FZE' | 'BitGo India' | 'BitGo Sister Trust 1' | 'BitGo Inc', required — The BitGo entity identifier
    - `finalizeSubmission` boolean — Whether identity is ready for final submission and requirements validation
  - CreateBusinessIdentityBody
    - `type` 'business', required — Identity type
    - `organizationId` string, required — The ID of the organization
    - `enterpriseId` string, required — The ID of the enterprise
    - `business` Business
      - `businessName` string — Legal name of the business
      - `incorporationCountryCode` unknown
      - `primaryOperationsCountryCode` unknown
      - `einTinIdentificationNumber` string — EIN/TIN of the business
      - `otherEntityId` string — Any additional entity identifier (e.g. company registration name or official registry ID)
      - `physicalBusinessAddress` object
        - `street1` string, required — Street address line 1
        - `street2` string — Street address line 2
        - `city` string, required — City name
        - `subdivision` string — State, province, or region (formatted as subdivision section of ISO 3166-2, excludes country code)
        - `zip` string, required — ZIP or postal code
        - `country` unknown, required
      - `mailingAddress` object
        - `street1` string, required — Street address line 1
        - `street2` string — Street address line 2
        - `city` string, required — City name
        - `subdivision` string — State, province, or region (formatted as subdivision section of ISO 3166-2, excludes country code)
        - `zip` string, required — ZIP or postal code
        - `country` unknown, required
      - `billingAddress` object
        - `street1` string, required — Street address line 1
        - `street2` string — Street address line 2
        - `city` string, required — City name
        - `subdivision` string — State, province, or region (formatted as subdivision section of ISO 3166-2, excludes country code)
        - `zip` string, required — ZIP or postal code
        - `country` unknown, required
      - `legalEntityStructure` 'llc' | 'corporationCAndS' | 'partnershipLimitedAndLLP' | 'generalPartnership' | 'trusts' | 'privateInvestmentOrFoundation' | 'unincorporatedBusiness' | 'soleProprietorship' | 'governmentOwned' | 'publiclyTraded' | 'supranationalBodies' | 'specialPurposeVehicle' | 'segregatedPortfolioCompany' — Business entity legal structure used to filter requirements (enum).
      - `formationDate` string — Business formation date (YYYY-MM-DD)
      - `dbaName` string — DBA (Doing Business As) name
      - `companyWebsiteAddress` string, uri — Official company website
      - `primaryBusinessType` 'Crypto Services (Exchange, ATM, Borrow/Lend)' | 'Crypto Solutions (DAO, Staking, CaaS, hot wallet provider, miner/mining pool, coins/tokens (developer, issuer, foundation))' | 'Custodian' | 'Agriculture' | 'Arts, Media, Entertainment' | 'Asset Management (i.e. revocable/irrevocable trust, IRA, pension fund)' | 'Bank' | 'Broker/Dealer' | 'Casinos and Gambling Establishments' | 'Charity/NGO/Non-profit/Foundation/Endowment' | 'Commodities/Futures Commission Merchant' | 'Corporate Holding Company' | 'Education' | 'Energy companies' | 'Family Office' | 'Food, hospitality, and tourism' | 'Government/State owned/Political Org. (i.e. Sovereign Wealth Fund)' | 'Import/Export Companies' | 'Industrial (construction, manufacturing, textiles, chemicals, etc.)' | 'Insurance Company' | 'Law Enforcement / Military / Protective Services' | 'Marijuana-related Business' | 'Money Services Business (MSB)' | 'Mutual Funds' | 'NBFI (Venture Capital Fund, Hedge Fund, Private Equity Fund, Pooled Investment Fund, Index Fund, ETF Issuer, Registered Investment Advisor, Prime Brokerage)' | 'OTC' | 'Other' | 'Payment Platforms' | 'Personal Holding Company' | 'Private Equity / Venture Capital' | 'Private Investment Companies / International Business Corporations' | 'Professional Service Providers (lawyers, accountants, etc.)' | 'Real estate brokers, developers, and appraisers' | 'Retail Lender' | 'Software or Technology Company' | 'Traders / Trading (High Frequency, Proprietary, Market Maker)' | 'Transportation & Shipping' | 'Weapons Dealers' — Primary type of business
      - `descriptionBusinessActivities` string — Short description of the business
      - `billingContact` object
        - `nameFirst` string, required — First name
        - `nameLast` string, required — Last name
        - `emailAddress` string, email, required — Email address
        - `phoneNumber` object, required
          - `countryCode` string, required — Country code of the phone number
          - `phoneNumber` string, required — Phone number (without country code)
      - `authorizedSigner` object
        - `nameFirst` string, required — First name
        - `nameLast` string, required — Last name
        - `emailAddress` string, email, required — Email address
        - `phoneNumber` object, required
          - `countryCode` string, required — Country code of the phone number
          - `phoneNumber` string, required — Phone number (without country code)
      - `tradeStrategy` string — Trading strategy of the business
      - `activeCoinTokens` string — Active cryptocurrencies traded
      - `tradeVolumeUsd` string — Estimated trade volume in USD
      - `activeExchanges` string — List of active exchanges
      - `diligenceRetailInstitutional` 'retail0To25' | 'retail25To50' | 'retail50To75' | 'retail75To100' — Percentage breakdown of retail vs institutional customer base
      - `customerBaseLocations` string — Locations of customer base
      - `sanctionAffiliates` boolean — Whether the business has sanctioned affiliates
      - `hasAuditor` boolean — Whether the business has an auditor
      - `firmAuditor` string, nullable — Name of audit firm (if applicable)
      - `hasLegalCounsel` boolean — Whether the business has legal counsel
      - `diligenceCounselName` string, nullable — Name of legal counsel (if applicable)
      - `walletAddress` string — Business wallet address
      - `isRegulated` boolean — Whether the business is regulated
      - `regulatorCountryCode` unknown
      - `regulatorName` string, nullable — Name of the regulator
      - `regulatoryRegistrationNumber` string, nullable — Regulatory registration number
      - `amlAttestation` AmlAttestation — AML attestation data (who attested, when, and the yes/no answer)
        - `userId` string, required — BitGo user ID of the person performing the attestation
        - `attestationDate` string, date-time, required — ISO 8601 date of the attestation
        - `attested` boolean, required — Whether the AML attestation was affirmed
      - `fundsSource` 'proprietary' | 'customer' — Whether funds deposited are proprietary or customer funds
      - `diligenceMaterialFindings` boolean — Has there been any recent Financial Crime related civil or criminal proceedings, regulatory actions, or findings against the company in the past year?
      - `diligenceMaterialFindingsDescription` string, nullable — Description of material findings (required if diligenceMaterialFindings is true)
      - `prescreenWalletAddressAtm` boolean — Does the business pre-screen wallet addresses at ATMs?
      - `outsourcedFunctions` boolean — Does the business outsource any AML/compliance functions?
      - `outsourcedVendors` string, nullable — Names of vendors providing outsourced functions (required if outsourcedFunctions is true)
      - `diligenceFinancialInstitutionsUsed` string — Financial institutions used by the business
      - `diligenceCanReceiveThirdPartyPayments` boolean — Can the business receive payments from third parties?
      - `diligenceCanSendRemittances` 'yesBothFiatAndCrypto' | 'yesFiat' | 'yesCrypto' | 'no' | 'other' — Can the business send remittances?
      - `diligenceRemittancesOther` string, nullable — Description of remittance type (required if diligenceCanSendRemittances is "other")
      - `diligenceAllowWhitelist` boolean — Does the business allow wallet address whitelisting?
    - `associatedPeople` AssociatedPersonInput[] — List of associated people
      - `role` 'beneficialOwner' | 'controlPerson' | 'platformAdmin', required — Role of the associated person
      - `percentageOwnership` number — Percentage of ownership (only for beneficialOwner, minimum 10%)
      - `identityId` string, required — Identity ID of the person
    - `requestedProducts` object[], required — List of requested bitgo products (business entities require at least one product)
      - `name` 'Trade' | 'Instant Fee Wallets' | 'Hot Self-Custody' | 'Cold Self-Custody' | 'Custody' | 'DeFi' | 'Staking' | 'Go Account' | 'ACH Debits' | 'Distributed Custody', required — Name of the BitGo product
      - `bitgoOrg` 'BitGo Trust' | 'BitGo New York' | 'BitGo Germany' | 'BitGo Switzerland' | 'BitGo Europe ApS' | 'Frankfurt DE Trust' | 'BitGo Singapore' | 'BitGo Korea' | 'BitGo Mena Fze' | 'BitGo Custody MENA FZE' | 'BitGo India' | 'BitGo Sister Trust 1' | 'BitGo Inc', required — The BitGo entity identifier
    - `finalizeSubmission` boolean — Whether identity is ready for final submission and requirements validation

## Response `201`

201

- union
  - IndividualIdentityResponse
    - `type` 'individual', required — Type of identity
    - `userId` string, required — The ID of the user
    - `individual` Individual, required
      - `nameFirst` string — First name of the individual
      - `nameLast` string — Last name of the individual
      - `birthdate` Birthdate — Birthdate
        - `month` string, required — birthdate month (MM, e.g. "06")
        - `day` string, required — birthdate day (DD, e.g. "15")
        - `year` string, required — birthdate year (YYYY, e.g. "1990")
      - `phoneNumber` object
        - `countryCode` string, required — Country code of the phone number
        - `phoneNumber` string, required — Phone number (without country code)
      - `email` string, email — Email address of the individual
      - `occupation` 'Agriculture' | 'Art Dealer / Auctioneer / Import / Export Company' | 'Financial Services (Asset Mgmt., Bank, Broker Dealer, Commodities, Mutual Fund, Ins. Co)' | 'Casinos and Gambling Establishments' | 'Charity/NGO/Non-Profit/Foundation/Endowment' | 'Computer Programmer / Administrator / Software Engineer / IT or Software / Technology Company' | 'Crypto Services (ATM, Exchange, Lender, Coins/Token)' | 'Education / Teacher' | 'Extractive Industry (Oil, Gas, etc.) / Jewels / Gemstones / Precious Metals' | 'Family Office' | 'Film / TV / Entertainment (not adult)' | 'Government/State owned/Political Org. (i.e. Sovereign Wealth Fund)' | 'Healthcare' | 'Law Enforcement / Military / Protective Services' | 'Miner / Mining Pool' | 'Money Service Business' | 'Other' | 'Private Equity / Venture Capital' | 'Professional Service Providers (lawyers accountants etc.)' | 'Real estate brokers developers and appraisers' | 'Recreation / Hospitality' | 'Student / Unemployed / Retired' | 'Traders / Trading (High Frequency, Proprietary, Market Maker)' | 'Weapons Dealers' — Occupation category. Use OccupationEnum values.
      - `countryOfCitizenship` unknown
      - `countryOfResidence` unknown
      - `govIdCountryOfIssuance` unknown
      - `govIdClass` 'cct' | 'cid' | 'dl' | 'foid' | 'hic' | 'id' | 'ipp' | 'keyp' | 'ltpass' | 'munid' | 'myn' | 'nbi' | 'nric' | 'ofw' | 'rp' | 'pan' | 'pid' | 'pp' | 'ppc' | 'pr' | 'sss' | 'td' | 'tribalid' | 'umid' | 'vid' | 'visa' | 'wp' | 'computerizedPayslips' | 'incomeTaxAssessment' | 'employmentLetterContract' | 'bankStatement' | 'dptHoldingStatement' | 'investmentHoldingsStatement' | 'titleDeeds' | 'propertyTaxCpfStatement' | 'other' — Class of government ID. Valid values: cct - Citizenship Certificate, cid - Consular ID, dl - Driver's License, foid - CO Foreigner ID, hic - Health Insurance Card, id - Identification Card, ipp - Internal Passport, keyp - AU Keypass ID, ltpass - Long Term Pass, munid - US Municipal ID (e.g. NYC ID), myn - JP My Number Card (SSN), nbi - PH National Bureau of Investigation Certificate, nric - SG National Residency ID, ofw - PH Overseas Foreign Worker Card, rp - Residence Permit, pan - IN Permanent Account Number card (SSN), pid - PH Postal Identity Card, pp - Passport, ppc - Passport Card, pr - Permanent Residence Card, sss - PH Social Security System Card (SSN), td - US Travel Document, tribalid - US/CA Tribal ID, umid - PH Unified Multi Purpose ID, vid - Voter ID, visa - Visa, wp - Work Permit
      - `address` object
        - `street1` string, required — Street address line 1
        - `street2` string — Street address line 2
        - `city` string, required — City name
        - `subdivision` string — State, province, or region (formatted as subdivision section of ISO 3166-2, excludes country code)
        - `zip` string, required — ZIP or postal code
        - `country` unknown, required
      - `identificationNumber` string — National identification number (e.g., SSN, passport number)
      - `politicallyExposedPerson` boolean — Whether the individual is a politically exposed person
      - `multipleCitizenship` string[] — Additional citizenships beyond primary (ISO 3166-1 alpha-3 codes)
      - `sourceOfFundOrigin` string — Origin of funds to be deposited (e.g., employment, savings)
      - `sourceOfFundOriginOfTransfer` string — Specific transfer origin: bank name for fiat, platform/wallet name for digital assets
      - `occupationDetails` string — Free-text occupation description (required when occupation is self-employed or other)
      - `employerName` string — Name of employer
      - `jobTitle` string — Job title
      - `annualIncome` 'Under $50,000' | '$50,001 - $100,000' | '$100,001 - $300,000' | '$300,001 - $500,000' | '$500,001 and over' — Annual income bracket in SGD
      - `accountOpeningPurpose` string — Purpose of opening a BitGo Singapore account
      - `sourceOfWealth` 'employmentIncome' | 'inheritance' | 'saleOfBusinessOrProperty' | 'other' — Source of wealth category (required for high-CRR individuals)
      - `sourceOfWealthDetails` string — Free-text source of wealth details (required when sourceOfWealth is "other")
      - `netWorth` 'Under $100,000' | '$100,001 - $500,000' | '$500,001 - $1,000,000' | '$1,000,001 - $5,000,000' | '$5,000,001 and over' — Net worth bracket in SGD (required for high-CRR individuals)
      - `digitalAssetWalletAddress` string — Digital asset wallet address (required for high-CRR when source of wealth involves digital assets). Format varies by chain; validated downstream.
      - `accreditedInvestorOptedIn` boolean — Whether the individual has opted in as an Accredited Investor under MAS
      - `accreditedInvestorQualifyingCriteria` 'income' | 'netAssets' | 'financialAssets' — Qualifying criteria for AI status (required when accreditedInvestorOptedIn is true)
      - `raaPassed` boolean — Whether the individual passed the Risk Awareness Assessment (required when accreditedInvestorOptedIn is false)
      - `clientAttestationDate` string, date-time — ISO 8601 date when the CaaS client attested RAA completion (Phase 1 reliance model)
      - `clientAttestationReference` string — CaaS client reference for RAA attestation record (Phase 1 reliance model)
    - `id` string, required — The unique ID of the created identity
    - `ignoredFields` string[] — Ignored fields
    - `requestedProducts` RequestedProductResponse[], required — List of products requested for this identity
      - `id` string, required — Unique identifier for the requested permission
      - `name` 'Instant Fee Wallets' | 'Go Account' | 'ACH Debits' | 'Settlement' | 'Tax' | 'Trade API' | 'Margin Trading' | 'Elliptic' | 'CryptoCompare' | 'MetaMask' | 'Custody' | 'Borrowing' | 'Lending' | 'DeFi' | 'Cold Self-Custody' | 'Go Network' | 'Staking' | 'Trade' | 'Hot Self-Custody' | 'Escrow' | 'Escrow - Triparty' | 'Distributed Custody' | 'Link', required — Name of the BitGo product
      - `bitgoOrg` 'BitGo Trust' | 'BitGo New York' | 'BitGo Germany' | 'BitGo Switzerland' | 'BitGo Europe ApS' | 'Frankfurt DE Trust' | 'BitGo Singapore' | 'BitGo Korea' | 'BitGo Mena Fze' | 'BitGo Custody MENA FZE' | 'BitGo India' | 'BitGo Sister Trust 1' | 'BitGo Inc', required — The BitGo entity identifier
      - `country` unknown
      - `subdivision` string — The subdivision where the permission is being requested
      - `status` 'missingLocation' | 'missingEntityStructure' | 'missingRequirements' | 'readyForSubmission' | 'inReview' | 'approved' | 'rejected', required — Status of the requested permission
    - `requirements` Requirement[], required — List of requirements related to the identity
      - `id` string, required — Unique identifier for the requirement
      - `kind` 'businessInformation' | 'data' | 'document' | 'associatedPerson' | 'agreement' | 'externalVerification', required — Type of requirement
      - `name` string, required — Name of the requirement
      - `status` 'missing' | 'countExceeded' | 'submitted' | 'inReview' | 'verified', required — Current status of the requirement
      - `minRequired` number — Minimum number required (for associated persons)
      - `maxAllowed` number — Maximum number allowed (for associated persons)
    - `documents` Document[] — List of documents associated with the identity
      - `id` string, required — Internal ID for the document association
      - `documentId` string, required — External document service ID
      - `documentType` 'governmentId' | 'commercialRegister' | 'articlesOfAssociation' | 'certificateOfIncorporation' | 'certificateOfGoodStanding' | 'certificateOfTrust' | 'certificateOfIncumbency' | 'certificateOfIncumbencyOrShareRegister' | 'proofOfPrincipalPlaceOfBusiness' | 'activeTradeLicense' | 'resolutionToOpenBitgoUaeAccount' | 'resolutionToOpenBitgoSingaporeAccount' | 'proofOfAuthorizedSignatories' | 'memorandumOfAssociation' | 'memorandumAndArticlesOfAssociation' | 'bylawsOrOperatingAgreement' | 'operatingAgreement' | 'w8' | 'w9' | 'evidenceOfLegalStatus' | 'evidenceOfActiveStatus' | 'proofOfJfsaLicense' | 'proofOfGamingLicense' | 'organizationDocument' | 'partnershipAgreement' | 'articlesOfOrganization' | 'businessLicenseOrRegistration' | 'evidenceOfGovernmentOrStateOwnership' | 'secFilingsAsEvidenceOfPublicTradingStatus' | 'foundingTreatyOrEquivalent' | 'proofOfAddress' | 'sourceOfWealth' | 'singaporeSupportingDocument' | 'caseRequiredDocuments' | 'correspondentAccountCertification' | 'authorizedSignerForm', required — Type of document being uploaded
      - `status` 'missing' | 'countExceeded' | 'submitted' | 'inReview' | 'verified', required — Verification status
    - `externalVerifications` ExternalVerification[] — External verifications (e.g. Persona) for this identity
      - `id` string, required — Internal ID of the external verification
      - `provider` string, required — Provider (e.g. persona, singpass)
      - `resourceId` string — Provider resource ID (absent for pending rows)
      - `resourceLink` string — Link to the verification session
      - `status` 'pending' | 'inProgress' | 'completed' | 'failed', required — Verification status
      - `lastUpdated` string, date-time, required — Timestamp when the verification was last updated
    - `finalizeSubmission` boolean, required — Whether identity is ready for final submission and requirements validation
  - BusinessIdentityResponse
    - `type` 'business', required — Type of identity
    - `organizationId` string, required — The ID of the organization
    - `enterpriseId` string, required — The ID of the enterprise
    - `business` Business, required
      - `businessName` string — Legal name of the business
      - `incorporationCountryCode` unknown
      - `primaryOperationsCountryCode` unknown
      - `einTinIdentificationNumber` string — EIN/TIN of the business
      - `otherEntityId` string — Any additional entity identifier (e.g. company registration name or official registry ID)
      - `physicalBusinessAddress` object
        - `street1` string, required — Street address line 1
        - `street2` string — Street address line 2
        - `city` string, required — City name
        - `subdivision` string — State, province, or region (formatted as subdivision section of ISO 3166-2, excludes country code)
        - `zip` string, required — ZIP or postal code
        - `country` unknown, required
      - `mailingAddress` object
        - `street1` string, required — Street address line 1
        - `street2` string — Street address line 2
        - `city` string, required — City name
        - `subdivision` string — State, province, or region (formatted as subdivision section of ISO 3166-2, excludes country code)
        - `zip` string, required — ZIP or postal code
        - `country` unknown, required
      - `billingAddress` object
        - `street1` string, required — Street address line 1
        - `street2` string — Street address line 2
        - `city` string, required — City name
        - `subdivision` string — State, province, or region (formatted as subdivision section of ISO 3166-2, excludes country code)
        - `zip` string, required — ZIP or postal code
        - `country` unknown, required
      - `legalEntityStructure` 'llc' | 'corporationCAndS' | 'partnershipLimitedAndLLP' | 'generalPartnership' | 'trusts' | 'privateInvestmentOrFoundation' | 'unincorporatedBusiness' | 'soleProprietorship' | 'governmentOwned' | 'publiclyTraded' | 'supranationalBodies' | 'specialPurposeVehicle' | 'segregatedPortfolioCompany' — Business entity legal structure used to filter requirements (enum).
      - `formationDate` string — Business formation date (YYYY-MM-DD)
      - `dbaName` string — DBA (Doing Business As) name
      - `companyWebsiteAddress` string, uri — Official company website
      - `primaryBusinessType` 'Crypto Services (Exchange, ATM, Borrow/Lend)' | 'Crypto Solutions (DAO, Staking, CaaS, hot wallet provider, miner/mining pool, coins/tokens (developer, issuer, foundation))' | 'Custodian' | 'Agriculture' | 'Arts, Media, Entertainment' | 'Asset Management (i.e. revocable/irrevocable trust, IRA, pension fund)' | 'Bank' | 'Broker/Dealer' | 'Casinos and Gambling Establishments' | 'Charity/NGO/Non-profit/Foundation/Endowment' | 'Commodities/Futures Commission Merchant' | 'Corporate Holding Company' | 'Education' | 'Energy companies' | 'Family Office' | 'Food, hospitality, and tourism' | 'Government/State owned/Political Org. (i.e. Sovereign Wealth Fund)' | 'Import/Export Companies' | 'Industrial (construction, manufacturing, textiles, chemicals, etc.)' | 'Insurance Company' | 'Law Enforcement / Military / Protective Services' | 'Marijuana-related Business' | 'Money Services Business (MSB)' | 'Mutual Funds' | 'NBFI (Venture Capital Fund, Hedge Fund, Private Equity Fund, Pooled Investment Fund, Index Fund, ETF Issuer, Registered Investment Advisor, Prime Brokerage)' | 'OTC' | 'Other' | 'Payment Platforms' | 'Personal Holding Company' | 'Private Equity / Venture Capital' | 'Private Investment Companies / International Business Corporations' | 'Professional Service Providers (lawyers, accountants, etc.)' | 'Real estate brokers, developers, and appraisers' | 'Retail Lender' | 'Software or Technology Company' | 'Traders / Trading (High Frequency, Proprietary, Market Maker)' | 'Transportation & Shipping' | 'Weapons Dealers' — Primary type of business
      - `descriptionBusinessActivities` string — Short description of the business
      - `billingContact` object
        - `nameFirst` string, required — First name
        - `nameLast` string, required — Last name
        - `emailAddress` string, email, required — Email address
        - `phoneNumber` object, required
          - `countryCode` string, required — Country code of the phone number
          - `phoneNumber` string, required — Phone number (without country code)
      - `authorizedSigner` object
        - `nameFirst` string, required — First name
        - `nameLast` string, required — Last name
        - `emailAddress` string, email, required — Email address
        - `phoneNumber` object, required
          - `countryCode` string, required — Country code of the phone number
          - `phoneNumber` string, required — Phone number (without country code)
      - `tradeStrategy` string — Trading strategy of the business
      - `activeCoinTokens` string — Active cryptocurrencies traded
      - `tradeVolumeUsd` string — Estimated trade volume in USD
      - `activeExchanges` string — List of active exchanges
      - `diligenceRetailInstitutional` 'retail0To25' | 'retail25To50' | 'retail50To75' | 'retail75To100' — Percentage breakdown of retail vs institutional customer base
      - `customerBaseLocations` string — Locations of customer base
      - `sanctionAffiliates` boolean — Whether the business has sanctioned affiliates
      - `hasAuditor` boolean — Whether the business has an auditor
      - `firmAuditor` string, nullable — Name of audit firm (if applicable)
      - `hasLegalCounsel` boolean — Whether the business has legal counsel
      - `diligenceCounselName` string, nullable — Name of legal counsel (if applicable)
      - `walletAddress` string — Business wallet address
      - `isRegulated` boolean — Whether the business is regulated
      - `regulatorCountryCode` unknown
      - `regulatorName` string, nullable — Name of the regulator
      - `regulatoryRegistrationNumber` string, nullable — Regulatory registration number
      - `amlAttestation` AmlAttestation — AML attestation data (who attested, when, and the yes/no answer)
        - `userId` string, required — BitGo user ID of the person performing the attestation
        - `attestationDate` string, date-time, required — ISO 8601 date of the attestation
        - `attested` boolean, required — Whether the AML attestation was affirmed
      - `fundsSource` 'proprietary' | 'customer' — Whether funds deposited are proprietary or customer funds
      - `diligenceMaterialFindings` boolean — Has there been any recent Financial Crime related civil or criminal proceedings, regulatory actions, or findings against the company in the past year?
      - `diligenceMaterialFindingsDescription` string, nullable — Description of material findings (required if diligenceMaterialFindings is true)
      - `prescreenWalletAddressAtm` boolean — Does the business pre-screen wallet addresses at ATMs?
      - `outsourcedFunctions` boolean — Does the business outsource any AML/compliance functions?
      - `outsourcedVendors` string, nullable — Names of vendors providing outsourced functions (required if outsourcedFunctions is true)
      - `diligenceFinancialInstitutionsUsed` string — Financial institutions used by the business
      - `diligenceCanReceiveThirdPartyPayments` boolean — Can the business receive payments from third parties?
      - `diligenceCanSendRemittances` 'yesBothFiatAndCrypto' | 'yesFiat' | 'yesCrypto' | 'no' | 'other' — Can the business send remittances?
      - `diligenceRemittancesOther` string, nullable — Description of remittance type (required if diligenceCanSendRemittances is "other")
      - `diligenceAllowWhitelist` boolean — Does the business allow wallet address whitelisting?
    - `associatedPeople` AssociatedPersonResponse[], required — List of associated people linked to this identity
      - `associatedPersonId` string, uuid, required — Unique identifier for the link between the business identity and this associated individual
      - `identityId` string, required — The individual identity ID of the associated person
      - `role` 'beneficialOwner' | 'controlPerson' | 'platformAdmin', required — Role of the associated person
      - `percentageOwnership` number, nullable, required — Percentage of ownership (only applicable to beneficial owners)
      - `status` 'missingLocation' | 'missingRequirements' | 'readyForSubmission' | 'inReview' | 'verified' | 'rejected', required — Verification status of the associated person
      - `individual` object, required — Individual data for the associated person
        - `nameFirst` string — First name of the individual
        - `nameLast` string — Last name of the individual
        - `birthdate` Birthdate — Birthdate
          - `month` string, required — birthdate month (MM, e.g. "06")
          - `day` string, required — birthdate day (DD, e.g. "15")
          - `year` string, required — birthdate year (YYYY, e.g. "1990")
        - `phoneNumber` object
          - `countryCode` string, required — Country code of the phone number
          - `phoneNumber` string, required — Phone number (without country code)
        - `email` string, email — Email address of the individual
        - `occupation` 'Agriculture' | 'Art Dealer / Auctioneer / Import / Export Company' | 'Financial Services (Asset Mgmt., Bank, Broker Dealer, Commodities, Mutual Fund, Ins. Co)' | 'Casinos and Gambling Establishments' | 'Charity/NGO/Non-Profit/Foundation/Endowment' | 'Computer Programmer / Administrator / Software Engineer / IT or Software / Technology Company' | 'Crypto Services (ATM, Exchange, Lender, Coins/Token)' | 'Education / Teacher' | 'Extractive Industry (Oil, Gas, etc.) / Jewels / Gemstones / Precious Metals' | 'Family Office' | 'Film / TV / Entertainment (not adult)' | 'Government/State owned/Political Org. (i.e. Sovereign Wealth Fund)' | 'Healthcare' | 'Law Enforcement / Military / Protective Services' | 'Miner / Mining Pool' | 'Money Service Business' | 'Other' | 'Private Equity / Venture Capital' | 'Professional Service Providers (lawyers accountants etc.)' | 'Real estate brokers developers and appraisers' | 'Recreation / Hospitality' | 'Student / Unemployed / Retired' | 'Traders / Trading (High Frequency, Proprietary, Market Maker)' | 'Weapons Dealers' — Occupation category. Use OccupationEnum values.
        - `countryOfCitizenship` unknown
        - `countryOfResidence` unknown
        - `govIdCountryOfIssuance` unknown
        - `govIdClass` 'cct' | 'cid' | 'dl' | 'foid' | 'hic' | 'id' | 'ipp' | 'keyp' | 'ltpass' | 'munid' | 'myn' | 'nbi' | 'nric' | 'ofw' | 'rp' | 'pan' | 'pid' | 'pp' | 'ppc' | 'pr' | 'sss' | 'td' | 'tribalid' | 'umid' | 'vid' | 'visa' | 'wp' | 'computerizedPayslips' | 'incomeTaxAssessment' | 'employmentLetterContract' | 'bankStatement' | 'dptHoldingStatement' | 'investmentHoldingsStatement' | 'titleDeeds' | 'propertyTaxCpfStatement' | 'other' — Class of government ID. Valid values: cct - Citizenship Certificate, cid - Consular ID, dl - Driver's License, foid - CO Foreigner ID, hic - Health Insurance Card, id - Identification Card, ipp - Internal Passport, keyp - AU Keypass ID, ltpass - Long Term Pass, munid - US Municipal ID (e.g. NYC ID), myn - JP My Number Card (SSN), nbi - PH National Bureau of Investigation Certificate, nric - SG National Residency ID, ofw - PH Overseas Foreign Worker Card, rp - Residence Permit, pan - IN Permanent Account Number card (SSN), pid - PH Postal Identity Card, pp - Passport, ppc - Passport Card, pr - Permanent Residence Card, sss - PH Social Security System Card (SSN), td - US Travel Document, tribalid - US/CA Tribal ID, umid - PH Unified Multi Purpose ID, vid - Voter ID, visa - Visa, wp - Work Permit
        - `address` object
          - `street1` string, required — Street address line 1
          - `street2` string — Street address line 2
          - `city` string, required — City name
          - `subdivision` string — State, province, or region (formatted as subdivision section of ISO 3166-2, excludes country code)
          - `zip` string, required — ZIP or postal code
          - `country` unknown, required
        - `identificationNumber` string — National identification number (e.g., SSN, passport number)
        - `politicallyExposedPerson` boolean — Whether the individual is a politically exposed person
        - `multipleCitizenship` string[] — Additional citizenships beyond primary (ISO 3166-1 alpha-3 codes)
        - `sourceOfFundOrigin` string — Origin of funds to be deposited (e.g., employment, savings)
        - `sourceOfFundOriginOfTransfer` string — Specific transfer origin: bank name for fiat, platform/wallet name for digital assets
        - `occupationDetails` string — Free-text occupation description (required when occupation is self-employed or other)
        - `employerName` string — Name of employer
        - `jobTitle` string — Job title
        - `annualIncome` 'Under $50,000' | '$50,001 - $100,000' | '$100,001 - $300,000' | '$300,001 - $500,000' | '$500,001 and over' — Annual income bracket in SGD
        - `accountOpeningPurpose` string — Purpose of opening a BitGo Singapore account
        - `sourceOfWealth` 'employmentIncome' | 'inheritance' | 'saleOfBusinessOrProperty' | 'other' — Source of wealth category (required for high-CRR individuals)
        - `sourceOfWealthDetails` string — Free-text source of wealth details (required when sourceOfWealth is "other")
        - `netWorth` 'Under $100,000' | '$100,001 - $500,000' | '$500,001 - $1,000,000' | '$1,000,001 - $5,000,000' | '$5,000,001 and over' — Net worth bracket in SGD (required for high-CRR individuals)
        - `digitalAssetWalletAddress` string — Digital asset wallet address (required for high-CRR when source of wealth involves digital assets). Format varies by chain; validated downstream.
        - `accreditedInvestorOptedIn` boolean — Whether the individual has opted in as an Accredited Investor under MAS
        - `accreditedInvestorQualifyingCriteria` 'income' | 'netAssets' | 'financialAssets' — Qualifying criteria for AI status (required when accreditedInvestorOptedIn is true)
        - `raaPassed` boolean — Whether the individual passed the Risk Awareness Assessment (required when accreditedInvestorOptedIn is false)
        - `clientAttestationDate` string, date-time — ISO 8601 date when the CaaS client attested RAA completion (Phase 1 reliance model)
        - `clientAttestationReference` string — CaaS client reference for RAA attestation record (Phase 1 reliance model)
      - `userId` string, required — User ID of the associated person
      - `missingRequirements` MissingRequirement[], required — List of missing requirements for the associated person
        - `id` string, required — Unique identifier for the missing requirement
        - `kind` 'businessInformation' | 'data' | 'document' | 'associatedPerson' | 'agreement' | 'externalVerification', required — Type of missing requirement
        - `name` string, required — Name of the missing requirement
        - `status` 'missing' | 'countExceeded' | 'submitted' | 'inReview' | 'verified', required — Current status of the missing requirement
      - `documents` Document[] — Documents associated with the associated person
        - `id` string, required — Internal ID for the document association
        - `documentId` string, required — External document service ID
        - `documentType` 'governmentId' | 'commercialRegister' | 'articlesOfAssociation' | 'certificateOfIncorporation' | 'certificateOfGoodStanding' | 'certificateOfTrust' | 'certificateOfIncumbency' | 'certificateOfIncumbencyOrShareRegister' | 'proofOfPrincipalPlaceOfBusiness' | 'activeTradeLicense' | 'resolutionToOpenBitgoUaeAccount' | 'resolutionToOpenBitgoSingaporeAccount' | 'proofOfAuthorizedSignatories' | 'memorandumOfAssociation' | 'memorandumAndArticlesOfAssociation' | 'bylawsOrOperatingAgreement' | 'operatingAgreement' | 'w8' | 'w9' | 'evidenceOfLegalStatus' | 'evidenceOfActiveStatus' | 'proofOfJfsaLicense' | 'proofOfGamingLicense' | 'organizationDocument' | 'partnershipAgreement' | 'articlesOfOrganization' | 'businessLicenseOrRegistration' | 'evidenceOfGovernmentOrStateOwnership' | 'secFilingsAsEvidenceOfPublicTradingStatus' | 'foundingTreatyOrEquivalent' | 'proofOfAddress' | 'sourceOfWealth' | 'singaporeSupportingDocument' | 'caseRequiredDocuments' | 'correspondentAccountCertification' | 'authorizedSignerForm', required — Type of document being uploaded
        - `status` 'missing' | 'countExceeded' | 'submitted' | 'inReview' | 'verified', required — Verification status
    - `id` string, required — The unique ID of the created identity
    - `ignoredFields` string[] — Ignored fields
    - `requestedProducts` RequestedProductResponse[], required — List of products requested for this identity
      - `id` string, required — Unique identifier for the requested permission
      - `name` 'Instant Fee Wallets' | 'Go Account' | 'ACH Debits' | 'Settlement' | 'Tax' | 'Trade API' | 'Margin Trading' | 'Elliptic' | 'CryptoCompare' | 'MetaMask' | 'Custody' | 'Borrowing' | 'Lending' | 'DeFi' | 'Cold Self-Custody' | 'Go Network' | 'Staking' | 'Trade' | 'Hot Self-Custody' | 'Escrow' | 'Escrow - Triparty' | 'Distributed Custody' | 'Link', required — Name of the BitGo product
      - `bitgoOrg` 'BitGo Trust' | 'BitGo New York' | 'BitGo Germany' | 'BitGo Switzerland' | 'BitGo Europe ApS' | 'Frankfurt DE Trust' | 'BitGo Singapore' | 'BitGo Korea' | 'BitGo Mena Fze' | 'BitGo Custody MENA FZE' | 'BitGo India' | 'BitGo Sister Trust 1' | 'BitGo Inc', required — The BitGo entity identifier
      - `country` unknown
      - `subdivision` string — The subdivision where the permission is being requested
      - `status` 'missingLocation' | 'missingEntityStructure' | 'missingRequirements' | 'readyForSubmission' | 'inReview' | 'approved' | 'rejected', required — Status of the requested permission
    - `requirements` Requirement[], required — List of requirements related to the identity
      - `id` string, required — Unique identifier for the requirement
      - `kind` 'businessInformation' | 'data' | 'document' | 'associatedPerson' | 'agreement' | 'externalVerification', required — Type of requirement
      - `name` string, required — Name of the requirement
      - `status` 'missing' | 'countExceeded' | 'submitted' | 'inReview' | 'verified', required — Current status of the requirement
      - `minRequired` number — Minimum number required (for associated persons)
      - `maxAllowed` number — Maximum number allowed (for associated persons)
    - `documents` Document[] — List of documents associated with the identity
      - `id` string, required — Internal ID for the document association
      - `documentId` string, required — External document service ID
      - `documentType` 'governmentId' | 'commercialRegister' | 'articlesOfAssociation' | 'certificateOfIncorporation' | 'certificateOfGoodStanding' | 'certificateOfTrust' | 'certificateOfIncumbency' | 'certificateOfIncumbencyOrShareRegister' | 'proofOfPrincipalPlaceOfBusiness' | 'activeTradeLicense' | 'resolutionToOpenBitgoUaeAccount' | 'resolutionToOpenBitgoSingaporeAccount' | 'proofOfAuthorizedSignatories' | 'memorandumOfAssociation' | 'memorandumAndArticlesOfAssociation' | 'bylawsOrOperatingAgreement' | 'operatingAgreement' | 'w8' | 'w9' | 'evidenceOfLegalStatus' | 'evidenceOfActiveStatus' | 'proofOfJfsaLicense' | 'proofOfGamingLicense' | 'organizationDocument' | 'partnershipAgreement' | 'articlesOfOrganization' | 'businessLicenseOrRegistration' | 'evidenceOfGovernmentOrStateOwnership' | 'secFilingsAsEvidenceOfPublicTradingStatus' | 'foundingTreatyOrEquivalent' | 'proofOfAddress' | 'sourceOfWealth' | 'singaporeSupportingDocument' | 'caseRequiredDocuments' | 'correspondentAccountCertification' | 'authorizedSignerForm', required — Type of document being uploaded
      - `status` 'missing' | 'countExceeded' | 'submitted' | 'inReview' | 'verified', required — Verification status
    - `externalVerifications` ExternalVerification[] — External verifications (e.g. Persona) for this identity
      - `id` string, required — Internal ID of the external verification
      - `provider` string, required — Provider (e.g. persona, singpass)
      - `resourceId` string — Provider resource ID (absent for pending rows)
      - `resourceLink` string — Link to the verification session
      - `status` 'pending' | 'inProgress' | 'completed' | 'failed', required — Verification status
      - `lastUpdated` string, date-time, required — Timestamp when the verification was last updated
    - `finalizeSubmission` boolean, required — Whether identity is ready for final submission and requirements validation

## Other responses

- `400` — 400
- `401` — 401
- `500` — 500

---

[API](https://skmtc.net/bitgo/apis/bitgo-api.md) · [All operations](https://skmtc.net/bitgo/apis/bitgo-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/bitgo/bitgo-api/revisions/e445c15e5bee/schema)