Create business customer

curl --request POST \ --url http://localhost:4000/v1/payout/rails/business-customers \ --header 'Content-Type: application/json' \ --data ' { "type": "business", "business_legal_name": "Acme Corporation LLC", "email": "[email protected]", "business_type": "llc", "business_description": "A fintech company providing cross-border payment solutions for Latin American merchants.", "registered_address": { "street_line_1": "123 Main St", "city": "San Francisco", "country": "USA", "street_line_2": "Suite 200", "subdivision": "CA", "postal_code": "94102" }, "physical_address": { "street_line_1": "123 Main St", "city": "San Francisco", "country": "USA", "street_line_2": "Suite 200", "subdivision": "CA", "postal_code": "94102" }, "associated_persons": [ { "first_name": "John", "last_name": "Doe", "email": "[email protected]", "residential_address": { "street_line_1": "123 Main St", "city": "San Francisco", "country": "USA", "street_line_2": "Suite 200", "subdivision": "CA", "postal_code": "94102" }, "birth_date": "1990-01-15", "has_ownership": true, "has_control": true, "is_signer": true, "identifying_information": [ { "type": "ssn", "issuing_country": "USA", "number": "123-45-6789", "description": "<string>", "expiration": "2030-12-31", "image_front": "<string>", "image_back": "<string>" } ], "middle_name": "Michael", "transliterated_first_name": "<string>", "transliterated_middle_name": "<string>", "transliterated_last_name": "<string>", "phone": "+12223334444", "transliterated_residential_address": { "street_line_1": "123 Main St", "city": "San Francisco", "country": "USA", "street_line_2": "Suite 200", "subdivision": "CA", "postal_code": "94102" }, "is_director": false, "title": "CEO", "ownership_percentage": 75, "attested_ownership_structure_at": "2024-06-15", "relationship_established_at": "2020-01-01", "verified_govid_at": "<string>", "verified_selfie_at": "<string>", "completed_customer_safety_check_at": "<string>", "documents": [ { "purpose": "proof_of_address", "image_front": "<string>", "image_back": "<string>" } ] } ], "signed_agreement_id": "sa_abc123def456", "business_trade_name": "Acme", "transliterated_business_legal_name": "<string>", "transliterated_business_trade_name": "<string>", "primary_website": "https://acme.com", "other_websites": [ "https://twitter.com/acme", "https://linkedin.com/company/acme" ], "is_dao": false, "transliterated_registered_address": { "street_line_1": "123 Main St", "city": "San Francisco", "country": "USA", "street_line_2": "Suite 200", "subdivision": "CA", "postal_code": "94102" }, "transliterated_physical_address": { "street_line_1": "123 Main St", "city": "San Francisco", "country": "USA", "street_line_2": "Suite 200", "subdivision": "CA", "postal_code": "94102" }, "endorsements": [ "base", "spei" ], "business_industry": [ "6199" ], "account_purpose": "receive_payments_for_goods_and_services", "account_purpose_other": "<string>", "source_of_funds": "sales_of_goods_and_services", "source_of_funds_description": "<string>", "estimated_annual_revenue_usd": "1000000_9999999", "expected_monthly_payments_usd": 50000, "conducts_money_services": false, "conducts_money_services_using_bridge": false, "conducts_money_services_description": "<string>", "compliance_screening_explanation": "<string>", "operates_in_prohibited_countries": false, "high_risk_activities": [ "none_of_the_above" ], "high_risk_activities_explanation": "<string>", "acting_as_intermediary": false, "ownership_threshold": 25, "has_material_intermediary_ownership": false } '

{ "success": true, "message": "<string>", "statusCode": 123, "timestamp": "<string>", "data": { "id": "550e8400-e29b-41d4-a716-446655440000", "bridge_customer_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", "type": "business", "email": "[email protected]", "business_legal_name": "Acme Corporation LLC", "status": "incomplete", "capabilities": { "payin_crypto": "pending", "payout_crypto": "pending", "payin_fiat": "pending", "payout_fiat": "pending" }, "requirements_due": [ "id_verification" ], "future_requirements_due": [], "has_accepted_terms_of_service": false, "endorsements": [ { "name": "base", "status": "incomplete", "requirements": { "complete": [ "<string>" ], "pending": [ "<string>" ], "issues": [ "<string>" ], "missing": {} }, "additional_requirements": [ "<string>" ] } ], "rejection_reasons": [ { "developer_reason": "Insufficient documentation provided", "reason": "We were unable to verify your identity", "created_at": "2026-01-15T12:00:00.000Z" } ], "associated_persons": [ { "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", "email": "[email protected]" } ], "created_at": "2026-01-31T12:00:00.000Z" }, "path": "<string>" }

Body

application/json

type

enum<string>

required

Customer type. Must be "business" for this endpoint.

Available options:

business

Example:

"business"

business_legal_name

string

required

The official registered name of the business as documented with government authorities.

Required string length: 1 - 1024

Example:

"Acme Corporation LLC"

string

required

The business's primary contact email address.

Required string length: 1 - 1024

Example:

"[email protected]"

business_type

enum<string>

required

How the business is legally registered.

Available options:

cooperative,

corporation,

llc,

other,

partnership,

sole_prop,

trust

Example:

"llc"

business_description

string

required

A brief summary of what the business does.

Required string length: 1 - 1024

Example:

"A fintech company providing cross-border payment solutions for Latin American merchants."

registered_address

object

required

The official registered address of the business as filed with government authorities.

Show child attributes

physical_address

object

required

The physical address for the primary place of business. Must be a physical address, not a PO Box.

Show child attributes

associated_persons

object[]

required

List of notable people associated with the business: UBOs (Ultimate Beneficial Owners), control persons, and signers. At least one person must be provided. At least one must have is_signer=true and at least one must have has_control=true.

Minimum array length: 1

Show child attributes

signed_agreement_id

string

The ID of the signed agreement that the customer completed. Obtain this by following the Bridge signed agreements guide. Can be provided later via PUT request.

Required string length: 1 - 1024

Example:

"sa_abc123def456"

business_trade_name

string

The trading name or DBA (Doing Business As) under which the business operates publicly.

Required string length: 1 - 1024

Example:

"Acme"

transliterated_business_legal_name

string

Required if business_legal_name includes non-Latin-1 characters. Acceptable: Latin-1 (U+00C0-U+00FF) and standard ASCII range.

Required string length: 1 - 1024

transliterated_business_trade_name

string

Required if business_trade_name includes non-Latin-1 characters.

Required string length: 1 - 1024

primary_website

string

The business's primary website or web presence. A document with purpose "proof_of_nature_of_business" is required if this is not provided.

Required string length: 1 - 1024

Example:

"https://acme.com"

other_websites

string[]

Other websites and social media handles for the business.

Example:

[
  "https://twitter.com/acme",
  "https://linkedin.com/company/acme"
]

is_dao

boolean

Whether the business is a DAO (Decentralized Autonomous Organization).

Example:

false

transliterated_registered_address

object

Required if any part of registered_address includes non-Latin-1 characters.

Show child attributes

transliterated_physical_address

object

Required if any part of physical_address includes non-Latin-1 characters.

Show child attributes

endorsements

enum<string>[]

List of endorsements to request for this customer. If omitted, Bridge will attempt to grant "base" and "sepa" by default.

Available options:

base,

cards,

faster_payments,

pix,

sepa,

spei

Example:

["base", "spei"]

business_industry

string[]

Industry codes for the business. See Bridge docs for the complete list of valid industry codes.

Example:

["6199"]

account_purpose

enum<string>

Primary purpose of the business account.

Available options:

charitable_donations,

ecommerce_retail_payments,

investment_purposes,

other,

payments_to_friends_or_family_abroad,

payroll,

personal_or_living_expenses,

protect_wealth,

purchase_goods_and_services,

receive_payments_for_goods_and_services,

tax_optimization,

third_party_money_transmission,

treasury_management

Example:

"receive_payments_for_goods_and_services"

account_purpose_other

string

Required if account_purpose is "other".

Required string length: 1 - 1024

source_of_funds

enum<string>

Source of funds for the business account.

Available options:

business_loans,

grants,

inter_company_funds,

investment_proceeds,

legal_settlement,

owners_capital,

pension_retirement,

sale_of_assets,

sales_of_goods_and_services,

third_party_funds,

treasury_reserves

Example:

"sales_of_goods_and_services"

source_of_funds_description

string

Description of the source of funds. Required for high risk customers.

Required string length: 1 - 1024

estimated_annual_revenue_usd

enum<string>

Estimated annual revenue in USD. Required for high risk customers.

Available options:

0_99999,

100000_999999,

1000000_9999999,

10000000_49999999,

50000000_249999999,

250000000_plus

Example:

"1000000_9999999"

expected_monthly_payments_usd

number

Expected monthly payments in USD (integer). Required for high risk customers.

Example:

50000

conducts_money_services

boolean

Whether the business offers money services, investment products, or other financial services. Required for high risk customers.

Example:

false

conducts_money_services_using_bridge

boolean

Whether the business plans to conduct money services using its Bridge account. Required if conducts_money_services is true. A document with purpose "flow_of_funds" is required if this is true.

Example:

false

conducts_money_services_description

string

Description of the money services offered. Required if conducts_money_services is true.

Required string length: 1 - 1024

compliance_screening_explanation

string

Required if conducts_money_services is true. A detailed description of the business's compliance and anti-money laundering controls and practices.

Required string length: 1 - 1024

operates_in_prohibited_countries

boolean

Does the business operate in any prohibited countries? Required for high risk customers.

Example:

false

high_risk_activities

enum<string>[]

List of high-risk activities the business is involved in. Required for high risk customers.

Available options:

adult_entertainment,

gambling,

hold_client_funds,

investment_services,

lending_banking,

marijuana_or_related_services,

money_services,

nicotine_tobacco_or_related_services,

operate_foreign_exchange_virtual_currencies_brokerage_otc,

pharmaceuticals,

precious_metals_precious_stones_jewelry,

safe_deposit_box_rentals,

third_party_payment_processing,

weapons_firearms_and_explosives,

none_of_the_above

Example:

["none_of_the_above"]

high_risk_activities_explanation

string

Explanation of high risk activities. Required if high_risk_activities contains entries other than "none_of_the_above".

acting_as_intermediary

boolean

Is the customer acting as an intermediary for a third party? Required for high risk customers.

Example:

false

ownership_threshold

number

The applicable beneficial ownership threshold for the submitted associated_persons. Valid values: 5-25. Default: 25.

Required range: 5 <= x <= 25

Example:

25

has_material_intermediary_ownership

boolean

True if the business has at least one intermediate legal entity owner with 25% or more ownership.

Example:

false

Response

success

boolean

required

message

string

required

statusCode

number

required

timestamp

string

required

data

object

Show child attributes

path

string

Introduction

API Endpoints

Create business customer

Body

Response