Skip to main content

Documentation Index

Fetch the complete documentation index at: https://developer.kyckr.com/llms.txt

Use this file to discover all available pages before exploring further.

​
Overview

Registry

RNE (Registre National des Entreprises)Official company registry of France

Data Access

INPI (Institut National de la Propriété Industrielle)Data.inpi.fr
French company data is sourced from the Registre National des Entreprises (RNE) via the Institut National de la Propriété Industrielle (INPI). The data includes the SIREN as the primary company identifier, establishments identified by SIRET, representatives with INPI role codes, capital (amount, currency, fixed or variable), and APE (NAF) activity classification.

​
Company Identifiers

IdentifierFormatExampleNotes
SIREN9-digit numeric325013555Primary company identifier; used for search and profile requests
SIRET14-digit numeric (9 SIREN + 5 NIC)32501355500012Identifies each establishment (principal and secondary); NIC is establishment number
VAT NumberFR + digitsFR12345678901European VAT identifier

​
Search Capabilities

Search MethodSupported
Search by registration number (SIREN)Yes
Search by company nameYes

​
Data Availability

Data PointAvailable
Company NameYes
Registered AddressYes
Legal FormYes
Registration DateYes
StatusYes
RepresentativesYes
ShareholdersYes
Share CapitalYes
EstablishmentsYes
UBOsNo
Legal form is provided from INPI/INSEE forme juridique (numeric code), mapped to a French description in the API response. Unmapped codes may appear as “Form” followed by the code.

​
Status Codes

Status is derived from cessation and dissolution indicators in the registry. Normalized values are Active, Distressed, or Inactive.
ConditionNormalized Status
No cessation details, or dissolution false and no dissolution/disappearance dateActive
Dissolution in progress (e.g. liquidator appointed, registration maintained)Distressed
Effective cessation date or removal from register present; or dissolution and legal entity disappearance both completeInactive
Granular cessation information is available in status details: removal date, effective date, total activity cessation date, liquidation closure date, dissolution type, liquidator appointment publication (date and journal), and principal establishment formality status or closure/transfer dates when applicable.

​
Activity Codes

France uses APE (Activité Principale Exercée), aligned with NAF rev. 2, for business activity classification.
FieldDescriptionNotes
codeAPE/NAF codeCompany-level code is the primary activity
descriptionActivity descriptionFrom company objet or establishment description
typePrimary or SecondaryPrimary = company-level; Secondary = from principal or other establishments
Activities from closed establishments (closure effective date present) or activities with an end date are excluded from the response.

​
Address Format

Company and establishment addresses use a component-based structure. Example format: 
12, rue de la Paix, 75002 Paris, France

​
Address Components

Source ComponentMaps ToDescription
numVoiestreetNumberStreet number
typeVoie + voie (establishments)streetNameStreet type and name (e.g. rue, avenue)
voie (company address)streetNameStreet name
complementLocalisation(in fullAddress)Additional location detail
distributionSpeciale(in fullAddress)Special distribution (e.g. Bâtiment A)
communecityCommune/town name
codePostalpostcode5-digit postal code
payscountryCountry name

​
Implementation Notes

​
Representatives

Representatives are split into corporations (legal entities) and individuals. Each has a role derived from the INPI role code (roleEntreprise), mapped to a French role name. Known mappings include:
CodeRole (French)
53Directeur Général
71Commissaire aux comptes titulaire
99Autre
Other codes (e.g. 13, 28, 29, 30, 40, 51, 65, 70, 72, 73, 75) may appear in data; unmapped codes are returned as “Role” followed by the code. Corporations include SIREN and company name; individuals include name, birth date, and place of residence (city, postcode, country).

​
Establishments

Each company has a principal establishment and zero or more other establishments. Each establishment includes:
  • id: SIRET (14 digits)
  • isPrincipal: true for the principal establishment
  • isActive: false if closure effective date or end-of-activity date is present
  • creationDate / endDate: from establishment activity or registration dates
  • address: same component structure as above (typeVoie + voie for street name)

​
Capital

When capital is present in the registry:
  • totalCapital includes total value, currency, and type (Fixed or Variable from the capitalVariable indicator).
  • The capital array contains nominal value and currency. It is populated only when a capital amount is present.

​
Status details

The status details array includes the number of open establishments and, when present, cessation-related keys (e.g. dissolution indicator, removal date, effective date, liquidation closure date, dissolution type, liquidator appointment publication, principal establishment formality status or closure/transfer dates). Use these for granular visibility into company and establishment status.