# LaCentrale: Get a vehicle listing

`lacentrale/listings/get` · version 1.0.0 · pilot · 4 credits a call

One complete LaCentrale vehicle listing: description, specifications, equipment, photos, history preview, warranties and public seller details.

Categories: Cars

## When to use

You have a LaCentrale listing URL, reference (E120356577) or numeric id (69120356577), for example from lacentrale/listings/search, and need the complete listing. Includes seller comments, all equipment and options, electric specifications with statistical battery-health estimates, warranty terms, maintenance estimates, history preview, gallery and seller details with public phones. A search result does not contain these details. One listing per call; no pagination. The site supplies French labels and text. For the listing's warranty duration, use warranty.months; programme descriptions may advertise a higher maximum, and manufacturer_months/original_months do not establish remaining coverage. Battery health is a statistical estimate, never a measured certificate; seller comments can separately mention a battery test. No account is needed.

## Call

```bash
curl https://api.lobstr.io/v2/run \
  -H "Authorization: Bearer $LOBSTR_API_KEY" \
  -H "content-type: application/json" \
  -d '{"source": "lacentrale", "operation": "listings/get", "options": {"listing": "E120356577"}}'
```

The answer's `next` is the whole call for the following page: send it as it is. `null` on the last page.

Beside `options`, the call takes:

| Parameter | Type | Description |
|---|---|---|
| `fields` | array of string | The record fields to keep, by path (`title`, `address.city`); `object`, `id` and `position` always come. Left out: every field. |

## Options

| Option | Type | Required | Default | Description |
|---|---|---|---|---|
| `listing` | string | yes |  | A LaCentrale listing reference (E120356577), numeric URL id (69120356577), or public auto/moto/quad/scooter listing URL. Required; no default. Bare references and numeric ids use the auto route, which also serves motorcycle ids; the returned URL uses the actual vehicle family. Tracking query parameters are ignored. |

## Record

Each item of `results`. Every field is always present, `null` when the site gives nothing.

| Field | Type | Description |
|---|---|---|
| `object` | `"listing"` |  |
| `id` | string | LaCentrale reference, such as E120356577; the same id returned by listings/search. |
| `url` | string (uri) | Canonical listing URL. A motorcycle id also works through the auto route; this URL uses its actual family. |
| `title` | string | null |  |
| `description` | string | null | Complete seller comment, with line breaks preserved. Null when the seller supplied none. |
| `status` | string | null | Source publication status in lower case, normally online. |
| `price` | object | null |  |
| `price.amount` | number |  |
| `price.currency` | `"EUR"` |  |
| `is_vat_recoverable` | boolean | null |  |
| `deal_rating` | string | null |  |
| `estimated_value` | object | null | LaCentrale estimated market value, when supplied; not the asking price. |
| `estimated_value.amount` | number |  |
| `estimated_value.currency` | `"EUR"` |  |
| `valuation_confidence` | integer | null | Native reliabilityIndex of the valuation. Not a seller rating. |
| `price_history` | object | Native price history. The prices array has no dates; dated_prices contains only source-dated events. |
| `price_history.initial` | object | null |  |
| `price_history.initial.amount` | number |  |
| `price_history.initial.currency` | `"EUR"` |  |
| `price_history.current` | object | null |  |
| `price_history.current.amount` | number |  |
| `price_history.current.currency` | `"EUR"` |  |
| `price_history.prices` | array |  |
| `price_history.prices[].amount` | number |  |
| `price_history.prices[].currency` | `"EUR"` |  |
| `price_history.change_percent` | number | null |  |
| `price_history.has_dropped` | boolean | null |  |
| `price_history.is_initial_crossed_out` | boolean | null |  |
| `price_history.dated_prices` | array |  |
| `price_history.dated_prices[].date` | string | null |  |
| `price_history.dated_prices[].price` | object | null |  |
| `price_history.dated_prices[].price.amount` | number |  |
| `price_history.dated_prices[].price.currency` | `"EUR"` |  |
| `age_days` | integer | null | Displayed age in days from priceVariation; can be capped. Not converted into an inferred publication date. |
| `is_age_capped` | boolean | null | Whether LaCentrale caps the displayed age. |
| `publication_ends_at` | string | null (date-time) | Publication end supplied by LaCentrale. Its 2999 date denotes an open-ended publication. |
| `vehicle` | object |  |
| `vehicle.make` | string | null |  |
| `vehicle.model` | string | null |  |
| `vehicle.commercial_name` | string | null |  |
| `vehicle.version` | string | null | Full version/trim as supplied by the listing. |
| `vehicle.exterior_color` | string | null |  |
| `vehicle.interior_color` | string | null |  |
| `vehicle.first_registration_date` | string | null | First registration date, YYYY-MM-DD. |
| `vehicle.doors` | integer | null |  |
| `vehicle.seats` | integer | null |  |
| `vehicle.engine_capacity_cm3` | integer | null |  |
| `vehicle.power_hp` | integer | null | DIN horsepower (ch). |
| `vehicle.fiscal_power_cv` | integer | null | French fiscal horsepower (CV). |
| `vehicle.length_mm` | integer | null |  |
| `vehicle.boot_capacity_l` | integer | null | Boot volume in litres from maxTrunkVolume. Not asserted to be volume with seats folded. |
| `vehicle.owners_count` | integer | null | Number of owners shown on the page, not an inferred count from first-hand status. |
| `vehicle.is_imported` | boolean | null | The listing/reference-vehicle international flag; separate from the history report finding. |
| `vehicle.detailed_model` | string | null |  |
| `vehicle.motorization` | string | null |  |
| `vehicle.trim` | string | null |  |
| `vehicle.is_new_generation` | boolean | null |  |
| `vehicle.registration_type` | string | null | French registration-system code from the reference vehicle, such as SIV. |
| `vehicle.height_mm` | integer | null |  |
| `vehicle.width_mm` | integer | null |  |
| `vehicle.weight_kg` | integer | null |  |
| `vehicle.power_kw` | integer | null | Maximum engine power in kilowatts in the reference specifications. |
| `vehicle.family` | string | null | auto, moto, quad or scooter. auto includes utility vehicles. |
| `vehicle.category` | string | null | Native category code, lower case; e.g. tous_chemins, berline or pick_up. |
| `vehicle.energy` | string | null | Native energy code, lower case; e.g. diesel, essence, electrique. |
| `vehicle.gearbox` | string | null | Native gearbox code, lower case; e.g. automatique or mecanique. |
| `vehicle.year` | integer | null |  |
| `vehicle.mileage_km` | integer | null |  |
| `vehicle.is_first_hand` | boolean | null |  |
| `vehicle.average_mileage_km` | integer | null | LaCentrale expected mileage for a comparable vehicle of this age. |
| `vehicle.mileage_rating` | string | null |  |
| `vehicle.equipment_level` | integer | null | Native equipment level code. The page also supplies equipment highlights. |
| `vehicle.test_standard` | string | null | Measurement standard supplied by the source, such as NEDC or WLTP. |
| `vehicle.original_new_price` | object | null | Reference vehicle price when new, not the current asking price. |
| `vehicle.original_new_price.amount` | number |  |
| `vehicle.original_new_price.currency` | `"EUR"` |  |
| `vehicle.consumption` | object | Fuel consumption in L/100 km. Source zeros are retained; reliability is supplied separately. |
| `vehicle.consumption.highway_l_per_100km` | number | null |  |
| `vehicle.consumption.road_l_per_100km` | number | null |  |
| `vehicle.consumption.city_l_per_100km` | number | null |  |
| `vehicle.consumption.combined_l_per_100km` | number | null |  |
| `vehicle.consumption.low_l_per_100km` | integer | null |  |
| `vehicle.consumption.medium_l_per_100km` | number | null |  |
| `vehicle.consumption.high_l_per_100km` | number | null |  |
| `vehicle.consumption.extra_high_l_per_100km` | number | null |  |
| `vehicle.consumption.is_reliable` | boolean | null |  |
| `vehicle.emissions` | object |  |
| `vehicle.emissions.co2_g_per_km` | integer | null |  |
| `vehicle.emissions.is_reliable` | boolean | null |  |
| `vehicle.emissions.eco_bonus_malus` | object | null |  |
| `vehicle.emissions.eco_bonus_malus.amount` | number |  |
| `vehicle.emissions.eco_bonus_malus.currency` | `"EUR"` |  |
| `vehicle.emissions.euro_standard` | string | null |  |
| `vehicle.emissions.critair_class` | string | null |  |
| `vehicle.emissions.has_conversion_allowance` | boolean | null |  |
| `vehicle.battery` | object | Source electric specifications. Zero placeholders become null because the page calls them unavailable. |
| `vehicle.battery.capacity_kwh` | integer | null | Battery capacity as listed in kWh. The source does not specify whether this is gross or usable capacity. |
| `vehicle.battery.consumption_kwh_per_100km` | number | null |  |
| `vehicle.battery.current_a` | number | null |  |
| `vehicle.battery.voltage_v` | number | null |  |
| `vehicle.battery.range_km` | integer | null | Listed electric range in kilometres. No measured range or adjustment for this vehicle's battery health is implied. |
| `vehicle.battery.is_plug_in` | boolean | null | Whether it can be plugged in; true for a pure electric vehicle too. Does not mean plug-in hybrid. |
| `vehicle.battery.is_included_in_price` | boolean | null |  |
| `vehicle.battery.statistical_health` | object | null | Statistical state-of-health estimate, explicitly NOT a measured battery certificate. Bounds are percentages. |
| `vehicle.battery.statistical_health.estimated_percent` | integer | null |  |
| `vehicle.battery.statistical_health.lower_percent` | integer | null |  |
| `vehicle.battery.statistical_health.upper_percent` | integer | null |  |
| `vehicle.battery.statistical_health.is_near_new` | boolean | null | Source flag for a near-new battery-health label. |
| `vehicle.battery.statistical_health.is_range` | boolean | null | Source flag for presenting the lower-to-upper range. |
| `vehicle.battery.statistical_health.displayed_percent` | integer | null | Source display-value percentage. Can coexist with is_range; it must not be described as the only visible value when the range is shown. |
| `vehicle.battery.statistical_health.badge` | string | null |  |
| `equipment` | array | Complete equipment list in source order, including repeated categories with the site’s own labels. |
| `equipment[].category` | string | null |  |
| `equipment[].name` | string | null |  |
| `options` | array | Additional options explicitly supplied by the seller. |
| `packs` | array | Equipment packs supplied by the listing. |
| `equipment_highlights` | array | Short equipment selection shown prominently on the page. |
| `equipment_by_ai` | array | Equipment labels selected by LaCentrale’s AI. Kept separate from the full seller/reference equipment list. |
| `highlights` | array | The page’s labelled strengths, such as warranty duration or low mileage. |
| `highlights[].label` | string | null |  |
| `highlights[].value` | string | null |  |
| `warranty` | object |  |
| `warranty.details` | array |  |
| `warranty.details[].label` | string | null |  |
| `warranty.details[].value` | string | null |  |
| `warranty.details[].description` | string | null | Additional warranty terms displayed by the page. |
| `warranty.months` | integer | null | Advertised commercial/network warranty duration in MONTHS, including values such as 2 months. |
| `warranty.label` | string | null |  |
| `warranty.description` | string | null |  |
| `warranty.summary` | string | null |  |
| `warranty.is_partner` | boolean | null |  |
| `warranty.manufacturer_months` | integer | null | Manufacturer warranty duration from reference data. Does not assert that it is still valid. |
| `warranty.manufacturer_max_km` | integer | null |  |
| `warranty.manufacturer_ends_on` | string | null (date) | Explicit manufacturer-warranty expiry date supplied by the site; no expiry is inferred from duration alone. |
| `warranty.original_months` | integer | null | Warranty duration in the vehicle’s original technical specifications, in months. |
| `warranty.original_max_km` | integer | null | Mileage limit in original specifications. 999999 is the source’s unlimited sentinel. |
| `warranty.certification` | object | null | Certified-used programme, including its logo, description and programme page. |
| `warranty.certification.name` | string | null |  |
| `warranty.certification.label` | string | null |  |
| `warranty.certification.value` | string | null |  |
| `warranty.certification.logo_url` | string | null (uri) |  |
| `warranty.certification.description` | array |  |
| `warranty.certification.url` | string | null (uri) |  |
| `warranty.certification.is_partner` | boolean | null |  |
| `history` | object | Findings shown in LaCentrale’s Autoviza preview; the linked full report is not fetched. |
| `history.has_report` | boolean | null |  |
| `history.has_claims` | boolean | null | Whether the preview reports expert assessments/claims. False is not a guarantee of no past accident. |
| `history.has_professional_use` | boolean | null | Whether the history preview detects professional usage. |
| `history.has_atypical_operations` | boolean | null | Whether the source history preview reports atypical operations. |
| `history.is_imported` | boolean | null |  |
| `history.report_url` | string | null (uri) |  |
| `maintenance` | object | Manufacturer maintenance estimates shown by LaCentrale, not a service book or proof of completed work. |
| `maintenance.has_schedule` | boolean | null |  |
| `maintenance.status` | string | null |  |
| `maintenance.count` | integer | null |  |
| `maintenance.message` | string | null |  |
| `maintenance.period` | string | null |  |
| `maintenance.period_from` | string | null | First month of the displayed maintenance period, YYYY-MM. |
| `maintenance.period_to` | string | null | Last month of the displayed maintenance period, YYYY-MM. |
| `maintenance.before` | array | Estimated maintenance operations in the source’s before group, in its order. |
| `maintenance.before[].name` | string | null |  |
| `maintenance.before[].reason` | string | null |  |
| `maintenance.before[].month` | string | null |  |
| `maintenance.before[].mileage_km` | integer | null |  |
| `maintenance.before[].distance_since_due_km` | integer | null |  |
| `maintenance.before[].months_since_due` | number | null |  |
| `maintenance.before[].is_next` | boolean | null |  |
| `maintenance.before[].interval` | integer | null |  |
| `maintenance.before[].interval_unit` | string | null |  |
| `maintenance.before[].occurrence` | integer | null |  |
| `maintenance.before[].labour_hours` | number | null |  |
| `maintenance.before[].status` | string | null |  |
| `maintenance.before[].labour_cost` | object | null |  |
| `maintenance.before[].labour_cost.amount` | number |  |
| `maintenance.before[].labour_cost.currency` | `"EUR"` |  |
| `maintenance.before[].parts_cost` | object | null |  |
| `maintenance.before[].parts_cost.amount` | number |  |
| `maintenance.before[].parts_cost.currency` | `"EUR"` |  |
| `maintenance.before[].total_cost` | object | null |  |
| `maintenance.before[].total_cost.amount` | number |  |
| `maintenance.before[].total_cost.currency` | `"EUR"` |  |
| `maintenance.before[].parts` | array |  |
| `maintenance.before[].parts[].name` | string | null |  |
| `maintenance.before[].parts[].cost` | object | null |  |
| `maintenance.before[].parts[].cost.amount` | number |  |
| `maintenance.before[].parts[].cost.currency` | `"EUR"` |  |
| `maintenance.before[].oil_cost` | object | null |  |
| `maintenance.before[].oil_cost.amount` | number |  |
| `maintenance.before[].oil_cost.currency` | `"EUR"` |  |
| `maintenance.after` | array | Estimated maintenance operations in the source’s after group, in its order. |
| `maintenance.after[].name` | string | null |  |
| `maintenance.after[].reason` | string | null |  |
| `maintenance.after[].month` | string | null |  |
| `maintenance.after[].mileage_km` | integer | null |  |
| `maintenance.after[].distance_since_due_km` | integer | null |  |
| `maintenance.after[].months_since_due` | number | null |  |
| `maintenance.after[].is_next` | boolean | null |  |
| `maintenance.after[].interval` | integer | null |  |
| `maintenance.after[].interval_unit` | string | null |  |
| `maintenance.after[].occurrence` | integer | null |  |
| `maintenance.after[].labour_hours` | number | null |  |
| `maintenance.after[].status` | string | null |  |
| `maintenance.after[].labour_cost` | object | null |  |
| `maintenance.after[].labour_cost.amount` | number | null |  |
| `maintenance.after[].labour_cost.currency` | `"EUR"` |  |
| `maintenance.after[].parts_cost` | object | null |  |
| `maintenance.after[].parts_cost.amount` | number | null |  |
| `maintenance.after[].parts_cost.currency` | `"EUR"` |  |
| `maintenance.after[].total_cost` | object | null |  |
| `maintenance.after[].total_cost.amount` | number | null |  |
| `maintenance.after[].total_cost.currency` | `"EUR"` |  |
| `maintenance.after[].parts` | array |  |
| `maintenance.after[].parts[].name` | string | null |  |
| `maintenance.after[].parts[].cost` | object | null |  |
| `maintenance.after[].parts[].cost.amount` | number | null |  |
| `maintenance.after[].parts[].cost.currency` | `"EUR"` |  |
| `maintenance.after[].oil_cost` | object | null |  |
| `maintenance.after[].oil_cost.amount` | number | null |  |
| `maintenance.after[].oil_cost.currency` | `"EUR"` |  |
| `declared_repairs` | array | Repairs declared by the seller, not independently verified repairs. |
| `financing` | object | Displayed monthly loan/lease teasers and availability, not a binding loan offer. Generic lender calculator settings are excluded. |
| `financing.has_loan` | boolean | null |  |
| `financing.has_lease` | boolean | null |  |
| `financing.loan_monthly_price` | object | null |  |
| `financing.loan_monthly_price.amount` | number |  |
| `financing.loan_monthly_price.currency` | `"EUR"` |  |
| `financing.lease_monthly_price` | object | null |  |
| `financing.lease_monthly_price.amount` | number |  |
| `financing.lease_monthly_price.currency` | `"EUR"` |  |
| `financing.loan_name` | string | null |  |
| `financing.lease_name` | string | null |  |
| `photos` | array | Gallery entries in display order. Video entries have type video, a thumbnail URL and video_url. |
| `photos[].id` | string | null |  |
| `photos[].url` | string | null (uri) |  |
| `photos[].mobile_url` | string | null (uri) |  |
| `photos[].original_url` | string | null (uri) |  |
| `photos[].mobile_original_url` | string | null (uri) |  |
| `photos[].video_url` | string | null (uri) |  |
| `photos[].type` | string | null |  |
| `photos[].category` | string | null |  |
| `photos[].group_id` | string | null |  |
| `photos[].score` | integer | null | Native gallery ordering/selection score, not vehicle quality. |
| `photo_groups` | array | Gallery categories; first_photo_index is zero-based in photos. |
| `photo_groups[].id` | string | null |  |
| `photo_groups[].label` | string | null |  |
| `photo_groups[].first_photo_index` | integer | null |  |
| `seller` | object |  |
| `seller.type` | string | null |  |
| `seller.name` | string | null |  |
| `seller.kind` | string | null |  |
| `seller.kind_label` | string | null |  |
| `seller.company_created_at` | string | null (date-time) |  |
| `seller.is_verified` | boolean | null |  |
| `seller.is_broker` | boolean | null |  |
| `seller.is_distance_seller` | boolean | null |  |
| `seller.listings_count` | integer | null |  |
| `seller.url` | string | null (uri) |  |
| `seller.address` | object | Seller/showroom address. Do not assume this is the vehicle’s exact position. |
| `seller.address.street` | string | null |  |
| `seller.address.postal_code` | string | null |  |
| `seller.address.city` | string | null |  |
| `seller.address.country` | string | null |  |
| `seller.address.latitude` | number | null |  |
| `seller.address.longitude` | number | null |  |
| `seller.has_phone` | boolean | null |  |
| `seller.has_email` | boolean | null |  |
| `seller.has_whatsapp` | boolean | null |  |
| `seller.whatsapp_phone` | object | null |  |
| `seller.whatsapp_phone.number` | string | null |  |
| `seller.whatsapp_phone.as_written` | string | null |  |
| `seller.phones` | array | Public phone numbers decoded from the page. Includes both displayed and forwarded numbers when supplied. |
| `seller.phones[].number` | string | null |  |
| `seller.phones[].as_written` | string | null |  |
| `seller.services` | array |  |
| `seller.presentation` | string | null |  |
| `seller.logo_url` | string | null (uri) |  |
| `seller.website_url` | string | null (uri) |  |
| `seller.banners` | array |  |
| `seller.banners[].format` | string | null |  |
| `seller.banners[].mobile_url` | string | null (uri) |  |
| `seller.banners[].desktop_url` | string | null (uri) |  |
| `seller.contacts` | array |  |
| `seller.contacts[].first_name` | string | null |  |
| `seller.contacts[].last_name` | string | null |  |
| `seller.contacts[].title` | string | null |  |
| `seller.contacts[].phone` | object |  |
| `seller.contacts[].phone.number` | string | null |  |
| `seller.contacts[].phone.as_written` | string | null |  |
| `seller.opening_status` | string | null | Status displayed when the page was fetched, in French. |
| `seller.has_opening_hours` | boolean | null |  |
| `seller.opening_hours` | array | French local opening intervals as written, e.g. 09h00-12h00 or Fermé; weekday names are English. |
| `seller.opening_hours[].day` | string | null |  |
| `seller.opening_hours[].hours` | array |  |
| `seller.rating` | object | null | Seller rating shown on LaCentrale, out of 5, with the total review count. |
| `seller.rating.value` | number | null |  |
| `seller.rating.scale` | integer | null |  |
| `seller.rating.count` | integer | null |  |
| `seller.reviews_url` | string | null (uri) |  |
| `seller.reviews` | array | The review preview included in the listing page, not all seller reviews. |
| `seller.reviews[].author` | string | null |  |
| `seller.reviews[].published_at` | string | null (date-time) |  |
| `seller.reviews[].rating` | object |  |
| `seller.reviews[].rating.value` | integer | null |  |
| `seller.reviews[].rating.scale` | integer | null |  |
| `seller.reviews[].rating.count` | number | null |  |
| `seller.reviews[].text` | string | null |  |
| `location` | object |  |
| `location.department` | string | null |  |
| `location.postal_code` | string | null |  |
| `location.is_listing_location` | boolean | null | Whether the page chooses the classified location rather than the seller’s location. |
| `valuation_url` | string | null (uri) |  |
| `technical_specifications_url` | string | null (uri) |  |
| `ids` | object |  |
| `ids.listing_id` | string | null |  |
| `ids.url_id` | string | null |  |
| `ids.seller_reference` | string | null |  |
| `ids.customer_reference` | string | null |  |
| `ids.owner_correlation_id` | string | null |  |
| `ids.version_id` | string | null |  |
| `ids.warranty_id` | string | null |  |
| `ids.vehicle_id` | string | null |  |
| `ids.financing_siret` | string | null | SIRET supplied with the financing input; not asserted to be the seller’s independently verified SIRET. |
| `source_url` | string (uri) | Normalized URL actually requested, with tracking query parameters removed. |
| `observed_at` | string (date-time) | When this listing was read, in UTC. |

Example:

```json
{
  "object": "listing",
  "id": "E100000001",
  "url": "https://www.lacentrale.fr/auto-occasion-annonce-69100000001.html",
  "title": "BMW X1 F48 phase 2",
  "description": "Well-maintained vehicle. Full service history available.",
  "status": "online",
  "price": {
    "amount": 21690,
    "currency": "EUR"
  },
  "is_vat_recoverable": false,
  "deal_rating": "good_deal",
  "estimated_value": {
    "amount": 22779,
    "currency": "EUR"
  },
  "valuation_confidence": 5,
  "price_history": {
    "initial": {
      "amount": 21690,
      "currency": "EUR"
    },
    "current": {
      "amount": 21690,
      "currency": "EUR"
    },
    "prices": [
      {
        "amount": 21690,
        "currency": "EUR"
      },
      {
        "amount": 21690,
        "currency": "EUR"
      }
    ],
    "change_percent": 0,
    "has_dropped": false,
    "is_initial_crossed_out": false,
    "dated_prices": []
  },
  "age_days": 0,
  "is_age_capped": false,
  "publication_ends_at": "2999-01-01T00:00:00Z",
  "vehicle": {
    "make": "BMW",
    "model": "X1",
    "commercial_name": "X1",
    "version": "(F48) (2) XDRIVE18D XLINE BVA8",
    "exterior_color": "Mineralgrau",
    "interior_color": "Noir",
    "first_registration_date": "2019-12-30",
    "doors": 5,
    "seats": 5,
    "engine_capacity_cm3": 1995,
    "power_hp": 150,
    "fiscal_power_cv": 8,
    "length_mm": 4450,
    "boot_capacity_l": 505,
    "owners_count": 3,
    "is_imported": null,
    "detailed_model": "BMW X1 F48 phase 2",
    "motorization": "2.0 XDRIVE18D 150",
    "trim": "XLINE",
    "is_new_generation": false,
    "registration_type": null,
    "height_mm": 1600,
    "width_mm": 1820,
    "weight_kg": 1540,
    "power_kw": null,
    "family": "auto",
    "category": "tous_chemins",
    "energy": "diesel",
    "gearbox": "automatique",
    "year": 2019,
    "mileage_km": 102661,
    "is_first_hand": false,
    "average_mileage_km": 105420,
    "mileage_rating": "medium_mileage",
    "equipment_level": 2,
    "test_standard": "NEDC",
    "original_new_price": {
      "amount": 46500,
      "currency": "EUR"
    },
    "consumption": {
      "highway_l_per_100km": 5.7,
      "road_l_per_100km": 4.4,
      "city_l_per_100km": 5.1,
      "combined_l_per_100km": null,
      "low_l_per_100km": null,
      "medium_l_per_100km": null,
      "high_l_per_100km": null,
      "extra_high_l_per_100km": null,
      "is_reliable": true
    },
    "emissions": {
      "co2_g_per_km": 114,
      "is_reliable": true,
      "eco_bonus_malus": {
        "amount": 0,
        "currency": "EUR"
      },
      "euro_standard": "EURO6",
      "critair_class": "2",
      "has_conversion_allowance": false
    },
    "battery": {
      "capacity_kwh": null,
      "consumption_kwh_per_100km": null,
      "current_a": null,
      "voltage_v": null,
      "range_km": null,
      "is_plug_in": null,
      "is_included_in_price": null,
      "statistical_health": null
    }
  },
  "equipment": [
    {
      "category": "Sécurité",
      "name": "ESP"
    },
    {
      "category": "Sécurité",
      "name": "Airbags rideaux"
    }
  ],
  "options": [],
  "packs": [
    "Pack Advanced Full LED"
  ],
  "equipment_highlights": [
    "toit ouvrant panoramique",
    "phares av. de jour à LED"
  ],
  "equipment_by_ai": [
    "toit ouvrant panoramique",
    "phares av. de jour à LED"
  ],
  "highlights": [
    {
      "label": "Véhicule certifié",
      "value": "SPOTICAR PREMIUM"
    },
    {
      "label": "Engagement",
      "value": "Satisfait ou remboursé"
    }
  ],
  "warranty": {
    "details": [
      {
        "label": "Garantie",
        "value": "12 mois",
        "description": null
      }
    ],
    "months": 12,
    "label": "SPOTICAR PREMIUM",
    "description": "- Garantie commerciale jusqu'à 24 mois et kilométrage illimité- Véhicule révisé et contrôlé- Assistance 24h/24 et 7j/7 en Europe- Satisfait ou remboursé- Essai du véhicule sans engagement- Solutions de financement- Reprise de véhicule- Conseils et accompagnement personnalisés",
    "summary": "- Garantie 12 ou 24 mois- Véhicule révisé et contrôlé- Assistance 24h/24",
    "is_partner": true,
    "manufacturer_months": 24,
    "manufacturer_max_km": null,
    "manufacturer_ends_on": null,
    "original_months": 24,
    "original_max_km": 999999,
    "certification": {
      "name": "SPOTICAR PREMIUM",
      "label": "Garantie certifiée",
      "value": "spoticar premium",
      "logo_url": "https://www.lacentrale.fr/static/fragment-classified-detail-fragments/media/spoticar_premium_V3.948461cb.svg",
      "description": [
        "Garantie commerciale jusqu'à 24 mois et kilométrage illimité",
        "Véhicule révisé et contrôlé",
        "Assistance 24h/24 et 7j/7 en Europe",
        "Satisfait ou remboursé",
        "Essai du véhicule sans engagement",
        "Solutions de financement",
        "Reprise de véhicule",
        "Conseils et accompagnement personnalisés"
      ],
      "url": "https://lacentrale.fr/labels-constructeurs/spoticar-premium",
      "is_partner": true
    }
  },
  "history": {
    "has_report": true,
    "has_claims": false,
    "has_professional_use": true,
    "has_atypical_operations": false,
    "is_imported": false,
    "report_url": null
  },
  "maintenance": {
    "has_schedule": true,
    "status": "ok",
    "count": 2,
    "message": "2 entretien(s) à réaliser sur cette période",
    "period": "Mai 2026 à Mai 2027",
    "period_from": "2026-05",
    "period_to": "2027-05",
    "before": [
      {
        "name": "Plaquettes de frein arriere",
        "reason": "Changement plaquettes de frein arriere",
        "month": "2026-04",
        "mileage_km": 97000,
        "distance_since_due_km": 5661,
        "months_since_due": 6.7932,
        "is_next": false,
        "interval": 97000,
        "interval_unit": "km",
        "occurrence": 1,
        "labour_hours": 0.75,
        "status": "unknown",
        "labour_cost": {
          "amount": 72.51,
          "currency": "EUR"
        },
        "parts_cost": {
          "amount": 150.88,
          "currency": "EUR"
        },
        "total_cost": {
          "amount": 220,
          "currency": "EUR"
        },
        "parts": [],
        "oil_cost": null
      }
    ],
    "after": []
  },
  "declared_repairs": [],
  "financing": {
    "has_loan": false,
    "has_lease": false,
    "loan_monthly_price": null,
    "lease_monthly_price": null,
    "loan_name": null,
    "lease_name": null
  },
  "photos": [
    {
      "id": "photo-001",
      "url": "https://example.com/vehicle.jpg",
      "mobile_url": "https://example.com/vehicle-mobile.jpg",
      "original_url": null,
      "mobile_original_url": null,
      "video_url": null,
      "type": "standard",
      "category": "front_3_4_l",
      "group_id": "outside",
      "score": 100
    }
  ],
  "photo_groups": [
    {
      "id": "outside",
      "label": "Extérieur",
      "first_photo_index": 0
    }
  ],
  "seller": {
    "type": "pro",
    "name": "Acme Motors",
    "kind": "concessionnaire",
    "kind_label": "Concessionnaire",
    "company_created_at": "2010-12-22T00:00:00Z",
    "is_verified": true,
    "is_broker": false,
    "is_distance_seller": false,
    "listings_count": 100,
    "url": "https://example.com/dealer",
    "address": {
      "street": "1 Example Street",
      "postal_code": "75001",
      "city": "Paris",
      "country": "FR",
      "latitude": 48.86,
      "longitude": 2.34
    },
    "has_phone": true,
    "has_email": true,
    "has_whatsapp": true,
    "whatsapp_phone": null,
    "phones": [
      {
        "number": "+33123456789",
        "as_written": "0123456789"
      }
    ],
    "services": [],
    "presentation": "Used vehicle dealership.",
    "logo_url": "https://example.com/logo.png",
    "website_url": "https://example.com",
    "banners": [],
    "contacts": [],
    "opening_status": "Ouvert",
    "has_opening_hours": true,
    "opening_hours": [
      {
        "day": "monday",
        "hours": [
          "09h00-12h00",
          "14h00-18h00"
        ]
      },
      {
        "day": "tuesday",
        "hours": [
          "09h00-12h00",
          "14h00-18h00"
        ]
      },
      {
        "day": "wednesday",
        "hours": [
          "09h00-12h00",
          "14h00-18h00"
        ]
      },
      {
        "day": "thursday",
        "hours": [
          "09h00-12h00",
          "14h00-18h00"
        ]
      },
      {
        "day": "friday",
        "hours": [
          "09h00-12h00",
          "14h00-18h00"
        ]
      },
      {
        "day": "saturday",
        "hours": [
          "09h00-12h00",
          "14h00-18h00"
        ]
      },
      {
        "day": "sunday",
        "hours": [
          "Fermé"
        ]
      }
    ],
    "rating": {
      "value": 4.2,
      "scale": 5,
      "count": 1280
    },
    "reviews_url": null,
    "reviews": []
  },
  "location": {
    "department": "62",
    "postal_code": "62400",
    "is_listing_location": false
  },
  "valuation_url": null,
  "technical_specifications_url": null,
  "ids": {
    "listing_id": "E100000001",
    "url_id": "69100000001",
    "seller_reference": "DEMO-001",
    "customer_reference": "C000001",
    "owner_correlation_id": "C000001",
    "version_id": "25888249",
    "warranty_id": "00c1467f",
    "vehicle_id": "P_C045126_pe62c7_PT40492",
    "financing_siret": null
  },
  "source_url": "https://www.lacentrale.fr/auto-occasion-annonce-69100000001.html",
  "observed_at": "2026-11-13T14:00:00Z"
}
```

## Price

4 credits per successful call returning one listing. Failed calls, including unavailable listings, are free.

## Errors

| Code | Status | Retry | Message |
|---|---|---|---|
| `ip_blocked` | 503 | yes | LaCentrale refused the attempted IPs. Retry later; failed calls are free. |
| `invalid_listing` | 400 | no | Pass a LaCentrale listing reference, numeric id or listing URL. |
| `listing_gone` | 404 | no | LaCentrale says this listing is unavailable or does not exist. |
| `blocked` | 503 | yes | LaCentrale refused this request. Retry later; failed calls are free. |
| `site_unavailable` | 503 | yes | LaCentrale could not serve the listing. Retry later. |
| `unexpected_answer` | 502 | no | LaCentrale returned an unreadable or incomplete listing. |
| `missing_api_key` | 401 | no | No API key: send it as `Authorization: Bearer <key>`. |
| `invalid_api_key` | 401 | no | The key is not valid, or not anymore. |
| `insufficient_credits` | 402 | no | The call costs more credits than are left. |
| `unknown_operation` | 404 | no | No such source and operation in the catalog. |
| `timeout` | 408 | yes | The call did not finish within its deadline (not charged). |
| `invalid_body` | 422 | no | The body is not a call: source, operation, options. |
| `invalid_options` | 422 | no | An option is missing or out of its contract; `param` names it. |
| `invalid_idempotency_key` | 400 | no | The Idempotency-Key header is not printable ASCII, or too long. |
| `concurrency_limit` | 429 | yes | The plan's calls at a time are all in progress (Free 1, Starter 2, Pro 10, Team 50); retry when one has finished (not charged, never queued). |
| `service_busy` | 503 | yes | Too many calls at once on the account; retry in a few seconds. |
| `balance_unavailable` | 503 | yes | The balance could not be read; retry in a few seconds. |

## Changelog

- **1.0.0** (2026-11-13): Get one complete vehicle listing by URL or id, with full equipment, seller comments, warranty details, electric specifications, history preview, maintenance estimates, gallery and public seller contacts. 4 credits per successful listing.

Schema: https://api.lobstr.io/v2/catalog/lacentrale/listings/get · All operations: https://api.lobstr.io/v2/catalog.md
