---
title: "Consulter l’entreprise"
description: "Renvoie l’entreprise de la clé d’API : raison sociale, SIREN, code APE, convention collective (IDCC `1486`, Syntec), siège, effectifs moyens annuels, modules activés et règles de paie (en vigueur à la fin du mois courant).\n\nLes modules indiquent les données saisies dans Puncto : sans `isTimesheetEnabled`, par exemple, aucune feuille de temps n’est créée."
---

> Documentation Index
> Fetch the complete documentation index at: https://docs.puncto.fr/llms.txt
> Use this file to discover all available pages before exploring further.

Path: API Puncto › Entreprise

`GET /public/v1/company`

Renvoie l’entreprise de la clé d’API : raison sociale, SIREN, code APE, convention collective (IDCC `1486`, Syntec), siège, effectifs moyens annuels, modules activés et règles de paie (en vigueur à la fin du mois courant).

Les modules indiquent les données saisies dans Puncto : sans `isTimesheetEnabled`, par exemple, aucune feuille de temps n’est créée.

## Authentication

- `bearerAuth`, http, header `Authorization`

## Code samples

### cURL

```bash
curl --request GET \
  --url https://api.puncto.fr/public/v1/company \
  --header 'Authorization: Bearer <token>'
```

### TypeScript

```typescript
const url = 'https://api.puncto.fr/public/v1/company';
const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch(url, options)
  .then(res => res.json())
  .then(json => console.log(json))
  .catch(err => console.error(err));
```

### Python

```python
import requests

url = "https://api.puncto.fr/public/v1/company"

headers = {"Authorization": "Bearer <token>"}

response = requests.get(url, headers=headers)

print(response.text)
```

## Responses

### 200

Entreprise

#### Example

```json
{
  "companyId": "comp_01JB7Q6ZC8V3K9N2M4R5T7W8XY",
  "name": "string",
  "siren": "string",
  "apenCode": "string",
  "codeCcn": "string",
  "companyCreationDate": "2019-08-24",
  "mainEstablishmentId": "esta_01JB7Q6ZC8V3K9N2M4R5T7W8XY",
  "effectifs": [
    {
      "year": 0,
      "effectif": 0
    }
  ],
  "modules": {
    "isForfaitJourDeclarationEnabled": true,
    "isSportSubscriptionEnabled": true,
    "isRemoteWorkEnabled": true,
    "isTimesheetEnabled": true,
    "isProfitSharingEnabled": true,
    "isOnCallEnabled": true
  },
  "payrollRules": {
    "validFrom": "2019-08-24",
    "solidarityDayAsMandatoryHoliday": true,
    "isJei": true,
    "uncappedPaternityComplement": true,
    "ptoEndOfPeriod": {
      "month": 0,
      "day": 0
    },
    "jntEndOfPeriod": {
      "month": 0,
      "day": 0
    },
    "jrttSettings": {
      "method": "MANUAL",
      "accrualTiming": "MONTHLY",
      "amountPerHour": 0
    },
    "overtimeMajorationRates": [
      {
        "rate": 0,
        "fromHour": 0,
        "toHour": 0
      }
    ],
    "forfaitHeureAgreement": {
      "allowNonCadre": true,
      "requiresAnnualSocialSecurityCeiling": true,
      "minimumConventionalSalaryRatio": 0
    }
  },
  "createdAt": "2019-08-24T14:15:22Z",
  "updatedAt": "2019-08-24T14:15:22Z"
}
```

- `companyId` (`getCompany.response.200.companyId`; string, required) — Identifiant Puncto de l'entreprise
- `name` (`getCompany.response.200.name`; string, required) — Raison sociale
- `siren` (`getCompany.response.200.siren`; string, required) — SIREN
- `apenCode` (`getCompany.response.200.apenCode`; string | null, required) — Code APE (NAF) de l'entreprise
- `codeCcn` (`getCompany.response.200.codeCcn`; string, required) — IDCC de la convention collective : `1486`, Syntec
- `companyCreationDate` (`getCompany.response.200.companyCreationDate`; any of, required) — Date de création de l'entreprise
  - any of: `string`, `null`
- `mainEstablishmentId` (`getCompany.response.200.mainEstablishmentId`; any of, required) — Établissement siège, null tant que l'entreprise n'est pas configurée
  - any of: `string`, `null`
- `effectifs` (`getCompany.response.200.effectifs`; array<object>, required) — Effectifs moyens annuels, de l'année la plus récente à la plus ancienne
  - `year` (`getCompany.response.200.effectifs.year`; number, required) — Année
  - `effectif` (`getCompany.response.200.effectifs.effectif`; number, required) — Effectif moyen de l'année
- `modules` (`getCompany.response.200.modules`; object, required) — Modules optionnels activés
  - `isForfaitJourDeclarationEnabled` (`getCompany.response.200.modules.isForfaitJourDeclarationEnabled`; boolean, required) — Relevés mensuels de suivi du forfait jours
  - `isSportSubscriptionEnabled` (`getCompany.response.200.modules.isSportSubscriptionEnabled`; boolean, required) — Prise en charge des abonnements sportifs
  - `isRemoteWorkEnabled` (`getCompany.response.200.modules.isRemoteWorkEnabled`; boolean, required) — Déclaration des jours de télétravail par les collaborateurs
  - `isTimesheetEnabled` (`getCompany.response.200.modules.isTimesheetEnabled`; boolean, required) — Feuilles de temps hebdomadaires
  - `isProfitSharingEnabled` (`getCompany.response.200.modules.isProfitSharingEnabled`; boolean, required) — Intéressement
  - `isOnCallEnabled` (`getCompany.response.200.modules.isOnCallEnabled`; boolean, required) — Astreintes
- `payrollRules` (`getCompany.response.200.payrollRules`; object, required) — Règles de paie en vigueur
  - `validFrom` (`getCompany.response.200.payrollRules.validFrom`; string, required) — Date d'entrée en vigueur de ces règles
    - format `date`
  - `solidarityDayAsMandatoryHoliday` (`getCompany.response.200.payrollRules.solidarityDayAsMandatoryHoliday`; boolean, required) — Forfaits jours : la journée de solidarité est obligatoirement chômée
  - `isJei` (`getCompany.response.200.payrollRules.isJei`; boolean, required) — L'entreprise a le statut de Jeune Entreprise Innovante
  - `uncappedPaternityComplement` (`getCompany.response.200.payrollRules.uncappedPaternityComplement`; boolean, required) — Le complément employeur du congé de paternité est versé sans les plafonds Syntec : salaire maintenu comme pour un arrêt maladie, sous déduction des IJSS
  - `ptoEndOfPeriod` (`getCompany.response.200.payrollRules.ptoEndOfPeriod`; any of, required) — Dernier jour de la période de référence des congés payés, null pour le 31 mai
    - any of: `DateWithoutYear`, `null`
  - `jntEndOfPeriod` (`getCompany.response.200.payrollRules.jntEndOfPeriod`; any of, required) — Dernier jour de la période des jours non travaillés (forfait jours), null pour le 31 décembre
    - any of: `DateWithoutYear`, `null`
  - `jrttSettings` (`getCompany.response.200.payrollRules.jrttSettings`; any of, required) — Acquisition de JRTT, null quand l'entreprise n'en attribue pas
    - any of: `PublicApiCompanyJrttSettings`, `null`
  - `overtimeMajorationRates` (`getCompany.response.200.payrollRules.overtimeMajorationRates`; any of, required) — Taux de majoration des heures supplémentaires de l'entreprise, null pour les taux légaux
    - any of: `array<unknown>`, `null`
  - `forfaitHeureAgreement` (`getCompany.response.200.payrollRules.forfaitHeureAgreement`; any of, required) — Accord de forfait en heures, null pour les conditions de la modalité 2 Syntec
    - any of: `PublicApiCompanyForfaitHeureAgreement`, `null`
- `createdAt` (`getCompany.response.200.createdAt`; string, required) — Date d'enregistrement de l'entreprise dans Puncto
  - format `date-time`
- `updatedAt` (`getCompany.response.200.updatedAt`; string, required) — Date de dernière modification de l'entreprise
  - format `date-time`

### 401

Clé d’API absente, invalide ou révoquée

#### Example

```json
{
  "error": "Les endpoints de l’API publique sont réservés aux comptes application."
}
```

- `error` (`getCompany.response.401.error`; string, required) — Message lisible, en français.
- `errorCode` (`getCompany.response.401.errorCode`; string, optional) — Code stable, sur certaines erreurs.

### 403

Opération hors de l’accès de la clé d’API

#### Example

```json
{
  "error": "Opération interdite"
}
```

- `error` (`getCompany.response.403.error`; string, required) — Message lisible, en français.
- `errorCode` (`getCompany.response.403.errorCode`; string, optional) — Code stable, sur certaines erreurs.


Source: https://docs.puncto.fr/reference/company/retrieve/index.md
