---
updatedAt: 2026-01-17T16:51:04.000Z
agentTools:
  projectIndex: https://docs.fiatrepublic.com/llms.txt
---

# The Business End User Object

### Business End User Object

End Users are your users who should be created on Fiat Republic before you can start receiving or sending payments for them. We require a minimum set of details on your customers to fulfil our regulatory obligations and perform AML checks.

Activation of a new Business End User is **fully asynchronous**. This means that after a POST request the returned entity won't be with ACTIVE Status immediately, but CREATED.

To enable **USD** for End Users, please find requirements gathered here [Enabling USD Services](https://docs.fiatrepublic.com/docs/enabling-usd-services)

Check Guides for more details [here](https://docs.fiatrepublic.com/docs/end-user#/)

<Table align={["left","left","left"]}>
  <thead>
    <tr>
      <th>
        Attribute
      </th>

      <th>
        Description
      </th>

      <th>
        Format / ENUMS
      </th>
    </tr>
  </thead>

  <tbody>
    <tr>
      <td>
        **id**
        _string_
      </td>

      <td>
        Unique identifier of the Business End User.
      </td>

      <td>
        e.g. `eus_j82rl497g47g5ykvzn`
      </td>
    </tr>

    <tr>
      <td>
        **business.companyName**
        _string_
      </td>

      <td>
        Official Company Name
      </td>

      <td>
        Can be built of multiple space separated segments
        Regex: `[a-zA-Z0-9\s',£€¥'':/«»"".?\-+()]+`
      </td>
    </tr>

    <tr>
      <td>
        **business.tradingName**
        _string_
      </td>

      <td>
        Trading Company Name
      </td>

      <td>
        Can be built of multiple space separated segments
        Regex: `[a-zA-Z0-9\s',£€¥'':/«»"".?\-+()]+`
      </td>
    </tr>

    <tr>
      <td>
        **business.type**
        _string_
      </td>

      <td>
        Type of the business (Limited only)
      </td>

      <td>
        LIMITED
      </td>
    </tr>

    <tr>
      <td>
        **business.registrationNumber**
        _string_
      </td>

      <td>
        Company registration number
      </td>

      <td>
        e.g. 56292646
      </td>
    </tr>

    <tr>
      <td>
        **business.registrationDate**
        _LocalDate_
      </td>

      <td>
        Date when the company has been registered
      </td>

      <td>

      </td>
    </tr>

    <tr>
      <td>
        **business.website**
        _string_
      </td>

      <td>
        Company website
      </td>

      <td>
        Validation regex: `((http(s)?)://)?(www\\.)?[a-zA-Z0-9\\-_.~]{2,256}(\\.[a-zA-Z]{2,6})(/\[a-zA-Z0-9!#$&'()\*+,/:;=?@\\[\\]\\-\_.~]{2,})?`

        JavaScript:
        `("^((http(s)?)://)?(www\\.)?[a-zA-Z0-9\\-_.~]{2,256}(\\.[a-zA-Z]{2,6})(/\[a-zA-Z0-9!#$&'()\*+,/:;=?@\\[\\]\\-\_.~]{2,})?$");`
      </td>
    </tr>

    <tr>
      <td>
        **business.registeredAddress**
        _string_
      </td>

      <td>
        Address under which company has been registered
      </td>

      <td>
        Is required
      </td>
    </tr>

    <tr>
      <td>
        **business.registeredAddress.line1**
        _string_
      </td>

      <td>
        First line of the company registration address
      </td>

      <td>
        Space and hyphen are allowed between the characters.
        Max length 50
        e.g. Silent Hill 123/34
        Regex: `^[a-zA-Z0-9 .'\-/,]*[a-zA-Z0-9]+[a-zA-Z0-9 .'\-/,]*$`
      </td>
    </tr>

    <tr>
      <td>
        **business.registeredAddress.line2**
        _string_
      </td>

      <td>
        Second line of the company registration address
      </td>

      <td>
        Space and hyphen are allowed between the characters.
        Max length 50
        Regex:  `^[a-zA-Z0-9 .'\-/,]*[a-zA-Z0-9]+[a-zA-Z0-9 .'\-/,]*$`
      </td>
    </tr>

    <tr>
      <td>
        **business.registeredAddress.city**
        _string_
      </td>

      <td>
        City of the registration address
      </td>

      <td>
        Space and hyphen are allowed between the characters.
        Max length 50
        e.g. London
        Regex: `^[a-zA-Z0-9 .'\-/,]*[a-zA-Z0-9]+[a-zA-Z0-9 .'\-/,]*$`
      </td>
    </tr>

    <tr>
      <td>
        **business.registeredAddress.state**
        _string_
      </td>

      <td>
        State or region of the registration address  
        Required for entity with address in CA and US

        <br />
      </td>

      <td>
        Space and hyphen are allowed between the characters.
        Max length 35
        e.g. Ile de France
        Regex: `^[a-zA-Z0-9 .'\-/,)(+]*[a-zA-Z0-9]+[a-zA-Z0-9 .'\-/,)(+]*$`
      </td>
    </tr>

    <tr>
      <td>
        **business.registeredAddress.postalCode**
        _string_
      </td>

      <td>
        Postal code of the registration address
      </td>

      <td>
        The format and presence of this field may vary depending on the country.
        Space and hyphen are allowed between the characters. **Please trim spaces at the end**
        Validation regex:

        * for GB: `^[a-zA-Z]{1,2}[0-9R][0-9a-zA-Z]? ?[0-9][a-zA-Z]{2}$`
        * for Estonia: `^\d{5}$`
        * for Ireland: `(?:[AC-FHKNPRTV-Y][0-9]{2}|D6W)[ -]?[0-9AC-FHKNPRTV-Y]{4}$`
        * others: `^[a-zA-Z\d][a-zA-Z\s\d\-]{1,8}[a-zA-Z\d]$`
      </td>
    </tr>

    <tr>
      <td>
        **business.registeredAddress.country**
        _string_
      </td>

      <td>
        Country code of the registration address
      </td>

      <td>
        The two-letter code used to identify a country.

        [ISO 3166-1 alpha-2 country code](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2)

        e.g. `GB` or `US`
      </td>
    </tr>

    <tr>
      <td>
        **business.tradingAddress**
        _string_
      </td>

      <td>
        Trading address of the company (might be the same as registration address)
      </td>

      <td>

      </td>
    </tr>

    <tr>
      <td>
        **business.tradingAddress.line1**
        _string_
      </td>

      <td>
        First line of the company trading address
      </td>

      <td>
        Space and hyphen are allowed between the characters.
        Max length 50
        Regex: `^[a-zA-Z0-9 .'\-/,)(⁰°#"]*[a-zA-Z0-9]+[a-zA-Z0-9 .'\-/,)(⁰°#"]*$`
      </td>
    </tr>

    <tr>
      <td>
        **business.tradingAddress.line2**
        _string_
      </td>

      <td>
        Second line of the company trading address
      </td>

      <td>
        Space and hyphen are allowed between the characters.
        Max length 50
        Regex: `^[a-zA-Z0-9 .'\-/,)(⁰°#"]*[a-zA-Z0-9]+[a-zA-Z0-9 .'\-/,)(⁰°#"]*$`
      </td>
    </tr>

    <tr>
      <td>
        **business.tradingAddress.city**
        _string_
      </td>

      <td>
        City of the company trading address
      </td>

      <td>
        Space and hyphen are allowed between the characters.
        Max length 50
        Regex: `^[a-zA-Z0-9 .'\-/,]*[a-zA-Z0-9]+[a-zA-Z0-9 .'\-/,]*$`
      </td>
    </tr>

    <tr>
      <td>
        **business.tradingAddress.state**
        _string_
      </td>

      <td>
        State of the company trading address
      </td>

      <td>
        Space and hyphen are allowed between the characters.
        Max length 35
        Regex: `^[a-zA-Z0-9 .'\-/,)(+]*[a-zA-Z0-9]+[a-zA-Z0-9 .'\-/,)(+]*$`
      </td>
    </tr>

    <tr>
      <td>
        **business.tradingAddress.postalCode**
        _string_
      </td>

      <td>
        Postal code of the company trading address
      </td>

      <td>
        The format and presence of this field may vary depending on the country.
        Space and hyphen are allowed between the characters. **Please trim spaces at the end**
        e.g. 67999, 30-555, SW1A 1AA
        Validation regex:

        * for GB: `^[a-zA-Z]{1,2}[0-9R][0-9a-zA-Z]? ?[0-9][a-zA-Z]{2}$`
        * for Estonia: `^\d{5}$`
        * for Ireland: `(?:[AC-FHKNPRTV-Y][0-9]{2}|D6W)[ -]?[0-9AC-FHKNPRTV-Y]{4}$`
        * others: `^[a-zA-Z\d][a-zA-Z\s\d\-]{1,8}[a-zA-Z\d]$`
      </td>
    </tr>

    <tr>
      <td>
        **business.tradingAddress.country**
        _string_
      </td>

      <td>
        Country od the company trading address
      </td>

      <td>
        The two-letter code used to identify a country.

        [ISO 3166-1 alpha-2 country code](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2)

        e.g. `GB` or `US`
      </td>
    </tr>

    <tr>
      <td>
        **business.businessPersons.person.firstName**
      </td>

      <td>
        First name of the Business Person.
      </td>

      <td>
        Can be built of singular value.
        Must have only letters, hyphens and apostrophes.
        Regex:`^[a-zA-Z](?:[a-zA-Z '.-]*[a-zA-Z])?\.?$`
      </td>
    </tr>

    <tr>
      <td>
        **business.businessPersons.person.middleName**
        _string_
      </td>

      <td>
        Middle name of the Business Person.
      </td>

      <td>
        Can be built of multiple space separated segments.
        Should be between 1 and 100 characters long and contain only letters, hyphens, dots and apostrophes.
        Regex: `^[a-zA-Z](?:[a-zA-Z '.-]*[a-zA-Z])?\.?$`
      </td>
    </tr>

    <tr>
      <td>
        **business.businessPersons.person.lastName**
        _string_
      </td>

      <td>
        Last name of the Business Person.
      </td>

      <td>
        Can be built of multiple space separated segments.
        Must consist of words that have only letters, hyphens and apostrophes.
        Regex: `^'?[a-zA-Z]([ a-zA-Z'-]*[a-zA-Z])?$`
      </td>
    </tr>

    <tr>
      <td>
        **business.businessPersons.person.birthCountry**
        _string_
      </td>

      <td>
        Country of birth of the Business Person.
      </td>

      <td>
        The two-letter code used to identify a country.

        [ISO 3166-1 alpha-2 country code](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2)

        e.g. `GB` or `US`
      </td>
    </tr>

    <tr>
      <td>
        **business.businessPersons.person.nationality**
        _array of strings_
      </td>

      <td>
        One or more nationalities of the Business Person.
      </td>

      <td>
        The two-letter code used to identify a country.

        [ISO 3166-1 alpha-2 country code](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2)

        e.g. `GB` or `US`
      </td>
    </tr>

    <tr>
      <td>
        **business.businessPersons.person.dob**
        _Date_
      </td>

      <td>
        Date of birth of the Business Person.
      </td>

      <td>
        `YYYY-MM-DD` format e.g. `1975-04-05`
      </td>
    </tr>

    <tr>
      <td>
        **business.businessPersons.person.address.line1**
        _string_
      </td>

      <td>
        First line of the Business Person's home address.
      </td>

      <td>
        Space and hyphen are allowed between the characters.
        Max length 50
        Regex: `^[a-zA-Z0-9 .'\-/,)(⁰°#"]*[a-zA-Z0-9]+[a-zA-Z0-9 .'\-/,)(⁰°#"]*$`
      </td>
    </tr>

    <tr>
      <td>
        **business.businessPersons.person.address.line2**
        _string_
      </td>

      <td>
        Second line of the Business Person's  home address.
      </td>

      <td>
        Space and hyphen are allowed between the characters.
        Max length 50
        Regex: `^[a-zA-Z0-9 .'\-/,)(⁰°#"]*[a-zA-Z0-9]+[a-zA-Z0-9 .'\-/,)(⁰°#"]*$`
      </td>
    </tr>

    <tr>
      <td>
        **business.businessPersons.person.address.city**
        _string_
      </td>

      <td>
        City of the Business Person.
      </td>

      <td>
        Space and hyphen are allowed between the characters.
        Max length 50
        Regex: `^[a-zA-Z0-9 .'\-/,]*[a-zA-Z0-9]+[a-zA-Z0-9 .'\-/,]*$`
      </td>
    </tr>

    <tr>
      <td>
        **business.businessPersons.person.address.state**
        _string_
      </td>

      <td>
        Region or state of the Business Person.  
        Required for entity with address in CA and US
      </td>

      <td>
        Space and hyphen are allowed between the characters.
        Max length 35
        Regex: `^[a-zA-Z0-9 .'\-/,)(+]*[a-zA-Z0-9]+[a-zA-Z0-9 .'\-/,)(+]*$`
      </td>
    </tr>

    <tr>
      <td>
        **business.businessPersons.person.address.postalCode**
        _string_
      </td>

      <td>
        Postal/Zip code of the Business Person.
      </td>

      <td>
        The format and presence of this field may vary depending on the country.
        Space and hyphen are allowed between the characters. **Please trim spaces at the end**
        e.g. 67999, 30-555, SW1A 1AA
        Validation regex:

        * for GB: `^[a-zA-Z]{1,2}[0-9R][0-9a-zA-Z]? ?[0-9][a-zA-Z]{2}$`
        * for Estonia: `^\d{5}$`
        * for Ireland: `(?:[AC-FHKNPRTV-Y][0-9]{2}|D6W)[ -]?[0-9AC-FHKNPRTV-Y]{4}$`
        * others: `^[a-zA-Z\d][a-zA-Z\s\d\-]{1,8}[a-zA-Z\d]$`
      </td>
    </tr>

    <tr>
      <td>
        **business.businessPersons.person.address.country**
        _string_
      </td>

      <td>
        Business Person's Country of residence.
      </td>

      <td>
        The two-letter code used to identify a country.

        [ISO 3166-1 alpha-2 country code](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2)

        e.g. `GB` or `US`
      </td>
    </tr>

    <tr>
      <td>
        **business.businessPersons.person.phone**
        _string_
      </td>

      <td>
        Phone number of the Business Person.
      </td>

      <td>
        Including the country prefix e.g. `+447788661100`

        * must start with a plus sign (+).
        * should have country code (e.g., +1, +44, etc.) followed by the appropriate number of digits (min = 8, ma
      </td>
    </tr>

    <tr>
      <td>
        **business.businessPersons.person.email**
        _string_
      </td>

      <td>
        Email of the Business Person.
      </td>

      <td>
        This is required
      </td>
    </tr>

    <tr>
      <td>
        **business.businessPersons.person.
        identificationDocument.number**
      </td>

      <td>
        Number of identity document
      </td>

      <td>

      </td>
    </tr>

    <tr>
      <td>
        **business.businessPersons.person.
        identificationDocument.type**
      </td>

      <td>
        Type of identity document
      </td>

      <td>
        Examples:
        WORK_PERMIT,
        PASSPORT,
        NATIONAL_ID,
        DRIVERS_LICENCE
      </td>
    </tr>

    <tr>
      <td>
        **business.businessPersons.types**
        _string_
      </td>

      <td>
        Type of the Business Person. Can be CONTACT / DIRECTOR / UBO
      </td>

      <td>
        There must be at least 1 DIRECTOR and 1 UBO
      </td>
    </tr>

    <tr>
      <td>
        **business.businessPersons.ownership**
        _BigDecimal_
      </td>

      <td>
        Amount of shares hold by the Business Person (in %)
      </td>

      <td>
        e.g. 50.00
      </td>
    </tr>

    <tr>
      <td>
        **business.createdAt**
        _integer_
      </td>

      <td>
        Epoch Timestamp at which the object was last updated.
      </td>

      <td>
        e.g. `1637049210552`
      </td>
    </tr>

    <tr>
      <td>
        **business.updatedAt**
        _integer_
      </td>

      <td>
        Epoch Timestamp at which the object was last updated.
      </td>

      <td>
        e.g. `1637049210552`
      </td>
    </tr>

    <tr>
      <td>
        **business.ipAddress**
        _string_
      </td>

      <td>
        _The IP address from where the individual signed up on your platform._
      </td>

      <td>
        e.g. 86.23.22.163
      </td>
    </tr>

    <tr>
      <td>
        **annualTurnoverRange**
        _string_
      </td>

      <td>
        Value of annual turnover range of the Business End User (in EUR)
      </td>

      <td>
        Ranges:

        * 0 to 50000
        * 50000 to 250000
        * 250000 to 1000000
        * 1000000 to 5000000
        * above 5000000
      </td>
    </tr>

    <tr>
      <td>
        **linkedCryptoWallets**
        _string_
      </td>

      <td>
        Details of any known crypto wallets linked with the individual being created.
      </td>

      <td>

      </td>
    </tr>

    <tr>
      <td>
        **tags**
        _string_
      </td>

      <td>
        Tags allowing you to provide additional risk-related information for the individual.
      </td>

      <td>
        `PEP`
      </td>
    </tr>

    <tr>
      <td>
        **sector**
        _string_
      </td>

      <td>
        Sector in which business operates
      </td>

      <td>
        e.g. crypto, blockchain
      </td>
    </tr>

    <tr>
      <td>
        **riskRating**
        _string_
      </td>

      <td>
        Rating of the risk level assigned to the user.
      </td>

      <td>
        `LOW`, `MEDIUM`, `HIGH`
      </td>
    </tr>

    <tr>
      <td>
        **signupAt**
        _integer_
      </td>

      <td>
        A date of registration of End User profile within Member platform
      </td>

      <td>
        e.g. `1637049210552`
      </td>
    </tr>

    <tr>
      <td>
        **metadata**
        _array of strings_
      </td>

      <td>
        Additional data in JSON key:value format.
      </td>

      <td>
        See

        [Metadata](https://docs.fiatrepublic.com/docs/metadata)

        for more information
      </td>
    </tr>

    <tr>
      <td>
        **status**
        _string_
      </td>

      <td>
        Status of the Business End User.
      </td>

      <td>
        `CREATED` , `IN_REVIEW`,`ACTIVE`, `SUSPENDED`,`REJECTED`, `CLOSED`
      </td>
    </tr>
  </tbody>
</Table>

After creating an Business End User, you will be able to create one or more [Virtual Accounts](https://docs.fiatrepublic.com/reference/create-virtual-account) for them.