REST APIIdentityKnow Your Business (KYB)

DEL

Remove an associated person from a business identity by associated person ID. The identity must not be in review.

Path Params

  • identityId string uuid required
    Business identity ID
  • associatedPersonId string uuid required
    Associated person row ID to remove

Responses

200
200

Response Body

ONE OF

  • type string enum required
    Type of identity
    individual
  • userId string required
    The ID of the user
  • individual object required
    individual object
    • nameFirst string
      First name of the individual

      matches ^[A-Za-zÀ-ÿĀ-ſƀ-ɏ\s'\.\-]+$

    • nameLast string
      Last name of the individual

      matches ^[A-Za-zÀ-ÿĀ-ſƀ-ɏ\s'\.\-]+$

    • birthdate object
      Birthdate
      birthdate object
      • month string required
        birthdate month (MM, e.g. "06")

        matches ^\d{2}$

      • day string required
        birthdate day (DD, e.g. "15")

        matches ^\d{2}$

      • year string required
        birthdate year (YYYY, e.g. "1990")

        matches ^\d{4}$

    • phoneNumber object
      phoneNumber object
      • countryCode string required
        Country code of the phone number

        matches ^[0-9]+$

      • phoneNumber string required
        Phone number (without country code)

        matches ^[0-9]+$

    • email string email
      Email address of the individual
    • occupation string enum
      Occupation category. Use OccupationEnum values.
      AgricultureArt Dealer / Auctioneer / Import / Export CompanyFinancial Services (Asset Mgmt., Bank, Broker Dealer, Commodities, Mutual Fund, Ins. Co)Casinos and Gambling EstablishmentsCharity/NGO/Non-Profit/Foundation/EndowmentComputer Programmer / Administrator / Software Engineer / IT or Software / Technology CompanyCrypto Services (ATM, Exchange, Lender, Coins/Token)Education / TeacherExtractive Industry (Oil, Gas, etc.) / Jewels / Gemstones / Precious MetalsFamily OfficeFilm / TV / Entertainment (not adult)Government/State owned/Political Org. (i.e. Sovereign Wealth Fund)HealthcareLaw Enforcement / Military / Protective ServicesMiner / Mining PoolMoney Service BusinessOtherPrivate Equity / Venture CapitalProfessional Service Providers (lawyers accountants etc.)Real estate brokers developers and appraisersRecreation / HospitalityStudent / Unemployed / RetiredTraders / Trading (High Frequency, Proprietary, Market Maker)Weapons Dealers
    • countryOfCitizenship object
      Country of citizenship (ISO 3166-1 alpha-3)
    • countryOfResidence object
      Country of residence (ISO 3166-1 alpha-3)
    • govIdCountryOfIssuance object
      Country where government ID was issued (ISO 3166-1 alpha-3)
    • govIdClass string enum
      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
      cctciddlfoidhicidippkeypltpassmunidmynnbinricofwrppanpidppppcprssstdtribalidumidvidvisawpcomputerizedPayslipsincomeTaxAssessmentemploymentLetterContractbankStatementdptHoldingStatementinvestmentHoldingsStatementtitleDeedspropertyTaxCpfStatementother
    • address object
      address object
      • street1 string required
        Street address line 1

        matches ^[A-Za-zÀ-ÿĀ-ſƀ-ɏ0-9\s'\-\.,#\/( )&]+$

      • street2 string
        Street address line 2

        matches ^[A-Za-zÀ-ÿĀ-ſƀ-ɏ0-9\s'\-\.,#\/( )&]+$

      • city string required
        City name

        matches ^[A-Za-zÀ-ÿĀ-ſƀ-ɏ0-9\s'\-\.,#\/( )&]+$

      • subdivision string
        State, province, or region (formatted as subdivision section of ISO 3166-2, excludes country code)

        1 to 3 characters

      • zip string required
        ZIP or postal code
      • country object required
        Country (formatted as ISO 3166-1 alpha-3)
    • identificationNumber string
      National identification number (e.g., SSN, passport number)
    • politicallyExposedPerson boolean
      Whether the individual is a politically exposed person
    • multipleCitizenship array of strings
      Additional citizenships beyond primary (ISO 3166-1 alpha-3 codes)
    • sourceOfFundOrigin string
      Origin of funds to be deposited (e.g., employment, savings)

      up to 500 characters

    • sourceOfFundOriginOfTransfer string
      Specific transfer origin: bank name for fiat, platform/wallet name for digital assets

      up to 500 characters

    • occupationDetails string
      Free-text occupation description (required when occupation is self-employed or other)

      up to 500 characters

    • employerName string
      Name of employer

      up to 200 characters · matches ^[A-Za-zÀ-ÿĀ-ſƀ-ɏ\s'\.\-]+$

    • jobTitle string
      Job title

      up to 200 characters · matches ^[A-Za-zÀ-ÿĀ-ſƀ-ɏ\s'\.\-]+$

    • annualIncome string enum
      Annual income bracket in SGD
      Under $50,000$50,001 - $100,000$100,001 - $300,000$300,001 - $500,000$500,001 and over
    • accountOpeningPurpose string
      Purpose of opening a BitGo Singapore account

      up to 500 characters

    • sourceOfWealth string enum
      Source of wealth category (required for high-CRR individuals)
      employmentIncomeinheritancesaleOfBusinessOrPropertyother
    • sourceOfWealthDetails string
      Free-text source of wealth details (required when sourceOfWealth is "other")

      up to 500 characters

    • netWorth string enum
      Net worth bracket in SGD (required for high-CRR individuals)
      Under $100,000$100,001 - $500,000$500,001 - $1,000,000$1,000,001 - $5,000,000$5,000,001 and over
    • digitalAssetWalletAddress string
      Digital asset wallet address (required for high-CRR when source of wealth involves digital assets). Format varies by chain; validated downstream.

      up to 200 characters

    • accreditedInvestorOptedIn boolean
      Whether the individual has opted in as an Accredited Investor under MAS
    • accreditedInvestorQualifyingCriteria string enum
      Qualifying criteria for AI status (required when accreditedInvestorOptedIn is true)
      incomenetAssetsfinancialAssets
    • 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)

      up to 200 characters

  • id string required
    The unique ID of the created identity
  • ignoredFields array of strings
    Ignored fields
  • requestedProducts array of objects required
    List of products requested for this identity
    requestedProducts object
    • id string required
      Unique identifier for the requested permission
    • name string enum required
      Name of the BitGo product
      Instant Fee WalletsGo AccountACH DebitsSettlementTaxTrade APIMargin TradingEllipticCryptoCompareMetaMaskCustodyBorrowingLendingDeFiCold Self-CustodyGo NetworkStakingTradeHot Self-CustodyEscrowEscrow - TripartyDistributed CustodyLink
    • bitgoOrg string enum required
      The BitGo entity identifier
      BitGo TrustBitGo New YorkBitGo GermanyBitGo SwitzerlandBitGo Europe ApSFrankfurt DE TrustBitGo SingaporeBitGo KoreaBitGo Mena FzeBitGo Custody MENA FZEBitGo IndiaBitGo Sister Trust 1BitGo Inc
    • country object
      The country where the permission is being requested
    • subdivision string
      The subdivision where the permission is being requested

      1 to 3 characters

    • status string enum required
      Status of the requested permission
      missingLocationmissingEntityStructuremissingRequirementsreadyForSubmissioninReviewapprovedrejected
  • requirements array of objects required
    List of requirements related to the identity
    requirements object
    • id string required
      Unique identifier for the requirement
    • kind string enum required
      Type of requirement
      businessInformationdatadocumentassociatedPersonagreementexternalVerification
    • name string required
      Name of the requirement
    • status string enum required
      Current status of the requirement
      missingcountExceededsubmittedinReviewverified
    • minRequired number
      Minimum number required (for associated persons)
    • maxAllowed number
      Maximum number allowed (for associated persons)
  • documents array of objects
    List of documents associated with the identity
    documents object
    • id string required
      Internal ID for the document association
    • documentId string required
      External document service ID
    • documentType string enum required
      Type of document being uploaded
      governmentIdcommercialRegisterarticlesOfAssociationcertificateOfIncorporationcertificateOfGoodStandingcertificateOfTrustcertificateOfIncumbencycertificateOfIncumbencyOrShareRegisterproofOfPrincipalPlaceOfBusinessactiveTradeLicenseresolutionToOpenBitgoUaeAccountresolutionToOpenBitgoSingaporeAccountproofOfAuthorizedSignatoriesmemorandumOfAssociationmemorandumAndArticlesOfAssociationbylawsOrOperatingAgreementoperatingAgreementw8w9evidenceOfLegalStatusevidenceOfActiveStatusproofOfJfsaLicenseproofOfGamingLicenseorganizationDocumentpartnershipAgreementarticlesOfOrganizationbusinessLicenseOrRegistrationevidenceOfGovernmentOrStateOwnershipsecFilingsAsEvidenceOfPublicTradingStatusfoundingTreatyOrEquivalentproofOfAddresssourceOfWealthsingaporeSupportingDocumentcaseRequiredDocumentscorrespondentAccountCertificationauthorizedSignerForm
    • status string enum required
      Verification status
      missingcountExceededsubmittedinReviewverified
  • externalVerifications array of objects
    External verifications (e.g. Persona) for this identity
    externalVerifications object
    • 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 string enum required
      Verification status
      pendinginProgresscompletedfailed
    • 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
400
400

Response Body

object

  • error string required
    Description of the error
  • details array of strings
401
401

Response Body

object

  • error string required
    Description of the error
  • details array of strings
404
404

Response Body

object

  • error string required
    Description of the error
  • details array of strings
500
500

Response Body

object

  • error string required
    Description of the error
  • details array of strings