Skip to content
Navigation

Lister les établissements

Liste les établissements, du plus ancien au plus récent, avec SIRET, codes et adresse. Les contrats, avenants et mois de paie y renvoient par establishmentId.

GET
https://api.puncto.fr/public/v1/establishments

Authentification

  • bearerAuth
    HTTP
    requis

Query parameters

  • page
    optionnel
    integer

    Numéro de page, à partir de 1.

    minimum: 1 · default: 1
  • perPage
    optionnel
    integer

    Nombre d’éléments par page, 200 au plus.

    maximum: 200 · minimum: 1 · default: 50

Retour

200

Page d’établissements

JSON
  • data
    tableau de
    object
    requis
    • establishmentId
      string
      requis

      Identifiant Puncto de l'établissement

    • name
      string
      requis

      Nom de l'établissement

    • nic
      string
      requis

      NIC : les 5 derniers chiffres du SIRET

    • siret
      string
      requis

      SIRET : SIREN de l'entreprise suivi du NIC

    • apetCode
      string
      requis

      Code APET de l'établissement

    • urssafCode
      string
      requis

      Code Urssaf de l'établissement

    • healthServiceCode
      string | null
      requis

      Code du service de santé au travail, déclaré dans les DPAE

    • address
      object
      requis

      Adresse de l'établissement

      • id
        string
        requis

        Identifiant Puncto

      • address
        string
        requis
      • postalCode
        string
        requis
      • city
        string
        requis
      • addressDetails
        string | null
        requis
      • countryCode
        FR
        ou
        GP
        ou
        BL
        ou
        MF
        ou
        MQ
        ou
        GF
        +199 de plus
        requis
    • isMain
      boolean
      requis

      Établissement siège de l'entreprise

    • createdAt
      string
      requis

      Date d'enregistrement de l'établissement dans Puncto

      format: date-time
    • updatedAt
      string
      requis

      Date de dernière modification de l'établissement

      format: date-time
  • meta
    object
    requis
    • total
      integer
      requis

      Nombre total d’éléments.

    • page
      integer
      requis

      Page renvoyée.

    • perPage
      integer
      requis
    • currentPage
      integer
      requis
    • firstPage
      integer
      requis
    • lastPage
      integer
      requis

401

Clé d’API absente, invalide ou révoquée
JSON
  • error
    string
    requis

    Message lisible, en français.

  • errorCode
    optionnel
    string

    Code stable, sur certaines erreurs.

403

Opération hors de l’accès de la clé d’API
JSON
  • error
    string
    requis

    Message lisible, en français.

  • errorCode
    optionnel
    string

    Code stable, sur certaines erreurs.

422

Paramètres invalides
JSON
  • errors
    tableau de
    object
    requis
    • message
      string
      requis
    • rule
      string
      requis

      Règle de validation en échec.

    • field
      string
      requis

      Chemin du champ, par exemple absences.0.type.

Type to search…

↑↓ navigate↵ selectEsc close