Archive coverage per source

How much history exists, per source, and how much of it carries a price, a hammer price, or a VIN. Read this before assuming a field is populated: with_final_price is the number that stops the archive being mistaken for a sold-price feed.

get/api/archive/stats

Request

Base URL: https://api.thecarapi.com
URL: https://api.thecarapi.com/api/archive/stats
Auth: one of:
- API key in header X-API-Key
- HTTP bearer
- API key in query parameter api_key

Headers

If-None-Matchstring

Example:W/"6f1c0a9d8e"

Echo back the ETag from your last response for this URL. An unchanged page answers 304 Not Modified with no body. ETags are weak, so the tag stays valid whether or not the body came back compressed.

Response

Archive coverage.

successboolean required

contract_versionstring

Matches info.version of this document.

request_idstring

Also returned as the X-Request-ID header.

server_timestring date-time

UTC ISO-8601 timestamp of the response.

data_updated_atstring date-time

Route-supplied data timestamp, falling back to server_time. Not a guaranteed source refresh time; inspect listing observation timestamps and live_price.fetched_at where available.

totalinteger

Archived rows across every source.

archived_fromstring date-time nullable

archived_tostring date-time nullable

Example response

{
  "success": true,
  "contract_version": "2026-09-03",
  "sources": [
    {
      "site_name": "openlane"
    }
  ]
}

Changes

No recorded changes to this operation across all 1 revision of this API.