Create new customer

post

https://api.sandbox.keyrails.com/api/v1/customers

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Body Params

Create Customer Model

businessLegalName

string

required

length ≥ 1

businessTradeName

string

required

length ≥ 1

taxIdentificationNumber

string

required

length ≥ 1

website

string

required

length ≥ 1

incorporationDate

date-time

required

length ≥ 1

Date format YYYY-MM-DD

countryOfIncorporation

string

enum

required

length ≥ 1

Two-letter alpha-2 country code

companyRegistrationNumber

string

required

length ≥ 1

registeredAddress

object

required

Address

operationalAddress

object

required

Address

contactPerson

object

required

businessIndustries

array of strings | null

required

The industry in which this business operates. Click here for the complete list of valid industries based on the industry type.

businessIndustries*

withLivenessCheck

boolean

required

If set to TRUE, add associated person API will return a verification URL. The customer must use this URL to complete the liveness check.

If set to FALSE, then identityDocumentFront must be provided when adding an associated persons.
directorsLivenessCheck and shareHoldersLivenessCheck must be provided when uploading documents.

businessModel

string | null

required

termsOfServiceAcceptance

object

required

customerJurisdictions

array of strings

required

length ≥ 1

Geographic locations of your counterparties.
Two-letter alpha-2 country code - See the list of supported countries https://docs.keyrails.com/reference/get_api-v1-lists-countries

customerJurisdictions*

accountPurpose

string

required

length ≥ 1

string

required

length ≥ 1

externalWalletAddress

string | null

externalWalletOwnershipProof

string | null

Base64 encoded following the data-uri scheme i.e. data:image/[type];base64,[base_64_encoded_file_contents]

Valid file types: .pdf, .jpeg, .jpg, .png

transactionOriginCountries

array of strings

required

length ≥ 1

Two-letter alpha-2 country code - See the list of supported countries https://docs.keyrails.com/reference/get_api-v1-lists-countries

transactionOriginCountries*

transactionDestinationCountries

array of strings

required

length ≥ 1

Two-letter alpha-2 country code - See the list of supported countries https://docs.keyrails.com/reference/get_api-v1-lists-countries

transactionDestinationCountries*

transactionBreakdown

object

naicsCode

string | null

required

Six-digit NAICS code for the company's primary activity.
See https://docs.keyrails.com/docs/naics-codes for the allowed values.

companySourceOfWealth

string | null

enum

required

Primary source of wealth of the company and its beneficial owners.

companySourceOfWealthOther

string | null

Required when companySourceOfWealth=Other.

accountFundingSource

string | null

enum

required

Primary source of funds that will be used to fund the account.

accountFundingSourceOther

string | null

Required when accountFundingSource=Other.

Headers

content-type

string

enum

Defaults to application/json

Generated from available request content types

Allowed:

Responses

200CreateCustomerResponseModel

400Bad Request

401Unauthorized

404Not Found