# searchFrenchCompanies

**Identifier:** `rechercheentreprises_searchFrenchCompanies`

**Provider:** [Recherche d'entreprises](https://kirha.com/providers/rechercheentreprises.md)

Search French companies, associations and public bodies in the official government register by name, director name or address, with filters on activity code, department, postcode and status. Returns the SIREN, status, size and latest revenue. Use it to find or screen a French company for free; getFrenchCompany gives its directors.

## Run it with the CLI

```bash
kirha tools run rechercheentreprises_searchFrenchCompanies \
  --input '{}'
```

`--input` takes a JSON object that matches the input schema. Pass `--input -` to read it from stdin.

## Call it over HTTP

```bash
curl https://api.kirha.com/tools/v1/execute \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: **********' \
  --data '{
  "tool_name": "rechercheentreprises_searchFrenchCompanies",
  "input": {}
}'
```

Replace the stars with an API key from https://app.kirha.com/api-keys.

## Input schema

```json
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "activeOnly": {
      "type": "boolean"
    },
    "department": {
      "description": "e.g., 75, 2A, 974",
      "pattern": "^(\\d{2,3}|2[AB])$",
      "type": "string"
    },
    "limit": {
      "default": 10,
      "maximum": 25,
      "minimum": 1,
      "type": "integer"
    },
    "maxRevenueEur": {
      "maximum": 9007199254740991,
      "minimum": 0,
      "type": "integer"
    },
    "minRevenueEur": {
      "maximum": 9007199254740991,
      "minimum": 0,
      "type": "integer"
    },
    "nafCode": {
      "description": "Activity code, e.g., 62.01Z",
      "pattern": "^\\d{2}\\.\\d{2}[A-Z]$",
      "type": "string"
    },
    "page": {
      "default": 1,
      "maximum": 400,
      "minimum": 1,
      "type": "integer"
    },
    "postalCode": {
      "pattern": "^\\d{5}$",
      "type": "string"
    },
    "query": {
      "description": "Company name, director name, address or SIREN",
      "minLength": 2,
      "type": "string"
    }
  },
  "type": "object"
}
```

## Output schema

```json
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "additionalProperties": false,
  "properties": {
    "companies": {
      "items": {
        "additionalProperties": false,
        "properties": {
          "active": {
            "type": "boolean"
          },
          "closedOn": {
            "type": "string"
          },
          "createdOn": {
            "type": "string"
          },
          "financialYear": {
            "type": "string"
          },
          "headOfficeAddress": {
            "type": "string"
          },
          "headOfficeSiret": {
            "type": "string"
          },
          "nafCode": {
            "type": "string"
          },
          "name": {
            "type": "string"
          },
          "netIncomeEur": {
            "type": "number"
          },
          "revenueEur": {
            "type": "number"
          },
          "siren": {
            "type": "string"
          },
          "sizeCategory": {
            "type": "string"
          },
          "workforce": {
            "type": "string"
          }
        },
        "required": [
          "siren",
          "active"
        ],
        "type": "object"
      },
      "type": "array"
    },
    "context": {
      "type": "string"
    },
    "sirens": {
      "items": {
        "type": "string"
      },
      "type": "array"
    },
    "total": {
      "type": "number"
    }
  },
  "required": [
    "context",
    "total",
    "companies",
    "sirens"
  ],
  "type": "object"
}
```

## Related tools

Other Recherche d'entreprises tools that this tool refers to, or that refer to it.

- [`getFrenchCompany`](https://kirha.com/providers/rechercheentreprises/getFrenchCompany.md)

-----

[All Recherche d'entreprises tools](https://kirha.com/providers/rechercheentreprises.md) · [< Back to tools list](https://kirha.com/tools.md)