# TheCarApi Auctions & history API

**Canonical:** https://apis.io/apis/thecarapi/thecarapi-auctions-history-api/  
**Provider:** TheCarApi — https://apis.io/providers/thecarapi/  
**Base URL:** https://api.thecarapi.com  
**Documentation:** https://thecarapi.com/docs

TheCarApi Auctions & history API is one of 11 APIs that [TheCarApi](https://apis.io/providers/thecarapi/) publishes on the [APIs.io](https://apis.io/) network, described by a machine-readable OpenAPI specification. Tagged areas include Auctions & history. The published artifact set on APIs.io includes an OpenAPI specification and API documentation.

Retrieve source-aware listing detail, galleries, price changes, and VIN history. A running openlane or ecarstrade auction has its bid read from the auction house at the moment you request the detail — nothing needs to be passed to enable it. Every other listing is served at its cycle price, refreshed at least every twelve hours.

## Operations (4)

| Method | Path | Summary |
|---|---|---|
| GET | `/api/auction/{site_slug}/{auction_id}` | Canonical auction detail with private and bidder fields removed |
| GET | `/api/auction/{site_slug}/{auction_id}/price-history` | Every recorded price movement for one listing, oldest first |
| GET | `/api/auction-images/{site_slug}/{auction_id}` | Ordered gallery metadata backed by the image vault. |
| GET | `/api/vin/{vin}/history` | Look up a full VIN across current and archived auction records |

## Machine-readable artifacts (5)

- **OpenAPI** — https://raw.githubusercontent.com/api-evangelist/thecarapi/refs/heads/main/openapi/thecarapi-auctions-history-api-openapi.yml
- **PostmanCollection** — https://thecarapi.com/thecarapi.postman_collection.json
- **Documentation** — https://thecarapi.com/docs
- **LLMsTxt** — https://thecarapi.com/llms.txt
- **APIsJSON** — https://raw.githubusercontent.com/api-evangelist/thecarapi/refs/heads/main/apis.yml

## Other TheCarApi APIs (10)

- [TheCarApi Catalog API](https://apis.io/apis/thecarapi/thecarapi-catalog-api/)
- [TheCarApi European classifieds API](https://apis.io/apis/thecarapi/thecarapi-european-classifieds-api/)
- [TheCarApi Filter facets API](https://apis.io/apis/thecarapi/thecarapi-filter-facets-api/)
- [TheCarApi Health & contract API](https://apis.io/apis/thecarapi/thecarapi-health-contract-api/)
- [TheCarApi Import calculator API](https://apis.io/apis/thecarapi/thecarapi-import-calculator-api/)
- [TheCarApi Market intelligence API](https://apis.io/apis/thecarapi/thecarapi-market-intelligence-api/)
- [TheCarApi SEO helpers API](https://apis.io/apis/thecarapi/thecarapi-seo-helpers-api/)
- [TheCarApi Top offers API](https://apis.io/apis/thecarapi/thecarapi-top-offers-api/)
- [TheCarApi Vehicle details API](https://apis.io/apis/thecarapi/thecarapi-vehicle-details-api/)
- [TheCarApi Search and Discovery API](https://apis.io/apis/thecarapi/thecarapi-search-and-discovery-api/)

## Tags

Auctions & history

---

Profiled by [API Evangelist](https://apievangelist.com) and published on [APIs.io](https://apis.io/apis/thecarapi/thecarapi-auctions-history-api/). The API's provider profile, Kin Score and agent-readiness rating are at https://apis.io/providers/thecarapi/.