A linked business represents your end-user of type business who can be onboarded on the Merge platform. The KYB information of the Linked Business is checked and verified. After successful verification, you can open a bank account in the name of the linked business i.e. Ice Venture Limited. This linked business account can hold fund balance, accept deposits and issue payouts to registered beneficiaries.
id string
The unique identifier (UUID) of the linked business.
Example: 046f2c61-08f8-4717-81ed-cc8f15b73f2b
company_id string
The unique identifier (UUID) of the company to which the linked business is associated.
Example: 20e0c33b-e122-4ce2-b279-c21b992c21bf
registration_number string
The company registration number (e.g., Companies House number for UK companies).
Example: 12345678
created_at timestamp
The ISO 8601 timestamp at which the linked business was created.
Example: 2023-07-18T12:08:53.107162+00:00
updated_at timestamp
The ISO 8601 timestamp at which the linked business was last updated.
Example: 2023-07-18T12:08:56.170265+00:00
alias_id string
This unique identifier is of shorter length and could be used to raise customer support queries.
Example: MLB168968213310
client_status string
The status of the linked business.
Possible values: IN-REVIEW, ON-HOLD, ACTIVE, INACTIVE, SUSPENDED, or CLOSED
client_kyb_status string
The KYB (Know Your Business) verification status of the linked business.
Possible values: PENDING, INITIATED, ON-HOLD, INVALID_DATA, VERIFIED, REJECTED, or CLIENT_VERIFIED
type string
The type of linked member.
Value: business
legal_name string
The legal name of the business as registered with the relevant authority.
Example: ACME Inc.
trading_address object
The trading address where the business operates.
line1 string
The first line of the business's trading address.
Example: 215 Bell Yard
line2 string
The second line of the business's trading address (optional).
Example: Suite 100
city string
The city or town of the business's trading address.
Example: London
state string
The state or region of the business's trading address (optional).
Example: Greater London
postcode string
The postal code of the business's trading address.
Example: WC2A 2JR
country string
The country of the business's trading address in the two-letter ISO 3166-1 format.
Example: GB
registered_address object
The registered address of the business as filed with the relevant authority.
line1 string
The first line of the business's registered address.
Example: 215 Bell Yard
line2 string
The second line of the business's registered address (optional).
Example: Suite 100
city string
The city or town of the business's registered address.
Example: London
state string
The state or region of the business's registered address (optional).
Example: Greater London
postcode string
The postal code of the business's registered address.
Example: WC2A 2JR
country string
The country of the business's registered address in the two-letter ISO 3166-1 format.
Example: GB
contact_details object
Contact information for the business.
email string
The business's contact email address.
Example: [email protected]
phone_number string
The business's contact phone number.
Example: +441234567890
website string
The business's website URL.
Example: https://www.acme.com
operational_details object
Operational and risk assessment details for the business.
industry_code string
The Merge MCC (Merchant Category Code) representing the business's industry.
Example: 5411
Possible values: 1799 (Special Trade Contractors), 3048 (Royal Air Maroc), 3136 (Qatar Airways), 4511 (Airlines, Air Carriers),
4789 (Transportation Services), 4812 (Telecommunications Equipment and Telephones Sales), 4829 (Wire Transfer), 4900 (Utilities - Electric, Gas, Water, and
Sanitary), 5045 (Computers and Computer Peripheral Equipment and Software), 5065 (Electrical Parts and Equipment), 5099 (Durable Goods), 5199 (Nondurable
Goods), 5262 (Marketplaces), 5999 (Miscellaneous and Specialty Retail Stores), 6012 (Financial Institutions), 6051 (Cryptocurrency Assets), 6211
(Security Brokers/Dealers), 6513 (Real Estate Agents and Managers), 7011 (Lodging – Hotels, Motels, Resorts), 7299 (Personal Services), 7372 (Computer
Programming, Data Processing, and Integrated Systems Design Services), 7399 (Business Services), 7512 (Car Rental Agencies), 7999 (Recreation Services), 8011
(Doctors and Physicians), 8299 (Schools and Educational Services), 8999 (Professional Services), 9311 (Tax payments), 9399 (Government Services)
computed_risk_level enum
The computed risk level for the business based on AML and fraud checks.
Possible values: LOW, MEDIUM, or HIGH
max_transaction_value string
The maximum expected transaction value. For AML check and fraud monitoring, it is recommended to provide accurate values.
Example: 10000.00
expected_monthly_spend string
The expected monthly spend amount. For AML check and fraud monitoring, it is recommended to provide accurate values.
Example: 1000000.00
expected_monthly_volume string
The expected monthly transaction volume. For AML check and fraud monitoring, it is recommended to provide accurate values.
Example: 100000
verification_model enum
The verification model used for KYB checks.
Possible values: PRM_BUSINESS
entity_verified_successfuly boolean
Indicates whether the entity has been successfully verified (optional).
Example: true
associates_details array of objects
List of associates related to the business (directors, UBOs, partners, trustees). At least one Director/Partner/Trustee and one UBO required.
personal_details object
Personal information of the associate.
first_name string
The first name of the associate.
Example: John
last_name string
The last name of the associate.
Example: Doe
date_of_birth date
The date of birth of the associate in YYYY-MM-DD format.
Example: 1990-01-01
nationality string
The nationality of the associate in the two-letter ISO 3166-1 format.
Example: GB
associate_contact object
Contact information for the associate (optional, but at least one Director/Partner/Trustee must provide email & phone).
email string
The email address of the associate.
Example: [email protected]
phone_number string
The phone number of the associate.
Example: +441234567890
address object
The residential address of the associate.
line1 string
The first line of the associate's address.
Example: 456 Oak Avenue
line2 string
The second line of the associate's address (optional).
Example: Apt 5B
city string
The city or town of the associate's address.
Example: London
state string
The state or region of the associate's address (optional).
Example: Greater London
postcode string
The postal code of the associate's address.
Example: SW1A 1AA
country string
The country of the associate's address in the two-letter ISO 3166-1 format.
Example: GB
additional_details object
Additional information about the associate's role and ownership.
associate_type enum
The type or role of the associate in the business.
Possible values: Director, UBO, Partner, or Trustee
is_ubo boolean
Indicates whether the associate is a UBO (Ultimate Beneficial Owner). Required if Partner/Director/Trustee is UBO, or if type is UBO.
Example: true
share_holding_control_percentage string
The percentage of shareholding control (optional, provide when >= 10%).
Example: 25.00
company_type enum
The type of company entity.
Possible values: LLC (Limited Liability Company), PLC (Publicly Listed Company), LLP (Limited Liability Partnership), SOLETRADER (Sole Trader), OPARTNRSHP (Ordinary Partnership), LPARTNRSHP (Limited Partnership), CHARITY (Charity), INDIVIDUAL (Individual Consumer), PCM_INDIVIDUAL (Partner Clearing Model Individual Consumer), PCM_BUSINESS (Partner Clearing Model Business Consumer), TRUST (Trust Customer), or PREQUALIFIED (Prequalified Customer)
Note: At creation, only LLC, PLC, and LLP are allowed
company_type_specification enum
Additional specification for the company type (optional).
Possible values: LIABILITY or OWNERSHIP
incorporation_date date
The date of incorporation in YYYY-MM-DD format (optional).
Example: 1990-01-01
external_ref_id string
Reference identifier of the linked business provided by the company (optional).
Example: EXT-REF-12345
main_account_id string
The unique identifier (UUID) of the client's main account to use for this linked business.
Example: a1b2c3d4-e5f6-7890-abcd-ef1234567890
application_number string
The application number associated with the linked business (optional).
client_reference string
Client reference identifier (optional).
client_nonce string
Client-provided nonce for idempotency to prevent duplicate submissions (optional).
Example: nonce-abc-123