# LaCentrale: Check a listing is still online

`lacentrale/listings/check` · version 2.0.1 · pilot · 1 credits a call

Whether a LaCentrale vehicle listing is still online, with its dates.

Categories: Cars

## When to use

You have LaCentrale listings (from lacentrale/listings/search, or their URLs) and need to know which are still online: to drop sold or withdrawn vehicles from a list, or to follow a listing over time. One call checks one listing, for 1 credit where lacentrale/listings/get costs 4. Online is `status: online`; anything else is no longer online. For what the listing says (its price, its equipment, its seller), use lacentrale/listings/get. 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/check", "options": {"listing": "https://www.lacentrale.fr/auto-occasion-annonce-66104376140.html"}}'
```

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, as lacentrale/listings/get takes it. Required; no default. 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_status"` |  |
| `listing_id` | string | LaCentrale's reference of the listing (B104376140), the `id` of lacentrale/listings/search and lacentrale/listings/get. |
| `url` | string (uri) | The listing's address. For a listing given by its reference or numeric id that LaCentrale no longer holds, the auto address, which serves every vehicle family. |
| `status` | string | online: the listing is online. blocked: LaCentrale's own word for a listing it has taken offline and still holds, whether sold, withdrawn by its seller or expired (LaCentrale does not say which); its page says the listing is no longer available. gone: LaCentrale holds nothing under this id, a listing offline for long (two weeks offline are still held, three months are not) or an id that never was. Another word is LaCentrale's own for a state it adds, given as it is, in lower case. |
| `published_date` | string | null (date) | The day the listing first went online, as LaCentrale's search gives it. Null for a listing no longer online, and for a listing online that the search does not show yet. |
| `updated_at` | string | null (date-time) | When the listing was last updated, UTC, as LaCentrale's search gives it. Null as published_date. |
| `publication_ended_at` | string | null (date-time) | For a blocked listing, the end of its publication as LaCentrale keeps it: the moment it went offline, on the listings checked. Null otherwise. |
| `source_url` | string (uri) | The listing's page on lacentrale.fr. |
| `observed_at` | string (date-time) | When they were read, UTC. |

Example:

```json
{
  "object": "listing_status",
  "listing_id": "W103592947",
  "url": "https://www.lacentrale.fr/auto-occasion-annonce-87103592947.html",
  "status": "online",
  "published_date": "2026-11-10",
  "updated_at": "2026-11-11T06:34:21Z",
  "publication_ended_at": null,
  "source_url": "https://www.lacentrale.fr/auto-occasion-annonce-87103592947.html",
  "observed_at": "2026-11-16T12:00:00Z"
}
```

## Price

1 credit per listing checked, online or not. Failed calls 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. |
| `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 answered in a shape we do not read yet; we are told and fix it, and it is not charged. |
| `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

- **2.0.1** (2026-11-16): source_url is the listing's page on lacentrale.fr, online or not, as for every operation: the address a person opens.
- **2.0.0** (2026-11-16): status_code is gone from the record: a listing online is found in LaCentrale's search and its page is no longer asked, so there is no HTTP status of the page to give. `status` says it all: online, blocked or gone.
- **1.0.0** (2026-11-16): First version on the API v2, in place of the v1 LaCentrale Listing Status Checker: one listing a call, no account, by URL, reference or numeric id. A listing online says when it was published and last updated; one LaCentrale has taken offline says when, for as long as LaCentrale holds it.

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