Skip to main content
POST
Create a corporate application for a company

Authorizations

Api-Key
string
header
required

Body

application/json

Application information for this company

initialUser
object
required

The initial user of the company - they must have a wallet address, and their wallet address will be an owner on the company's Rain smart contract

name
string
required

The name of the company looking to create an account

address
object
required

The company's physical address

entity
object
required

The company's legal entity

representatives
object[]
required

The company's representatives

ultimateBeneficialOwners
object[]
required

The company's ultimate beneficial owners

chainId
string

If using external collateral contracts, the chain id of the company's external collateral contract; not required if using Rain's collateral contracts

contractAddress
string

If using external collateral contracts, the address of the company's external collateral contract; not required if using Rain's collateral contracts

Pattern: ^(0x[0-9a-fA-F]{40}|[1-9A-HJ-NP-Za-km-z]{32,44})$
sourceKey
string

Unique identifier for where this user is coming from

Required string length: 1 - 24
externalId
string

An optional tenant-defined identifier for this company. Must be unique within the tenant.

Required string length: 1 - 255

Response

Successful operation

id
string<uuid>
required

The company's unique identifier

name
string
required

The company's name on the Rain platform

address
object
required

The company's physical address

applicationStatus
enum<string>
required
Available options:
approved,
pending,
needsInformation,
needsVerification,
manualReview,
denied,
locked,
canceled
externalId
string

An optional tenant-defined identifier for this company. Must be unique within the tenant.

Required string length: 1 - 255
sourceKey
string

The source key associated with the company's team

Required string length: 1 - 24
ultimateBeneficialOwners
object[]

The company's ultimate beneficial owners

The link to the external verification page for the application

The link to the completion page for the application

applicationReason
string

The reason for the application status