> ## 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.

# France (FR)

> Country guide for France company data including registry information, identifiers (SIREN, SIRET), legal forms, status codes, APE activities, and implementation notes.

## Overview

<CardGroup cols={2}>
  <Card title="Registry" icon="building-columns">
    **RNE** (Registre National des Entreprises)

    Official company registry of France
  </Card>
</CardGroup>

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

| Identifier | Format                             | Example          | Notes                                                                                |
| ---------- | ---------------------------------- | ---------------- | ------------------------------------------------------------------------------------ |
| SIREN      | 9-digit numeric                    | `325013555`      | Primary company identifier; used for search and profile requests                     |
| SIRET      | 14-digit numeric (9 SIREN + 5 NIC) | `32501355500012` | Identifies each establishment (principal and secondary); NIC is establishment number |
| VAT Number | FR + digits                        | `FR12345678901`  | European VAT identifier                                                              |

## Search Capabilities

| Search Method                         | Supported |
| ------------------------------------- | --------- |
| Search by registration number (SIREN) | Yes       |
| Search by company name                | Yes       |

## Data Availability

| Data Point         | Available |
| ------------------ | --------- |
| Company Name       | Yes       |
| Registered Address | Yes       |
| Legal Form         | Yes       |
| Registration Date  | Yes       |
| Status             | Yes       |
| Representatives    | Yes       |
| Shareholders       | Yes       |
| Share Capital      | Yes       |
| Establishments     | Yes       |
| UBOs               | No        |

## Legal Forms

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.

<AccordionGroup>
  <Accordion title="Common legal form codes">
    | Code | Description                                                          |
    | ---- | -------------------------------------------------------------------- |
    | 5710 | SAS, société par actions simplifiée (Simplified Joint Stock Company) |

    Other numeric codes (e.g. 5202, 5499, 5599, 6220, 6540, 6565, 6599) may appear in data; the full list is maintained by INSEE. Occasionally the source may provide a text description (e.g. Société en nom collectif) instead of a code.
  </Accordion>
</AccordionGroup>

## Status Codes

Status is derived from cessation and dissolution indicators in the registry. Normalized values are **Active**, **Distressed**, or **Inactive**.

| Condition                                                                                                              | Normalized Status |
| ---------------------------------------------------------------------------------------------------------------------- | ----------------- |
| No cessation details, or dissolution false and no dissolution/disappearance date                                       | Active            |
| 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 complete | Inactive          |

<Info>
  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.
</Info>

## Activity Codes

France uses **APE** (Activité Principale Exercée), aligned with **NAF rev. 2**, for business activity classification.

| Field       | Description          | Notes                                                                       |
| ----------- | -------------------- | --------------------------------------------------------------------------- |
| code        | APE/NAF code         | Company-level code is the primary activity                                  |
| description | Activity description | From company objet or establishment description                             |
| type        | Primary or Secondary | Primary = 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:**

```text theme={null}
12, rue de la Paix, 75002 Paris, France
```

### Address Components

| Source Component                 | Maps To          | Description                             |
| -------------------------------- | ---------------- | --------------------------------------- |
| numVoie                          | streetNumber     | Street number                           |
| typeVoie + voie (establishments) | streetName       | Street type and name (e.g. rue, avenue) |
| voie (company address)           | streetName       | Street name                             |
| complementLocalisation           | (in fullAddress) | Additional location detail              |
| distributionSpeciale             | (in fullAddress) | Special distribution (e.g. Bâtiment A)  |
| commune                          | city             | Commune/town name                       |
| codePostal                       | postcode         | 5-digit postal code                     |
| pays                             | country          | Country 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:

| Code | Role (French)                     |
| ---- | --------------------------------- |
| 53   | Directeur Général                 |
| 71   | Commissaire aux comptes titulaire |
| 99   | Autre                             |

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.
