Carte professionnelle travaux publics

Carte professionnelle d'entrepreneur de travaux publics, délivrée à une entreprise en règle de ses obligations sociales, administratives et juridiques. API incluse par défaut

Logo de FNTP
Fournisseur de la donnée

FNTP

Périmètre

Entreprises ou associations concernées :

Toutes les entreprises de travaux publics sont éligibles à demander une carte professionnelle à la FNTP.
Au mois d’avril 2022, 7400 entreprises possédaient une carte professionnelle.

ℹ️ Plus d’informations sur le site de la FNTP

Cas d'usages

Fiches pratiques et cas d'usages pour lesquels l'API est utile :

Détails de l'API

Format de l'information

  • URL vers le document en PDF

Identifiant d'appel

  • Numéro de SIREN de l'entreprise

Disponibilité

Loading...
 Page de statut des API (nouvelle fenêtre)
Disponible 24h/24 et 7j/7

Limite d'appels

50 requêtes / minute
(partagé entre API du groupe)

Spécifications techniques :

Consulter le swagger Cas de tests (nouvelle fenêtre)

Les données

Cette API délivre la carte professionnelle de travaux publics d’une entreprise, au format PDF, lorsque cette dernière est à jour de ses cotisations professionnelles Travaux Publics auprès de sa caisse de congés payés.

Exemple d’attestation PDF :

Télécharger un exemple de carte professionnelle FNTP PDF – 623 Ko

Informations renvoyées en JSON :

Aperçu d'un exemple de réponse JSON
Lien vers la carte professionnelle
ex: https://raw.githubusercontent.com/datagouv/apistration/refs/heads/develop/mocks/payloads/api_entreprise_v3_fntp_carte_professionnelle_travaux_publics/carte_professionnelle_tp_test.pdf
Ce document est automatiquement supprimé au bout de 3 mois.
Expires in
ex: 7889238
Nombre de secondes avant l'expiration de l'url associée à l'attribut document_url : cette durée correspond généralement à 24h.

Erreurs spécifiques

Lorsque l'API ne peut pas retourner les informations demandées, un message d'erreur est transmis.

Les erreurs, spécifiques à cette API et au fournisseur de données FNTP, sont listées ici :

  • Fichier renvoyé par le fournisseur de données non valide ( #12056 ) : Le fichier renvoyé par le fournisseur de données est vide
  • Erreur réseau du service d'hébergement de données ( #00502 ) : Problème de connexion au serveur d'hébergement de données. L'erreur peut venir soit du fournisseur, soit de API Entreprise

L'intégralité des messages d'erreurs relatifs à cette API est consultable dans la documentation technique.

Conditions d'utilisation des données

Utilisation possible de la donnée :

Publique

Conditions générales :

Cette API et l'utilisation de ses données est soumise aux CGU générales d'API Entreprise, dont voici les principaux éléments auxquels vous vous engagez :

  • ne demander que les données strictement nécessaires ;
  • ne pas utiliser votre jeton d'accès pour une démarche différente de celle indiquée lors de votre demande (le cas échéant le jeton sera révoqué) ;
  • présenter les données obtenues uniquement aux seuls agents habilités et à tracer l'accès de ces agents aux données ;
  • ne pas commercialiser les données reçues et à ne pas les communiquer à des tiers en dehors des cas prévus par la loi.

L'ensemble des conditions sont consultables et téléchargeables ci-dessous :

CGU API Entreprise

Cas d'usages

Fiches pratiques et cas d'usages pour lesquels l'API est utile :

Détails de l'API

Format de l'information

  • URL vers le document en PDF

Identifiant d'appel

  • Numéro de SIREN de l'entreprise

Disponibilité

Loading...
 Page de statut des API (nouvelle fenêtre)
Disponible 24h/24 et 7j/7

Limite d'appels

50 requêtes / minute
(partagé entre API du groupe)

Spécifications techniques :

Consulter le swagger Cas de tests (nouvelle fenêtre)