Treezor Doc

# Legal Entities

A Legal Entity is a company, a governmental or non-governmental organization, or an association. It is identified by a legal name, legal register number, etc.

The legal representatives and majority shareholders must have a parent-children hierarchical relation with the Legal Entity. They are themselves created as Physical Users.

Info icon

Information – Specific case of self-employed persons

Freelancers and self-employed persons (known as auto-entrepreneur in France) should be created as Physical Users with a legalForm set to 1000.

# Creation

# Parameters

Below are the necessary parameters to create Legal Entities.

While some parameters might not be required by the API, they are necessary when it comes to the KYC validation of the user, so they should be collected from the creation (or you may have to update the user information later on).

Attribute Type Description
userTypeId integer Must be 2 (business), 3 (non-governmental organization), or 4 (governmental organization) for legal entities.
specifiedUSPerson integer Indicates if the user is a US Person.
email string The email of the legal entity, which must be valid and can't exceed 200 characters.
address{1-3}
(required for KYC)		 string The legal entity's postal address. The max value for each address line is 150 characters. If you're issuing cards, see the Data Formats article for information on further limitations.
postcode
(required for KYC)		 string The legal entity's address postcode.
city
(required for KYC)		 string The legal entity's address city.
country
(required for KYC)		 string The legal entity's address country (format ISO 3166-1 alpha-2)
phone
(required for KYC)		 string The legal entity's phone number, in international E.164 format.
legalName
(required for KYC)		 string The name of the company.
legalRegistrationNumber
(required for KYC)		 string The registration number of the legal entity (e.g., SIREN/SIRET).
legalForm
(required for KYC)		 string The legal category of the legal entity. See the list of legal forms.
legalTvaNumber string The VAT number of the legal entity.
legalRegistrationDate
(required for KYC)		 string The registration date of the company. Format: YYYY-MM-DD.
legalShareCapital integer The share capital of the legal entity.
legalAnnualTurnOver
(required for KYC)		 string The annual turn over of the legal entity in k€, among the following ranges: 0-39, 40-99, 100-249, 250-999, 1000-2999, 3000-9999, 10000-99999, and 100000-*
legalNetIncomeRange
(required for KYC)		 string The net income of the legal entity in k€, among the following ranges: 0-4, 5-9, 10-49, 50-149, 150-499, and 500-*.
legalNumberOfEmployeeRange
(required for KYC)		 string The number of employees of the legal entity among the following ranges: 0, 1-9, 10-99, 100-249, and 250-*
legalSectorType string Either NAF or NACE, qualifies the type of data in the legalSector field.
legalSector
(required for KYC)		 string The business sector of the legal entity. Either a 4-digit code if NACE or a 5-digit code followed by an uppercase letter if NAF, depending on the value of the legalSectorType.
distributionCountry
(required for KYC if)		 string The country in which the end user is using your services. This field is only required when you operate in multiple countries.
Info icon

Information – Refer to your KYC Form for declarative data

Declarative data to submit depends on the type of user, the country you're operating in, the regulations linked to your use case, etc. Treezor provides you with your KYC Form so you know what needs to be submitted.

# Request example

Here is an example of {payload}:

Returns a User object:

# Checking for veracity

When onboarding a Legal Entity, checking for the veracity of the provided information is key.

Treezor offers a dedicated endpoint to help you in checking these.

# Query parameters

Here are the necessary parameters to pass in the queryString.

Attribute Type Description
country string The country of registration of the legal entity.
vatNumber string The VAT number of the legal entity. Required if the registrationNumber is left empty.
registrationNumber string The registration number (e.g., SIREN) of the legal entity. Required if the vatNumber is left empty.

# Request examples

Or alternatively, using the registrationNumber

Returns the Business Search object that contains everything CreditSafe knows about this business. You can cross-check these with other reliable source of information (such as infogreffe.fr (opens new window) or societe.com (opens new window)).

Info icon

Information – This endpoint relies on CreditSafe

Despite CreditSafe best efforts, some information may be inaccurate or up to 72 hours outdated.

Treezor offers an endpoint to quickly identify the business legal representatives and majority shareholders (assuming they hold more than 25% worth of shares).

# Query parameters

Here are the necessary parameters to pass in the queryString.

Attribute Type Description
country string The country of registration of the legal entity.
vatNumber string The VAT number of the legal entity. Required if the registrationNumber is left empty.
registrationNumber string The registration number (e.g., SIREN) of the legal entity. Required if the vatNumber is left empty.

Or alternatively, using the registrationNumber

Returns the Business Information object, with the users attribute, which contains an array of representatives.

Info icon

Information – Children relationship for legal representatives

The legal representatives and majority shareholders must be created as Physical Users and associated to the Business User.

Info icon

Information – This endpoint relies on CreditSafe

Despite CreditSafe best efforts, some information may be inaccurate or up to 72 hours outdated.

# Sanctions and embargo

Some legal entities may be obligated to complete a due diligence questionnaire regarding sanctions and embargoes. Treezor provides a series of parameters for your end users to declare this information directly through the API.

The need to answer the questionnaire concerns:

  • Legal entities (userType set to 2, 3, or 4)
  • Self-employed individuals (i.e., individuals with a legalForm set to 1000)

However, the legalSector value may exempt such users from filling out the entirety of the questionnaire. Refer to the corresponding Help Center article (opens new window) to know if the user needs to answer either the first 2 questions, or the whole questionnare.

# Filling out the questionnaire

To fill out the questionnaire through the API, collect the information while creating a user (/v1/users) or requesting a user update (/v1/users/{userId}).

Through the collected answers, the User must:

  1. Specify for which part of the entity the user answers the questionnaire (entitySanctionsQuestionnaire).
  2. Indicate whether or not they have activity outside the European Union (activityOutsideEu).
  3. Answer the questions regarding economics, resident countries, and involved sanctions (if they operate outside the EU and are not exempted from filling out the questionnaire).

# Parameters

Below are the parameters available for the sanctions and embargo questionnaire.

Attribute Type Description
entitySanctionsQuestionnaire integer Defines the scope to which the activityOutsideEu field applies:
  • 0 – Not applicable
  • 1 – Only the legal entity
  • 2 – The legal entity and all its subsidiaries held at 100%
  • 3 – The legal entity and all its subsidiaries held at 50% or more
  • 4 – The legal entity and a list of subsidiaries
activityOutsideEu integer Whether the entity and its business units, subsidiaries, and joint ventures have a commercial activity outside of the European Union. Can be:
  • 0 – False
  • 1 – True. When set to this value, the next attributes become mandatory.
economicSanctions integer Whether the entity, its subsidiaries, entities, employees, directors, beneficial owners, or joint ventures are subject to Economic Sanctions. Can be:
  • 0 – False
  • 1 – True
residentCountriesSanctions integer Whether the entity, its subsidiaries, or joint ventures, located within or operating from any countries or territories are subject to Comprehensive Sanctions. Can be:
  • 0 – False
  • 1 – True
involvedSanctions integer Whether the entity, its subsidiaries, or joint ventures, are engaged in transactions, investments, business, or other dealings that directly or indirectly involve or benefit:
  • Any countries or territories subject to Comprehensive Sanctions, or
  • Any person or entity which is the target of any Sanctions (“Sanctioned Targets”).
Can be:
  • 0 – False
  • 1 – True

# Example

Here is an example of a legal entity creation with the questionnaire:

Here is an example of {payload}:

Returns a User object:

# Know Your Customer (KYC)

The legal representatives and majority shareholders of the business must have Physical Users created and associated to the Legal Entity. The Legal Entity can then undergo KYC review, this will trigger the review of all its children (reprensentatives and shareholders) at the same time.

Info icon

Information – The mandatory requirements regarding KYC review of businesses are constantly evolving

For the most up-to-date information, we recommend that you check the documents Treezor provided you with. Learn more about KYC review of Legal Entities (opens new window) in the Support Center.

# Types (userTypeId)

Below the userTypeId values for legal entities.

Value Description
2 Business user
3 Non-governemental organization
4 Governemental organization
books icon

Reading – Special case of charity, clubs, and syndicates

More information is available on Treezor Support Center regarding charity, clubs, and syndicates (opens new window).

# Entity Type (entityType)

Below the entityType values for legal entities.

Value Description
1 Reporting Financial Institution
2 Non-Reporting Financial Institution
3 Active Non-Financial Entity - Governmental entities, Int. organizations
4 Active Non-Financial Entity - Other
5 Passive Non-Financial Entity - Investment entity that is not Participating Jurisdiction FI
books icon

Reading – Entity types and embargo restriction

More information is available on Treezor Support Center regarding entityType and embargo restrictions (opens new window).

The legalForm indicates the legal category of the User.

It is required for the KYC Review of any user with a professional activity:

  • userTypeId of 2, 3, or 4
  • userTypeId of 1 with a legalForm set to 1000 (self-employed physical users)

You can use the /v1/businessinformations request if you have any doubt regarding the legalForm of your User. An example is available in the Finding the legal representatives section.

books icon

Reading – The exhausive list of French Legal Forms available on the INSEE website

For the most up-to-date list, you can check out the insee website (opens new window).

Updated on: 7/5/2024, 3:49:17 PM

← Onboarding →