Skip to content

Changelog

2026-08-27 — In-depth verification against the real backend

The real backend for this API was identified — carmoove-backend/customer-services/data-api (Go repo, cloned read-only via SSH; its single business route, GET /v1/siv/fr/{search}, and its GetVehicleSIVFRResponse response match this documentation exactly) — and its source code read in full (v1/vehicle.go), in addition to the client-side verification done during the initial conversion. This reading, more exhaustive than the client-side check, surfaced discrepancies the latter hadn't covered:

  • Field casing in the certificate object: VIN → vin, Displacement → displacement (both lowercase in the real JSON).
  • Field name in the certificate object: unload_weight → unloaded_weight.
  • Missing error codes: besides UNKNOWN_VEHICLE, the endpoint can return INVALID_VEHICLE, INVALID_VIN_CODE (17-character VIN in an invalid format), and INVALID_PLATE (plate matching no known SIV/FNI format) — absent from the PDF and not added during the initial conversion. Added to Errors.
  • Unresolved point of attention: in the code read, the four error cases above return the response via json.NewEncoder(w).Encode(...) without explicitly calling w.WriteHeader(480) beforehand — which, in Go, defaults to an HTTP 200 status rather than the 480 documented on this site (see HTTP codes). An upstream component (proxy/gateway) could rewrite this status before it reaches the client; with no way to verify this under real conditions, the already-documented 480 convention is kept as-is, but this point deserves confirmation with the backend team before blindly trusting the HTTP status code returned by this endpoint.

Fields of the additional_information, fluids, electric, and tires objects: all confirmed identical to the real JSON, no correction needed.

2026-08-27 — HTML conversion

Converted the documentation from Carmoove_API_Static-Data_v1.4_FR.pdf (version 1.4, 25/11/2024) to this site.

The content (authentication, endpoint GET /v1/siv/fr/{plate_or_vin}, response shape and fields of the certificate, additional_information, fluids, electric, tires objects) was verified against the real implementation on the extranet side (extranet/backend/src/lib/static-data-client.ts) and the SIV integration post-mortem — no discrepancy found between the v1.4 PDF and the API's real behavior at this level of verification (see the more recent entry above for the more exhaustive backend-side verification).

Earlier history (PDF)

Date Version Change(s)
04/06/2024 0.1 Document created.
06/06/2024 1.0 1st version of the document.
07/06/2024 1.1 Added electric vehicle data.
10/06/2024 1.2 Proofreading, correction, and formatting.
13/06/2024 1.3 Added supplementary data and tires.
25/11/2024 1.4 Corrected some field names.