API historique d'entretien pour concessionnaires et professionnels

Lancez les vérifications d'historique d'entretien directement depuis vos systèmes. Envoyez un VIN et recevez les interventions enregistrées par le réseau des concessionnaires officiels du constructeur en JSON structuré. 3,99 € par interrogation avec enregistrements, ou 2,99 € avec le forfait mensuel à 59,99 € par mois.

  • Interrogation par VIN
  • Enregistrements des concessionnaires officiels pour 40 marques
  • 3,99 € par interrogation avec enregistrements, débités d'un solde rechargé à l'avance ; 2,99 € avec le forfait mensuel
  • Aucun enregistrement, aucun frais

Ce que vous pouvez construire

Mettez l'historique d'entretien du constructeur là où votre équipe et vos acheteurs regardent déjà, sans que personne ne lance les vérifications à la main.

Reprises et DMS

Vérifiez chaque reprise dès son estimation : les enregistrements d'entretien arrivent automatiquement dans votre DMS ou votre outil de gestion de stock.

Site web et annonces

Affichez l'historique d'entretien vérifié sur les pages de vos véhicules : le nombre d'entretiens en concession, la date du dernier entretien et le kilométrage.

Plateformes d'enchères et de remarketing

Ajoutez à la page de chaque lot l'historique d'entretien du constructeur, pour que les acheteurs le voient avant l'ouverture des enchères.

Flottes et retours de leasing

En fin de contrat, vérifiez l'entretien de tous les véhicules restitués en une seule passe, sans saisir chaque véhicule un par un.

Comment ça marche

  1. Obtenez votre clé API

    L'accès à l'API fait partie d'un compte professionnel approuvé. Contactez-nous et nous l'activons. Vous rechargez ensuite votre solde et créez vos clés dans votre tableau de bord professionnel. Le forfait mensuel est facultatif.

  2. Envoyez le VIN

    Une requête authentifiée par véhicule, avec votre clé dans l'en-tête x-api-key.

  3. Recevez les enregistrements structurés

    Chaque entretien en concession revient avec sa date, le kilométrage, le concessionnaire qui l'a effectué et les travaux réalisés, plus un lien vers le rapport ServiceStamp complet.

Exemple de requête et de réponse

Une requête par véhicule. Chaque entretien en concession enregistré par le constructeur revient dans service_events.

URL de base : https://api.servicestamp.fr/v1. Les mêmes points de terminaison répondent aussi sur https://servicestamp.fr/api/v1.

Requête

curl -G "https://api.servicestamp.fr/v1/service-history" \
  -d vin=WVWZZZCDZKW417382 \
  -H "x-api-key: YOUR_API_KEY"

Réponse

{
  "success": true,
  "result": {
    "report_id": "rpt_8Kq2vX",
    "report_url": "https://servicestamp.fr/report/rpt_8Kq2vX",
    "vehicle_identification_number": "WVWZZZCDZKW417382",
    "registration_mark": null,
    "vehicle": { "make": "Volkswagen", "model": "Golf", "year": 2019, "fuel_type": "Petrol" },
    "service_events": [
      {
        "date_of_service_event": "2024-09-12",
        "service_provider": "Concession Volkswagen agréée",
        "mileage_observed": 45230,
        "mileage_unit": "km",
        "service_type": "serviceVisit",
        "service_items": [
          { "item_type": "Service", "item_description": "Vidange et remplacement du filtre à huile" },
          { "item_type": "Inspection", "item_description": "Contrôle multi-points complet" }
        ]
      }
    ]
  }
}

Ce que contient chaque enregistrement

ChampSignification
date_of_service_eventQuand l'entretien a été effectué
service_providerLe concessionnaire qui a effectué les travaux
mileage_observed / mileage_unitKilométrage lors du passage en atelier, en km ou en mi
service_typeLe type de passage en atelier
service_itemsChaque travail effectué, avec sa catégorie
report_urlLe rapport ServiceStamp complet avec l'évolution du kilométrage, à partager avec les acheteurs ou à télécharger en PDF

Une valeur que nous n'avons pas revient comme null et ne manque jamais : certains constructeurs n'envoient ni l'unité du kilométrage ni la catégorie du travail.

Codes de réponse

Vous ne payez que lorsque des enregistrements reviennent.

CodeSignification
200Enregistrements trouvés. 3,99 € sont débités de votre solde API, ou 2,99 € avec le forfait mensuel.
202Le système du constructeur travaille encore. Réessayez après le délai indiqué dans l'en-tête Retry-After. Vous ne payez que lorsque des enregistrements reviennent.
204Aucun enregistrement d'entretien du constructeur pour ce véhicule. Rien n'est facturé.
400VIN non valide.
401La clé API est absente, non valide ou a été révoquée.
402Votre solde API est épuisé. Rechargez-le dans votre tableau de bord professionnel.
403L'accès à l'API est désactivé ou le compte professionnel n'est pas actif.
404Aucun véhicule trouvé pour ce VIN. Rien n'est facturé.
429Trop de requêtes. Ralentissez et réessayez après le délai indiqué dans l'en-tête Retry-After.
503L'interrogation n'a pas pu être menée à bien de notre côté. Réessayez plus tard. Rien n'est facturé.

Tarifs : paiement à l'interrogation, moins avec le forfait mensuel

Les interrogations sont débitées d'un solde rechargé à l'avance, à 3,99 € chacune et seulement lorsque des enregistrements reviennent. Le forfait mensuel facultatif à 59,99 € par mois ramène ce prix à 2,99 €, devient avantageux à partir de 60 interrogations par mois et peut être résilié à tout moment. Rechargez votre solde à partir de 50,00 € par carte dans votre tableau de bord.

PostePrix
Interrogation avec enregistrements, paiement à l'interrogation3,99 €
Forfait mensuel de l'API (facultatif)59,99 € par mois
Interrogation avec enregistrements, avec le forfait mensuel2,99 €

Aucun enregistrement, aucun frais

Une interrogation qui ne trouve aucun enregistrement d'entretien du constructeur ne coûte rien, exactement comme les vérifications que vous lancez en tant que professionnel depuis votre tableau de bord.

Réessayer est gratuit

Une réponse « traitement en cours » n'est jamais facturée. Interrogez de nouveau quand le résultat est prêt et vous payez une seule fois.

Ce qui est couvert

L'API fournit les interventions enregistrées par le réseau des concessionnaires officiels des constructeurs pour 40 marques, pour les véhicules à partir de l'année-modèle 2012. Le niveau de détail d'un enregistrement dépend du constructeur.

Les enregistrements proviennent des systèmes des constructeurs et montrent donc l'entretien effectué chez les concessionnaires officiels. Les travaux effectués hors du réseau officiel ne sont pas enregistrés dans ces systèmes. La couverture de chaque marque est sur la page des constructeurs.

Questions fréquentes sur l'API historique d'entretien

Qui peut utiliser l'API historique d'entretien ?

L'accès à l'API est ouvert aux comptes professionnels ServiceStamp approuvés. Dites-nous ce que vous développez et nous l'activons. Vous rechargez ensuite votre solde et créez et gérez vos clés de production et de test dans votre tableau de bord professionnel. Le forfait mensuel est facultatif : il réduit le prix par interrogation.

Ai-je besoin du VIN ?

Oui. Envoyez le VIN à 17 caractères. L'API ne recherche pas un véhicule à partir de sa plaque d'immatriculation : avec la seule immatriculation, aucune interrogation n'est possible.

En combien de temps les résultats arrivent-ils ?

Les interrogations aboutissent en général en un seul appel. Si le système d'un constructeur a besoin de plus de temps, vous recevez une réponse 202 avec un en-tête Retry-After. Interrogez de nouveau après ce délai : votre appel interroge à nouveau le constructeur, peut prendre quelques secondes, et vous ne payez qu'une seule fois.

Combien coûte l'API ?

3,99 € pour chaque interrogation avec enregistrements, débités d'un solde que vous rechargez par carte dans votre tableau de bord professionnel (de 50,00 € à 10 000,00 € par recharge). Le forfait mensuel facultatif coûte 59,99 € par mois et par compte professionnel et ramène chaque interrogation à 2,99 € : il devient donc avantageux à partir de 60 interrogations par mois. Une interrogation qui ne trouve aucun enregistrement d'entretien du constructeur ne coûte rien, et interroger de nouveau le même véhicule dans les 24 heures est gratuit. Vous pouvez résilier le forfait mensuel à tout moment ; il reste actif jusqu'à la fin du mois déjà payé.

Que se passe-t-il quand mon solde est épuisé ?

Les interrogations de production répondent 402 jusqu'à ce que vous rechargiez votre solde. Nous vous écrivons par e-mail quand le solde passe sous 50,00 €, et de nouveau quand une interrogation est refusée. Les clés de test continuent de fonctionner.

Et si j'interroge deux fois le même véhicule ?

Une seconde interrogation du même véhicule depuis votre compte dans les 24 heures renvoie le rapport que vous avez déjà et n'est pas facturée. C'est aussi pour cela qu'une nouvelle tentative après une réponse 202 n'est jamais facturée deux fois.

Existe-t-il un environnement de test (sandbox) ?

Oui. Demandez une clé de test (elle commence par ss_test_). Elle renvoie un rapport d'exemple pour n'importe quel VIN valide, ne débite jamais votre solde et ne contacte jamais les systèmes des constructeurs. Le VIN TEST0000000000204 renvoie la réponse « aucun enregistrement » et TEST0000000000202 la réponse « traitement en cours », pour que vous puissiez préparer chaque cas avant de passer en production.

Y a-t-il une limite de requêtes ?

Oui, par défaut 60 requêtes par minute et par compte, partagées entre toutes vos clés. Chaque réponse contient les en-têtes X-RateLimit-Limit, X-RateLimit-Remaining et X-RateLimit-Reset. S'il vous en faut plus, dites-le-nous.

L'API vérifie-t-elle le gage, les sinistres ou le vol ?

Non. L'API couvre la vérification d'historique d'entretien : les interventions du réseau des concessionnaires officiels que le constructeur a enregistrées pour un VIN. Elle ne contient ni le statut administratif (gage, opposition), ni les sinistres, ni les données sur les vols.

Les interrogations API apparaissent-elles dans mon tableau de bord professionnel ?

Oui. Chaque interrogation apparaît dans votre tableau de bord professionnel à côté des vérifications que vous lancez depuis celui-ci, pour que toute votre équipe puisse la voir.

Puis-je partager les résultats avec les acheteurs ?

Oui. Chaque réponse contient une report_url vers le rapport ServiceStamp complet, que vous pouvez partager avec un acheteur ou télécharger en PDF.

Prêt à connecter vos systèmes ?

Dites-nous ce que vous développez et combien de véhicules vous vérifiez environ chaque mois, et nous préparons tout pour vous.

Ou par e-mail : hello@servicestamp.fr

Vous achetez ou vendez des véhicules en volume ?

Rapports à partir de 4,99 € au tarif professionnel fixe. Vous bénéficierez d'une assistance personnalisée et d'un espace de travail en équipe. Prix HT.

Demander un compte Professionnel