---
title: "Get Company 🇫🇷"
method: GET
path: "/companies-fr/{companyId}"
tags: ["Company"]
---

# Get Company 🇫🇷

`GET /companies-fr/{companyId}`

Returns the basic information of the company with french specific data.
\
**Required scopes**: None

## Path parameters

- `companyId` string, required

## Response `200`

The french fetched company

- object
  - `id` string, required — Id of the company.
  - `name` string, required — Name of the company.
  - `country` 'FR' | 'ES' | 'GB', required — Country of the company.
  - `identificationNumber` string, required — Identification number of the company (e.g. SIRET for France, CIF for Spain, ...).
  - `address` string, required — The company's address
  - `city` string, required — The city of the company
  - `postalCode` string, required — The postal code of the company
  - `nbActiveContracts` integer, required — Number of current active contracts within the company.
  - `siren` string, required — "Système Identification Répertoire Entreprises" of the company. Deprecated: use identificationNumber instead (first 9 characters).
  - `siret` string, required — "Système Identification Répertoire Etablissements" of the company. Deprecated: use identificationNumber instead.
  - `healthInsuranceProrationMethod` 'WORKING_DAYS' | 'CALENDAR_DAYS' | 'THIRTY_DAYS' | 'null', nullable, required — The method to prorate the health insurance. This field is set only if the 'health-insurance:read' scope is set.

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `403` — Forbidden
- `404` — Not Found

---

[API](https://skmtc.net/payfit/apis/partner-api.md) · [All operations](https://skmtc.net/payfit/apis/partner-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/payfit/partner-api/revisions/fd1fb9262946/schema)