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.
curl -G "https://api.servicestamp.fr/v1/service-history" \
-d vin=WVWZZZCDZKW417382 \
-H "x-api-key: YOUR_API_KEY"
{
"success": true,
"result": {
"vehicle_identification_number": "WVWZZZCDZKW417382",
"service_events": [
{
"date_of_service_event": "2024-09-12",
"service_provider": "Concession Volkswagen agréée",
"mileage_observed": 45230,
"mileage_unit": "km"
}
]
}
}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.
Vérifiez chaque reprise dès son estimation : les enregistrements d'entretien arrivent automatiquement dans votre DMS ou votre outil de gestion de stock.
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.
Ajoutez à la page de chaque lot l'historique d'entretien du constructeur, pour que les acheteurs le voient avant l'ouverture des enchères.
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.
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.
Une requête authentifiée par véhicule, avec votre clé dans l'en-tête x-api-key.
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.
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" }
]
}
]
}
}| Champ | Signification |
|---|---|
| date_of_service_event | Quand l'entretien a été effectué |
| service_provider | Le concessionnaire qui a effectué les travaux |
| mileage_observed / mileage_unit | Kilométrage lors du passage en atelier, en km ou en mi |
| service_type | Le type de passage en atelier |
| service_items | Chaque travail effectué, avec sa catégorie |
| report_url | Le 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.
Vous ne payez que lorsque des enregistrements reviennent.
| Code | Signification |
|---|---|
| 200 | Enregistrements trouvés. 3,99 € sont débités de votre solde API, ou 2,99 € avec le forfait mensuel. |
| 202 | Le 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. |
| 204 | Aucun enregistrement d'entretien du constructeur pour ce véhicule. Rien n'est facturé. |
| 400 | VIN non valide. |
| 401 | La clé API est absente, non valide ou a été révoquée. |
| 402 | Votre solde API est épuisé. Rechargez-le dans votre tableau de bord professionnel. |
| 403 | L'accès à l'API est désactivé ou le compte professionnel n'est pas actif. |
| 404 | Aucun véhicule trouvé pour ce VIN. Rien n'est facturé. |
| 429 | Trop de requêtes. Ralentissez et réessayez après le délai indiqué dans l'en-tête Retry-After. |
| 503 | L'interrogation n'a pas pu être menée à bien de notre côté. Réessayez plus tard. Rien n'est facturé. |
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.
| Poste | Prix |
|---|---|
| Interrogation avec enregistrements, paiement à l'interrogation | 3,99 € |
| Forfait mensuel de l'API (facultatif) | 59,99 € par mois |
| Interrogation avec enregistrements, avec le forfait mensuel | 2,99 € |
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.
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.
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.
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.
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.
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.
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é.
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.
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.
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.
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.
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.
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.
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.
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
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.