# searchTransparenceSanteCompanies

**Identifier:** `transparencesante_searchTransparenceSanteCompanies`

**Provider:** [TransparenceSante](https://kirha.com/providers/transparencesante.md)

Find companies declaring links of interest in the French Transparence Santé database (benefits, agreements and remunerations given to health professionals), ranked by total declared amount. Returns SIREN numbers to filter searchTransparenceSanteBeneficiaries and getTransparenceSanteCompanyTotals, and to join with French company registries. A group often declares under several entities (e.g. Sanofi Winthrop Industrie, Sanofi-Aventis France).

## Run it with the CLI

```bash
kirha tools run transparencesante_searchTransparenceSanteCompanies \
  --input '{
    "companyName": "Sanofi"
  }'
```

`--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": "transparencesante_searchTransparenceSanteCompanies",
  "input": {
    "companyName": "Sanofi"
  }
}'
```

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": {
    "companyName": {
      "description": "e.g. Sanofi, Novartis, Medtronic",
      "minLength": 2,
      "type": "string"
    },
    "limit": {
      "default": 10,
      "maximum": 25,
      "minimum": 1,
      "type": "integer"
    }
  },
  "required": [
    "companyName"
  ],
  "type": "object"
}
```

## Output schema

```json
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "additionalProperties": false,
  "properties": {
    "companies": {
      "items": {
        "additionalProperties": false,
        "properties": {
          "companyId": {
            "description": "Transparence Santé declaring entity ID",
            "type": "string"
          },
          "companyName": {
            "type": "string"
          },
          "country": {
            "type": "string"
          },
          "declarations": {
            "type": "number"
          },
          "sector": {
            "type": "string"
          },
          "siren": {
            "type": "string"
          },
          "totalAmount": {
            "type": "number"
          }
        },
        "required": [
          "companyId",
          "companyName",
          "declarations",
          "totalAmount"
        ],
        "type": "object"
      },
      "type": "array"
    },
    "context": {
      "type": "string"
    },
    "sirens": {
      "items": {
        "type": "string"
      },
      "type": "array"
    }
  },
  "required": [
    "context",
    "companies",
    "sirens"
  ],
  "type": "object"
}
```

## Related tools

Other TransparenceSante tools that this tool refers to, or that refer to it.

- [`getTransparenceSanteCompanyTotals`](https://kirha.com/providers/transparencesante/getTransparenceSanteCompanyTotals.md)
- [`searchTransparenceSanteBeneficiaries`](https://kirha.com/providers/transparencesante/searchTransparenceSanteBeneficiaries.md)

-----

[All TransparenceSante tools](https://kirha.com/providers/transparencesante.md) · [< Back to tools list](https://kirha.com/tools.md)