# AutomotivAPI — Full Documentation for LLMs > B2B automotive data API by SOGEVIA (France). REST/JSON API providing VIN decoding, license plate lookup, vehicle technical specifications, vehicle catalog (trims, options, equipment, manuals), and AI-powered vehicle notice Q&A. Sub-200ms response times. Covers 80+ brands, 900+ models and 45,000+ trims across Europe. Available in French, English and German. Approved by the French Ministry of the Interior for regulated vehicle data transmission. --- ## Overview AutomotivAPI is a comprehensive automotive data platform designed for B2B integrations. It serves insurance companies, dealership management systems (DMS), fleet managers, automotive marketplaces, fintech/leasing companies, and any business needing structured vehicle data at scale. ### Base URL ``` https://api.automotivapi.com/api ``` ### Authentication All requests require an API key passed as a Bearer token in the Authorization header: ``` Authorization: Bearer YOUR_API_KEY ``` ### Response Format All responses are JSON. Every successful response includes a `success` field set to `true` and the relevant data payload. Errors return `success: false` with an `error` object containing a code and message. ### Rate Limits and Performance - Average response time: < 200 ms - Rate limits are defined per contract - All endpoints support HTTPS only --- ## API Service 1: VIN Decoding API **Endpoint:** `GET /vin/{vin}` **Cost:** €3.00 per call (+ €590 excl. VAT one-off setup fee, 500 calls/month minimum) **Documentation:** https://automotivapi.com/en/api-vin Decode any European Vehicle Identification Number (VIN) to retrieve detailed information about the vehicle, including manufacturer, model, trim level, body type, engine specifications, standard equipment and factory options. ### What is returned - Brand / manufacturer name - Model and commercial name - Trim / version designation - Body type (sedan, SUV, hatchback, etc.) - Engine type, fuel, displacement, power (kW and HP) - Transmission type and number of gears - Number of doors and seats - Production year range - Standard equipment list - Factory-fitted options ### Example Request ``` GET https://api.automotivapi.com/api/vin/VF1RFB00X64XXXXXX Authorization: Bearer YOUR_API_KEY ``` ### Example Response ```json { "success": true, "data": { "vin": "VF1RFB00X64XXXXXX", "brand": "RENAULT", "model": "MEGANE", "version": "Megane IV 1.5 dCi 115 Intens", "body_type": "Berline 5 portes", "fuel": "Diesel", "engine_displacement_cc": 1461, "power_kw": 85, "power_hp": 115, "transmission": "Manuelle 6 vitesses", "doors": 5, "seats": 5, "production_start": "2016-01", "production_end": "2020-06", "equipment": [ "Climatisation automatique", "Ecran tactile 8.7 pouces", "Radar de recul", "Camera de recul", "Aide au stationnement avant et arriere" ], "options": [ "Toit ouvrant panoramique", "Pack Easy Park" ] } } ``` ### Use Cases - **Insurance quoting:** Identify exact vehicle specification from a VIN to compute accurate premiums. - **Dealership appraisals:** Instantly retrieve trim and equipment to value trade-in vehicles. - **Fleet management:** Catalog fleet vehicles by decoding VINs during onboarding. - **Vehicle history services:** Enrich vehicle history reports with factory specification data. - **Automotive marketplaces:** Auto-fill listing details when a seller enters a VIN. --- ## API Service 2: License Plate Lookup API **Endpoint:** `GET /immatriculation/{plate}` **Cost:** French data €0.25 per call (base, tiered by monthly volume, 500 calls/month minimum). Other European countries: priced case by case based on volume. + €590 excl. VAT one-off setup fee **Documentation:** https://automotivapi.com/en/api-immatriculation Query a French or European license plate to instantly identify the associated vehicle. Returns the same vehicle identification data as the VIN API, resolved from the national vehicle registration database. ### What is returned - License plate and registration details - Brand, model, trim - First registration date - Fuel type and engine specification - Vehicle category - CO2 emissions (WLTP or NEDC when available) ### Example Request ``` GET https://api.automotivapi.com/api/immatriculation/AB-123-CD Authorization: Bearer YOUR_API_KEY ``` ### Example Response ```json { "success": true, "data": { "plate": "AB-123-CD", "brand": "PEUGEOT", "model": "3008", "version": "3008 II 1.5 BlueHDi 130 Allure", "first_registration_date": "2019-03-15", "fuel": "Diesel", "power_kw": 96, "power_hp": 130, "co2_wltp": 128, "vehicle_category": "M1" } } ``` ### Use Cases - **Insurance onboarding:** Customer enters their plate number, and the system auto-fills vehicle details for a quote. - **Parking and toll systems:** Identify vehicles by plate for automated billing. - **Roadside assistance:** Quickly identify the vehicle model to dispatch the right equipment. - **Law enforcement and compliance:** Verify vehicle registration data. --- ## API Service 3: Technical Specs API **Endpoint:** `GET /fiche-technique/{vehicle_id}` **Cost:** Price on quote based on volume (European VIN, 8 countries). + €590 excl. VAT one-off setup fee, 500 calls/month minimum **Documentation:** https://automotivapi.com/en/api-fiche-technique-vehicule Retrieve the full technical specification sheet for a vehicle, including engine, transmission, performance, dimensions, weight, fuel consumption and emissions data. ### What is returned - Engine: type, fuel, displacement, bore, stroke, compression ratio, power (kW/HP at RPM), torque (Nm at RPM) - Transmission: type, number of gears, drive type (FWD, RWD, AWD) - Performance: top speed, 0-100 km/h acceleration - Dimensions: length, width, height, wheelbase, ground clearance - Weight: curb weight, gross vehicle weight, payload, towing capacity - Fuel consumption: urban, extra-urban, combined (WLTP and/or NEDC) - CO2 emissions: WLTP and/or NEDC - Tank capacity - Tire dimensions - Trunk volume (liters) ### Example Request ``` GET https://api.automotivapi.com/api/fiche-technique/12345 Authorization: Bearer YOUR_API_KEY ``` ### Example Response ```json { "success": true, "data": { "vehicle_id": 12345, "brand": "VOLKSWAGEN", "model": "GOLF", "version": "Golf VIII 2.0 TDI 150 DSG7 Style", "engine": { "fuel": "Diesel", "displacement_cc": 1968, "power_kw": 110, "power_hp": 150, "power_rpm": 3500, "torque_nm": 360, "torque_rpm": 1600, "cylinders": 4, "turbo": true }, "transmission": { "type": "Automatique DSG", "gears": 7, "drive": "Traction avant" }, "performance": { "top_speed_kmh": 224, "acceleration_0_100_s": 8.7 }, "dimensions": { "length_mm": 4284, "width_mm": 1789, "height_mm": 1456, "wheelbase_mm": 2636, "trunk_volume_l": 381 }, "weight": { "curb_weight_kg": 1410, "gross_weight_kg": 1960 }, "consumption": { "combined_wltp_l100km": 4.6, "co2_wltp_gkm": 120 }, "tank_capacity_l": 50 } } ``` ### Use Cases - **Car comparison websites:** Display side-by-side technical specifications. - **Insurance risk models:** Factor in power, weight, and performance data. - **CO2 and emissions compliance:** Track fleet emissions for regulatory reporting. - **Leasing calculators:** Use consumption data for TCO (total cost of ownership) calculations. - **Automotive journalism and content:** Generate spec-rich vehicle reviews. --- ## API Service 4: Vehicle Catalog API **Endpoint:** `GET /catalogue/{path}` **Cost:** Price on quote based on volume. B2B only. + €590 excl. VAT one-off setup fee, 500 calls/month minimum **Documentation:** https://automotivapi.com/en/api-catalogue-vehicule Browse the full vehicle catalog hierarchy: brands, models, generations, trims. For each trim, access standard equipment, optional equipment, vehicle summaries and downloadable user manuals. This is a B2B-only endpoint with a setup fee. ### Catalog Hierarchy 1. **Brands** — List all available brands (e.g., Renault, Peugeot, BMW, Volkswagen...) 2. **Models** — List models for a given brand (e.g., Clio, 308, Serie 3, Golf...) 3. **Generations** — List generations/phases for a model 4. **Trims** — List available trims/versions for a generation 5. **Trim Detail** — Full equipment, options and manual for a specific trim ### What is returned (Trim Detail) - Commercial name and trim designation - Standard equipment grouped by category (safety, comfort, multimedia, exterior, interior) - Optional equipment with descriptions - Vehicle summary (key selling points) - User manual (link to PDF or structured content) ### Example Request ``` GET https://api.automotivapi.com/api/catalogue/brands/renault/models/clio/generations/5/trims/tce-100-intens Authorization: Bearer YOUR_API_KEY ``` ### Example Response ```json { "success": true, "data": { "brand": "RENAULT", "model": "CLIO", "generation": "V (2019-)", "trim": "TCe 100 Intens", "standard_equipment": { "safety": [ "Freinage actif d'urgence", "Alerte de franchissement de ligne", "Reconnaissance des panneaux de signalisation", "Airbags frontaux, lateraux et rideaux" ], "comfort": [ "Climatisation automatique", "Cle mains libres", "Retroviseurs electriques chauffants" ], "multimedia": [ "Ecran tactile Easy Link 9.3 pouces", "Compatibilite Apple CarPlay / Android Auto", "6 haut-parleurs" ], "exterior": [ "Feux Full LED", "Jantes alliage 16 pouces", "Vitres arriere surteintees" ] }, "optional_equipment": [ { "name": "Pack City Plus", "description": "Camera de recul, aide au stationnement avant et arriere, retro int. electrochrome" }, { "name": "Pack Techno", "description": "Ecran conducteur 10 pouces, affichage tete haute, charge smartphone sans fil" } ], "manual_available": true, "manual_url": "https://api.automotivapi.com/api/catalogue/manuals/renault-clio-v" } } ``` ### Use Cases - **Dealership websites:** Display full equipment lists for new and used vehicles. - **Configurators:** Build vehicle configuration tools based on available trims and options. - **Market intelligence:** Analyze competitor offerings across brands and segments. - **After-sales platforms:** Provide users with access to their vehicle's user manual. --- ## API Service 5: AI Vehicle Notice API **Endpoint:** `POST /notice/{vehicle_id}/ask` **Cost:** €0.50 per call (no charge if manual not available). + €590 excl. VAT one-off setup fee, 500 calls/month minimum **Documentation:** https://automotivapi.com/en/api-notice-vehicule Ask natural language questions about a vehicle's user manual. The AI reads the manufacturer's official documentation and returns sourced answers with confidence scores. Ideal for customer support chatbots, after-sales portals, and driver assistance apps. ### What is returned - Natural language answer to the question - Source references (page numbers, section titles from the manual) - Confidence score (0 to 1) - Related suggested questions ### Example Request ``` POST https://api.automotivapi.com/api/notice/12345/ask Authorization: Bearer YOUR_API_KEY Content-Type: application/json { "question": "How do I reset the tire pressure warning light?" } ``` ### Example Response ```json { "success": true, "data": { "answer": "To reset the tire pressure monitoring system (TPMS) warning light, first ensure all tires are inflated to the recommended pressure shown on the door jamb sticker. Then, from the instrument cluster menu, navigate to 'Vehicle Settings' > 'Tire Pressure' > 'Reset'. Confirm the reset. The warning light should turn off after driving a few minutes.", "confidence": 0.94, "sources": [ { "section": "Tire Pressure Monitoring System", "page": 187 }, { "section": "Dashboard Warning Lights", "page": 42 } ], "related_questions": [ "What is the recommended tire pressure for my vehicle?", "What does the orange tire warning light mean?", "How often should I check my tire pressure?" ] } } ``` ### Use Cases - **Customer support chatbots:** Let car owners ask questions about their vehicle and get instant, accurate answers from the official manual. - **After-sales service portals:** Reduce support tickets by enabling self-service Q&A. - **Driver assistance apps:** Integrate notice Q&A into connected car or companion apps. - **Dealership staff training:** Quickly look up vehicle features and procedures during customer interactions. --- ## Full Pricing Table All prices are in credits. 1 credit = price defined by your contract (contact sales for a quote). | API Service | Credits per Call | Notes | |------------------------------|------------------|----------------------------------------------| | VIN Decoding | 3.00 | | | License Plate Lookup | 0.20 | | | Technical Specs | 2.00 | | | Vehicle Catalog | 0.65 | B2B only, setup fee applies | | AI Vehicle Notice Q&A | 0.50 | No charge if manual not available | ### Pricing Model - **Volume-based:** Pricing tiers decrease per-credit cost as monthly volume increases. - **Minimum commitment:** 500 calls per month. - **Billing:** Monthly invoicing based on actual usage. - **Setup fees:** The Vehicle Catalog API requires a one-time setup fee (amount defined by contract). - **Prices shown are public non-contractual rates.** A sales representative defines the final contractual terms upon account activation. - **Full pricing page:** https://automotivapi.com/en/pricing --- ## Data Coverage ### Geographic Coverage - Primary market: France (deepest data, including SIV registration database access) - Extended coverage: Europe-wide VIN decoding and technical data - Plate lookup: France and select European countries ### Vehicle Coverage - **80+ brands** including all major European, Asian and American manufacturers - **900+ models** with historical and current production data - **45,000+ trims** with full specification detail - Data updated continuously from manufacturer and regulatory sources ### Languages - French (primary) - English - German --- ## Technical Details ### API Standards - REST architecture - JSON request and response bodies - HTTPS only (TLS 1.2+) - UTF-8 encoding - ISO 8601 date formats ### Error Handling All errors return a consistent JSON structure: ```json { "success": false, "error": { "code": "VEHICLE_NOT_FOUND", "message": "No vehicle found for the provided VIN." } } ``` Common error codes: - `INVALID_API_KEY` — Authentication failed - `RATE_LIMIT_EXCEEDED` — Too many requests - `VEHICLE_NOT_FOUND` — No match for the given identifier - `INSUFFICIENT_CREDITS` — Account balance too low - `INVALID_REQUEST` — Malformed request parameters ### Health Check Monitor API availability at: ``` GET https://api.automotivapi.com/api/health ``` --- ## Company Information - **Company:** SOGEVIA - **Address:** 30 rue Sadi Carnot, 07100 Annonay, France - **SIRET:** 80134257700047 - **Regulatory approval:** Approved by the French Ministry of the Interior for regulated vehicle data transmission (access to SIV — Systeme d'Immatriculation des Vehicules) --- ## Resources - [API Documentation](https://automotivapi.com/en/documentation) - [Contact / Sales](https://automotivapi.com/en/contact) - [Pricing](https://automotivapi.com/en/pricing) - [API Health Status](https://api.automotivapi.com/api/health) - [llms.txt (summary)](https://automotivapi.com/llms.txt) ## Multilingual - [French site](https://automotivapi.com/fr/) - [German site](https://automotivapi.com/de/) - [English site](https://automotivapi.com/en/)