GET /api/v1/etablissements/exercices/:siret
Les trois derniers exercices d'une entreprise

Le json renvoyé contient la clé exercices. Cette clé contient un tableau contenant 1 à 3 exercices. La structure des données est la même que dans l’exemple.

Ce sont les trois derniers exercices, pas forcement les exercices des trois dernières années. Il peut y avoir plusieurs exercices en une année.

Errors

Code Description
401 Le jeton d'authentification est manquant
422 Une erreur s'est produite lors de la récupération des exercices, ou des paramètres sont manquants

Metadata

:champs:
  :exercices:
    :ca:
      :source: DGFiP
      :length: ''
    :dateFinExercice:
      :source: DGFiP
      :length: ''
    :date_fin_exercice_timestamp:
      :source: DGFiP
      :length: ''

Examples

curl 'https://apientreprise.fr/api/v1/etablissements/exercices/41816609600069?token=OraehahG8Uunahligh3thaez&user_id=mon_user'

{
 "exercices":[
    {
       "ca":"21009417",
       "dateFinExercice":"2013-12-31T00:00:00+01:00",
       "date_fin_exercice_timestamp": 1388444400
    },
    {
       "ca":"18968298",
       "dateFinExercice":"2012-12-31T00:00:00+01:00",
       "date_fin_exercice_timestamp": 1356908400
    },
    {
       "ca":"17768838",
       "dateFinExercice":"2011-12-31T00:00:00+01:00",
       "date_fin_exercice_timestamp": 1325286000
    }
 ]
}

Params

Param name Description
siret
required

Le numéro de siret de l’entreprise. Ce numéro de siret doit être passé dans l’url.

Validations:

  • Must be a String

user_id
required

Le user_id est l’identifiant de l’utilisateur physique qui a fait l’appel. Par exemple sur une place de marché utilisant MPS ça sera un identifiant de l’acheteur public qui consulte la pièce. Il servira en cas d’utilisation anormal de l’API pour remonter à la source et vérifier que l’utilisateur avait bien le droit d’accéder à cette donnée. C’est grâce à lui que vous pourrez répondre à la question “Est-ce que l’utilisateur qui a utilisé l’api avec tel user_id à telle heure avait bien le droit de le faire”

Validations:

  • Must be a String

email
optional

Usage interne. L’email de l’utilisateur effectuant la demande enregistré auprès de la DGFIP, optionnel si l’email est enregistré.

Validations:

  • Must be a String