> For the complete documentation index, see [llms.txt](https://developers.mobilic.beta.gouv.fr/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://developers.mobilic.beta.gouv.fr/certificat-mobilic.md).

# Certificat Mobilic

Il est possible, via un appel API, de savoir si une entreprise a obtenu le certificat Mobilic ([en savoir plus sur le certificat et sur les critères d'obtention](https://faq.mobilic.beta.gouv.fr/usages-et-fonctionnement-de-mobilic-gestionnaire/comment-obtenir-le-certificat-mobilic)).

Ce service est disponible pour les plateformes de mise en relation entre entreprises et particuliers, ou tout autre acteur regroupant les entreprises concernées par l'utilisation de Mobilic sur son site.

## Processus

Si vous souhaitez interroger notre API pour connaître l'état de certification d'une société dans Mobilic, contactez-nous pour obtenir une clé unique à l'adresse suivante : <interfacage@mobilic.beta.gouv.fr>.

Une fois que vous aurez récupéré la clé, vous pourrez interroger notre API, pour un SIREN donné, afin de savoir si une entreprise est certifiée ou non :&#x20;

### Exemple d'appel

```
HTTP POST : https://api.mobilic.beta.gouv.fr/companies/is_company_certified

Body : { "siren": "812773281"}

HEADER : X-MOBILIC-CERTIFICATION-KEY : "clé unique donnée par l'équipe Mobilic."
```

### Exemples de retour

Dans le cas où une entreprise a deux établissements certifiés dans Mobilic :

```json
[
    {
        "certification_attribution_date": "2023/01/01",
        "certification_expiration_date": "2023/06/30",
        "siren": "812773281",
        "siret": "00001"
    },
    {
        "certification_attribution_date": "2023/04/01",
        "certification_expiration_date": "2023/10/30",
        "siren": "812773281",
        "siret": "00002"
    }]

```

Dans le cas où une entreprise n'est pas certifiée dans Mobilic, n'est pas inscrite dans Mobilic ou a refusé de partager ses informations sur son certificat, l'API renvoie une liste vide :

```
[]
```

## Fréquence de mise à jour

Les certificats sont recalculés au début de chaque mois et sont valables pour un durée de 6 mois.

Il n'est donc pas nécessaire, ni recommandé, d'appeler notre API plusieurs fois par mois pour le même SIREN.