# Legal Entity creation

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 56 characters, although due to mail carrier limitations, only the first 36 are printed on envelopes used to deliver Cards.
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.
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, since the legalAnnualTurnOver and legalSector values may exempt such users from filling out the questionnaire, you need to refer to the corresponding Help Center article (opens new window) to know which users must fill out the related parameters.

If a User is required to answer the questionnaire, then:

  1. They first need to answer whether or not they have activity outside the European Union.
  2. If they answer yes to the first question, they need to answer the following questions, regarding economics, resident countries, and involved sanctions.

# Filling out the questionnaire

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

# Parameters

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

Attribute Type Description
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).

books icon

Reading – The exhausive list is available on the INSEE website

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

Code Category Details (in french)
0000 Undertaking for collective investment in transferable securities (UCITS) without legal personality Organisme de placement collectif en valeurs mobilières sans personnalité morale
1000 Individual company Entrepreneur Individuel a Responsabilité Limitée (EIRL)
2110 Indivision and others Indivision entre personnes physiques
2120 Indivision and others Indivision avec personne morale
2210 Indivision and others Société créée de fait entre personnes physiques
2220 Indivision and others Société créée de fait avec personne morale
2310 Indivision and others Société en participation entre personnes physiques
2320 Indivision and others Société en participation avec personne morale
2385 Indivision and others Société en participation de professions libérales
2400 Indivision and others Fiducie
2700 Diverse Paroisse hors zone concordataire
2800 Single taxable person for VAT purposes Assujetti unique à la TVA
2900 Economic Interest Grouping Autre groupement de droit privé non doté de la personnalité morale
3110 Foreign company Représentation ou agence commerciale d'état ou organisme public étranger immatriculé au RCS
3120 Foreign company Société étrangère immatriculée au RCS
3205 Foreign company Organisation internationale
3210 Foreign company Etat collectivité ou établissement public étranger
3220 Foreign company Société étrangère non immatriculée au RCS
3290 Foreign company (Autre) personne morale de droit étranger
4110 Administrations, Instituions Etablissement public national à caractère industriel ou commercial doté d'un comptable public
4120 Administrations, Instituions Etablissement public national à caractère industriel ou commercial non doté d'un comptable public
4130 Administrations, Instituions Exploitant public
4140 Administrations, Instituions Etablissement public local à caractère industriel ou commercial
4150 Administrations, Instituions Régie d'une collectivité locale à caractère industriel ou commercial
4160 Administrations, Instituions Institution Banque de France
5191 De facto undivided ownership company Société de caution mutuelle
5192 Diverse Société coopérative de banque populaire
5193 De facto undivided ownership company Caisse de crédit maritime mutuel
5194 De facto undivided ownership company Caisse (fédérale) de crédit mutuel
5195 Association fondation Association coopérative inscrite (droit local Alsace Moselle)
5196 De facto undivided ownership company Caisse d'épargne et de prévoyance à forme coopérative
5202 General partnership Société en nom collectif
5203 General partnership Société en nom collectif coopérative
5306 Limited company Société en commandite simple
5307 Limited company Société en commandite simple coopérative
5308 Limited company Société en commandite par actions
5309 Limited company Société en commandite par actions coopérative
5310 Limited company Société en libre partenariat (SLP)
5385 Limited company Société d'exercice libéral en commandite par action
5410 Limited Liability Company SARL nationale
5415 Limited Liability Company SARL d'économie mixte
5422 Limited Liability Company SARL immobilière pour le commerce et l'industrie (SICOMI)
5426 Limited Liability Company Société immobilière de gestion
5430 Limited Liability Company Safer en SARL
5431 Limited Liability Company SARL mixte d'intérêt agricole (SIMA)
5432 Limited Liability Company SARL d'intérêt collectif agricole (SICA)
5442 Limited Liability Company SARL d'attribution
5443 Limited Liability Company SARL coopérative de construction
5451 Limited Liability Company SARL coopérative de consommation
5453 Limited Liability Company SARL coopérative artisanale
5454 Limited Liability Company SARL coopérative d'intérêt maritime
5455 Limited Liability Company SARL coopérative de transports
5458 Limited Liability Company SARL coopérative ouvrière de production et de crédit (SCOP)
5459 Limited Liability Company SARL union de sociétés coopératives
5460 Limited Liability Company SARL coopérative
5485 Limited Liability Company Société d'exercice libéral à responsabilité limitée
5498 Limited Liability Company SARL unipersonnelle
5499 Limited Liability Company SARL
5505 Limited company SA à participation ouvrière à conseil d'administration
5510 Limited company SA nationale à conseil d'administration
5515 Limited company SA d'économie mixte à conseil d'administration
5520 Limited company Société d'investissement à capital variable (SICAV) à conseil d'administration
5522 Limited company Société anonyme immobilière pour le commerce et l'industrie (SICOMI) à conseil d'administration
5525 Limited company Société anonyme immobilière d'investissement à conseil d'administration
5530 Limited company Safer anonyme à conseil d'administration
5531 Limited company Société anonyme mixte d'intérêt agricole (SMIA) à conseil d'administration
5532 Limited company Société anonyme mixte d'intérêt collectif agricole (SICA) à conseil d'administration
5542 Limited company Société anonyme d'attribution à conseil d'administration
5543 Limited company Société anonyme coopérative de construction à conseil d'administration
5546 Limited company SA de HLM à conseil d'administration
5547 Limited company SA coopérative de production de HLM à conseil d'administration
5548 Limited company SA de crédit immobilier à conseil d'administration
5551 Limited company SA coopérative de consommation à conseil d'administration
5552 Limited company SA coopérative de commerçants détaillants à conseil d'administration
5553 Limited company SA coopérative artisanale à conseil d'administration
5554 Limited company SA coopérative (d'intérêt) maritime à conseil d'administration
5555 Limited company SA coopérative de transports à conseil d'administration
5558 Limited company SA coopérative de production (SCOP) à conseil d'administration
5559 Limited company SA union de sociétés coopératives à conseil d'administration
5560 Limited company SA coopérative à conseil d'administration
5585 Limited company Société d'exercice libéral à forme anonyme à conseil d'administration
5599 Limited company SA à conseil d'administration
5605 Limited company SA à participation ouvrière à directoire
5610 Limited company SA nationale à directoire
5615 Limited company SA d'économie mixte à directoire
5620 Limited company SICAV
5622 Limited company SICOMI
5625 Limited company Société immobilière d'investissement anonyme à directoire
5630 Limited company Safer anonyme à directoire
5631 Limited company Société anonyme mixte d'intérêt agricole (SMIA)
5632 Limited company SICA
5642 Limited company Société anonyme d'attribution à directoire
5643 Limited company Société anonyme coopérative de construction à directoire
5646 Limited company S.A. HLM à directoire
5647 Limited company Société coopérative de production de HLM anonyme à directoire
5648 Limited company SA de crédit immobilier à directoire
5651 Limited company SA coopérative de consommation à directoire
5652 Limited company SA coopérative de commerçants détaillants à directoire
5653 Limited company SA coopérative artisanale à directoire
5654 Limited company SA coopérative (d'intérêt) maritime à directoire
5655 Limited company SA coopérative de transport à directoire
5658 Limited company SA coopérative de production (SCOP) à directoire
5659 Limited company SA union de sociétés coopératives à directoire
5660 Limited company SA coopérative à directoire
5685 Limited company Société d'exercice libéral à forme anonyme à directoire
5699 Limited company (Autre) SA à directoire
5710 Limited company SAS
5720 Limited company SASU
5785 Limited company Société d'exercice libéral par action simplifiée
5800 Diverse Société européenne
6100 De facto undivided ownership company Caisse d'épargne et de prévoyance
6210 Economic Interest Grouping GEIE
6220 Economic Interest Grouping GIE
6316 Diverse CUMA
6317 Diverse Société coopérative agricole
6318 Diverse Union de sociétés coopératives agricoles
6411 De facto undivided ownership company Société d'assurance mutuelle
6521 Civils companies (without SCI) SCPI
6532 Civils companies (without SCI) SICA
6533 Civils companies (without SCI) GAEC
6534 Civils companies (without SCI) Groupement foncier agricole
6535 Civils companies (without SCI) Groupement agricole foncier
6536 Civils companies (without SCI) Groupement forestier
6537 Civils companies (without SCI) Groupement pastoral
6538 Civils companies (without SCI) Groupement foncier rural
6539 Civils companies (without SCI) Société civile foncière
6540 Civils companies SCI
6541 Civils companies SCI de construction vente
6542 Civils companies (without SCI) Société civile d'attribution
6543 Civils companies (without SCI) Société civile coopérative de construction
6544 Civils companies Société civile d'accession progressive à la propriété
6551 Civils companies (without SCI) Société civile coopérative de consommation
6554 Civils companies (without SCI) Société civile coopérative (d'intérêt) maritime
6558 Civils companies (without SCI) Société civile coopérative entre médecins
6560 Civils companies (without SCI) SCP
6561 Civils companies (without SCI) SCP d'avocats
6562 Civils companies (without SCI) SCP d'avocats aux conseil
6563 Civils companies (without SCI) SCP d'avoués d'appel
6564 Civils companies (without SCI) SCP d'huissiers
6565 Civils companies (without SCI) SCP de notaires
6566 Civils companies (without SCI) SCP de commissaires-priseurs
6567 Civils companies (without SCI) SCP de greffiers de tribunal de commerce
6568 Civils companies (without SCI) SCP de conseils juridiques
6569 Civils companies (without SCI) SCP de commissaires aux comptes
6571 Civils companies (without SCI) SCP de médecins
6572 Civils companies (without SCI) SCP de dentistes
6573 Civils companies (without SCI) SCP d'infirmiers
6574 Civils companies (without SCI) SCP de masseurs kinésithérapeutes
6575 Civils companies (without SCI) SCP de directeurs de laboratoire d'analyse médicale
6576 Civils companies (without SCI) SCP de vétérinaires
6577 Civils companies (without SCI) SCP de géomètres-experts
6578 Civils companies (without SCI) SCP d'architectes
6585 Civils companies (without SCI) SCP
6588 Civils companies (without SCI) Société civile laitière
6589 Civils companies (without SCI) Société civile de moyens
6595 Civils companies (without SCI) Caisse (locale) de crédit mutuel
6596 Civils companies (without SCI) Caisse de crédit agricole mutuel
6597 Civils companies (without SCI) Société civile d'exploitation agricole
6598 Farm operator Exploitation agricole à responsabilité limitée
6599 Civils companies (without SCI) Autre société civile
6901 Diverse Autres personnes de droit privé inscrites au registre du commerce et des sociétés
7111 Administrations, Instituions Autorité constitutionnelle
7112 Administrations, Instituions Autorité administrative indépendante
7113 Administrations, Instituions Ministère
7120 Administrations, Instituions Service central d'un ministère
7150 Administrations, Instituions Service du ministère de la Défense
7160 Administrations, Instituions Service déconcentré à compétence nation . D'un ministère (hors Défense)
7171 Administrations, Instituions Service déconcentré de l'Etat à compétence (inter) régionale
7172 Administrations, Instituions Service déconcentré de l'Etat à compétence (inter) départementale
7179 Administrations, Instituions (Autre) Service déconcentré de l'Etat à compétence territoriale
7190 Administrations, Instituions Ecole nationale non dotée de la personnalité morale
7210 Administrations, Instituions Commune
7220 Administrations, Instituions Département
7225 Administrations, Instituions Territoire d'Outre-Mer
7229 Administrations, Instituions (Autre) Collectivité territoriale
7230 Administrations, Instituions Région
7312 Administrations, Instituions Commune associée
7313 Administrations, Instituions Section de commune
7314 Administrations, Instituions Ensemble urbain
7321 Administrations, Instituions Association syndicale autorisée
7322 Administrations, Instituions Association foncière urbaine
7323 Administrations, Instituions Association foncière de remembrement
7331 Administrations, Instituions Etablissement public local d'enseignement
7340 Administrations, Instituions Pôle métropolitain
7341 Administrations, Instituions Secteur de commune
7342 Administrations, Instituions District urbain
7343 Administrations, Instituions Communauté urbaine
7344 Administrations, Instituions Métropole
7345 Administrations, Instituions Syndicat intercommunal à vocation multiple (SIVOM)
7346 Administrations, Instituions Communauté de commune
7347 Administrations, Instituions Communauté de villes
7348 Administrations, Instituions Communauté d'agglomération
7349 Administrations, Instituions Autre établissement public local de coopération non spécialisé ou entente
7351 Administrations, Instituions Institution interdépartementale ou entente
7352 Administrations, Instituions Institution interrégionale ou entente
7353 Administrations, Instituions Syndicat intercommunal à vocation unique (SIVU)
7354 Administrations, Instituions Syndicat mixte communal
7355 Administrations, Instituions Autre syndicat mixte
7356 Administrations, Instituions Commission syndicale pour la gestion des biens indivis des communes
7361 Administrations, Instituions Centre communal d'action sociale
7362 Administrations, Instituions Caisse des écoles
7363 Administrations, Instituions Caisse de crédit municipal
7364 Administrations, Instituions Etablissement d'hospitalisation
7365 Administrations, Instituions Syndicat inter hospitalier
7366 Administrations, Instituions Etablissement public local social et médico-social
7371 Administrations, Instituions Office public d'habitation à loyer modéré (OPHLM)
7372 Administrations, Instituions Service départemental d'incendie
7373 Administrations, Instituions Etablissement public local culturel
7378 Administrations, Instituions Régie d'une collectivité locale à caractère administratif
7379 Administrations, Instituions (Autre) Etablissement public administratif local
7381 Administrations, Instituions Organisme consulaire
7382 Administrations, Instituions Etablissement public national ayant fonction d'administration centrale
7383 Administrations, Instituions Etablissement public national à caractère scientifique culturel et professionnel
7384 Administrations, Instituions Autre établissement public national d'enseignement
7385 Administrations, Instituions Autre établissement public national administratif à compétence territoriale limitée
7389 Administrations, Instituions Etablissement public national à caractère administratif
7410 Administrations, Instituions Groupement d'intérêt public (GIP)
7430 Administrations, Instituions Etablissement public des cultes d'Alsace-Lorraine
7450 Administrations, Instituions Etablissement public, cercle et foyer dans les armées
7470 Administrations, Instituions Groupement de coopération sanitaire à gestion publique
7490 Administrations, Instituions Autre personne morale de droit administratif
8110 Administrations, Instituions Régime général de la sécurité sociale
8120 Administrations, Instituions Régime spécial de sécurité sociale
8130 Administrations, Instituions Institution de retraite complémentaire
8140 Administrations, Instituions Mutualité sociale agricole
8150 Administrations, Instituions Régime maladie des non-salariés non agricoles
8160 Administrations, Instituions Régime vieillesse ne dépendant pas du régime général de la sécurité sociale
8170 Administrations, Instituions Régime d'assurance chômage
8190 Administrations, Instituions Autre régime de prévoyance sociale
8210 De facto undivided ownership company Mutuelle
8250 De facto undivided ownership company Assurance mutuelle agricole
8290 De facto undivided ownership company Autre organisme mutualiste
8310 Association fondation Comité social économique d'entreprise
8311 Association fondation Comité social économique d'établissement
8410 Association fondation Syndicat de salariés
8420 Association fondation Syndicat patronal
8450 Association fondation Ordre professionnel ou assimilé
8470 Association fondation Centre technique industriel ou comité professionnel du développement économique
8490 Association fondation Autre organisme professionnel
8510 Administrations, Instituions Institution de prévoyance
8520 Administrations, Instituions Institution de retraite supplémentaire
9110 Condominium syndicate Syndicat de copropriété
9150 Association fondation Association syndicale libre
9210 Association fondation Association non déclarée
9220 Association fondation Association déclarée
9221 Association fondation Association déclarée "entreprises d'insertion par l'économique"
9222 Association fondation Association intermédiaire
9223 Association fondation Groupement d'employeurs
9224 Association fondation Association d'avocats à responsabilité professionnelle individuelle
9230 Association fondation Association déclarée reconnue d'utilité publique
9240 Association fondation Congrégation
9260 Association fondation Association de droit local
9300 Association fondation Fondation
9900 Diverse Autre personne morale de droit privé
9970 Diverse Groupement de coopération sanitaire à gestion privée
Updated on: 5/15/2024, 8:58:06 AM