List enterprises for an organization

get/api/v2/organization/{organizationId}/enterprise

List all enterprises in the specified organization.

Path Parameters

  • organizationIdstringRequired
    Example: "59cd72485007a239fb00282ed480da1f"
    Pattern: ^[0-9a-f]{32}$

Query Parameters

  • idempotencyKeystring
    A unique identifier used when creating the enterprise. Adding this query parameter will return the enterprise created with the given idempotency key.
  • limitstring<number>Default: 25
    Maximum number of results to return. If the result set is truncated, use the "nextBatchPrevId" value to get the next batch.
    Minimum: >= 1
    Maximum: <= 500
  • prevIdstring
    Return the next batch of results, based on the "nextBatchPrevId" value from the previous batch.
    Example: "59cd72485007a239fb00282ed480da1f"
    Pattern: ^[0-9a-f]{32}$
    Min length: >= 1 characters

200 Response

enterprisesrequired
id string required
Example: 59cd72485007a239fb00282ed480da1f
Match pattern: ^[0-9a-f]{32}$
name string required
Example: Small Company
additionalEnterpriseInfo object required
bitgoOrg string required
BitGo Organization related to this entity
Allowed values: BitGo Trust BitGo New York BitGo Germany BitGo Switzerland Frankfurt DE Trust BitGo Singapore BitGo Sister Trust 1 BitGo Inc
kycState string required
Allowed values: unverified approved rejected pending
legalIdentifiers object required
type string required
latestSAVersionSigned number required
Example: 0
travelRule boolean required
productLicenses array[string] required
canAccessBorrowing boolean required
whether the enterprise has the licence for BitGo Prime Borrowing
canAccessLending boolean required
whether the enterprise has the licence for BitGo Prime Lending
canAccessSettlement boolean required
whether the enterprise has the licence to utilize settlement functionality
canAccessTrading boolean required
whether the enterprise has the licence to access BitGo Trading
canCreateColdWallet boolean required
whether the enterprise has the license to create cold wallets
canCreateHotWallet boolean required
whether the enterprise has the license to create hot wallets
canCreateCustodialWallet boolean required
whether the enterprise has the license to create custodial wallets
canCreateOffchainWallet boolean required
whether the enterprise has the license to create trading accounts
oneTimeFees array[string] required
upfrontPaymentStatus string required
ethAlwaysUseHop boolean required
Always use hop address for ETH transactions
usersViewAllWallets boolean required
All users on the enterprise can view all enterprise wallets, even if they are not viewers on the wallet itself
Example: true
videoIdWaived boolean required
Whether the customer has waived the need for Video ID on low risk withdrawals.
Example: false
accountType string
Indicates which type of KYC process the enterprise has to complete
Allowed values: individual entity
businessModel string
Allowed value: bitgoAsAService
salesforceAccountId string
Opportunity ID from Salesforce
salesforceOpportunityId string
salesEmail string
cheetahAccountId string
CheetahAccountID is the unique ID for a BitGo Trust enterprise in Cheetah, which is the accounting system used by Trust.
primaryContact string
The Id of the User who is the primary contact
Min length: >= 1 characters
Example: 59cd72485007a239fb00282ed480da1f
Match pattern: ^[0-9a-f]{32}$
organizationId string
Example: 59cd72485007a239fb00282ed480da1f
Match pattern: ^[0-9a-f]{32}$
emergencyPhone string
Phone number for emergencies
Example: +11234567890
pricingPlan string
The pricing plan of the enterprise
approvalsRequired number
How many Enterprise Admins are required for action to fire
Example: 1
mutablePolicyWindow number
Time in seconds after which policies on this Enterprise cannot be updated
Example: 172800
freeze object
bitgoEthKey string
The public portion of the ethererum key generated for the enterprise fee address
ethFeeAddress string
The eth fee address used to pay for network transaction fees of this enterprise
walletLimit object
preferredUi string
The UI that this enterprise prefers to use
Allowed values: bg23
custodialWalletLimit
object or null
featureFlags array[string]
labels array[string]
licenses array[string]
New licences that are not stored as flags. Tax requires Portfolio Professional or Institutional
ellipticId string
Identifier for environment variables for a customer's Elliptic API credentials
ellipticHotWallets boolean
Hot wallet transactions on this enterprise are monitored in Elliptic
vaspId string
coinSpecific object
walletCounts object
Number of wallets per coin
activePricingType
object or null
source string
Allowed values: bitcoinBuilder ftx sofi
totalWalletsCount number
The total number of wallets in the enterprise
Example: 1
internal object
distributedCustody object
migratedToNewPolicyService boolean
Whether the enterprise has been migrated to the new policy service
videoIdUsers array[object]
3 IDs of users on the enterprise that are approved for custodial video ID
videoIdRequired boolean
Check for video ID Users
nextBatchPrevId string
When a result set is truncated, this field returns the id of the last object in the previous batch. To get the next batch of results, pass this value via the 'prevId' query parameter.
Min length: >= 1 characters

400 Response

name string
Error code
context object required
Properties that apply to a specific error name
error string required
Human-readable error message
requestId string required
Client request id

403 Response

name string
Error code
context object required
Properties that apply to a specific error name
error string required
Human-readable error message
requestId string required
Client request id

404 Response

name string
Error code
context object required
Properties that apply to a specific error name
error string required
Human-readable error message
requestId string required
Client request id

409 Response

name string
Error code
context object required
Properties that apply to a specific error name
error string required
Human-readable error message
requestId string required
Client request id

500 Response

name string
Error code
context object required
Properties that apply to a specific error name
error string required
Human-readable error message
requestId string required
Client request id