Create borderless™ child account

post

https://prod.api.getborderless.com/accounts

Introduction

This endpoint is used to create an account via the borderless™ API. This is a POST request that takes in body parameters noted below. These vary per country so please use the required information endpoint to confirm what data is required for your specific Account's country.

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Body Params

string

required

The email address of the child account holder.

emailVerified

boolean

required

This field identifies if email of child account is verified. Must be true for successful account creation.

acceptTermsAndConditions

boolean

required

This field identifies that account owner accepts terms and conditions of borderless™. Must be true for successful account creation.

accountType

string

enum

required

Child account account type.

Allowed:

country

string

enum

required

The two letter ISO code for the child account country (must match with the bank account you will add).

currency

string

enum

required

The primary three letter currency code of the account (must match with your bank account currency).

firstName

string

required

First name of the child account owner (must match with the bank account you will add).

middleName

string

Middle name of the child account owner.

lastName

string

required

Last name of the child account owner (must match with the bank account you will add).

phoneNumber

number

Phone number of child account owner. Phone number format must contain only numbers and must be submitted without country code. For example if phone number for United States account is +1 (123)-456-7890 you should submit 1234567890. Check requirements according country and account type to confirm if this field is required.

dateOfBirth

string

required

Date of birth of child account owner. The format of this field should be YYYY-MM-DD.

handle

string

The unique identifier for account. You can specify your own or it will be generated automatically and provided for you in response of successful account creation.

addressLine1

string

required

The address of the child account.

addressLine2

string

The address of the child account.

city

string

required

The city of the child account.

zoneCode

string

required

Zone codes for your desired country.

postalCode

string

required

Postal code of the address. If country does not have postal codes system, simply submit 00000.

placeOfBirthCountry

string

enum

The two letter ISO code of place of birth.

placeOfBirthRegion

string

The zone code of place of birth country. This field is required for few of the countries.

personalTaxId

string

A taxpayer identification number.

businessName

string

The name of the business. For BUSINESS type account this field is required.

displayName

string

The display name that will be shown on borderless™ dashboard. If not specified display name will be auto-generated according business name for BUSINESS accounts and according first and last names for PERSONAL accounts.

jobTitle

string

A formal name for a specific position within an organization.

businessType

string

Type of the business. To retrieve all possible business types for specific country please visit Reference Section.

businessTaxId

string

A corporate tax identification number. For BUSINESS type account this field is required.

industry

string

The industry of the business. For BUSINESS type account this field is required. To retrieve all possible business industries for this field please visit Reference Section.

businessSize

number

Non-negative number of aproximate number of employees.

estimatedMonthlyVolume

number

Non-negative number of aproximate monthly volume.

estimatedMonthlyTransactions

number

Non-negative number of aproximate monthly transactions.

bankDataRequired

object

required

Headers

Client-Id

string

Unique identifier of Child Account (required only for Partner).

Responses

404

Server Error

200Success

400Error

401Authentication Error