Performance & Status

Vehicle Auction API Performance and Data Freshness

Production availability, latency distribution and source-data freshness are measured separately so developers can understand both API responsiveness and auction-data recency.

General vehicle refresh
Up to ~30 min

Source-data freshness, not HTTP latency.

p50 latency
ms
Supported live bid refresh
10–15 sec

Approximate for supported live auction workflows.

p95 latency
ms
p99 latency
ms
5xx error rate
%
Latest Copart update
Latest IAAI update
Production telemetry

Availability, latency and source freshness are different signals

A fast API response does not guarantee fresh source data, and an invalid API key does not mean the service is down. Apibara reports these dimensions separately so integrations can interpret them correctly.

Latency

Why p50, p95 and p99 matter

p50
Typical
median area
p95
Tail
slow requests
p99
Extreme
slow tail

Search workloads vary. A direct VIN lookup is not the same workload as a broad inventory query with filters, location constraints and pagination. Percentiles expose this distribution better than one average response time.

Availability logic

What counts as service failure?

5xx

Server-side failure and relevant to production availability.

401 / 403 / 422 / 429

Authentication, validation, subscription or quota responses. The API is still responding correctly.

{
  "server_failure": "5xx",
  "client_4xx_is_downtime": false,
  "freshness_is_latency": false
}
Source freshness

Data freshness is not HTTP response time

Source freshness describes how recently supported Copart or IAAI records were collected or changed. HTTP latency measures how quickly the API serves a request. These answer different questions.

General vehicle data
Up to ~30 min
Supported live bids
~10–15 sec
Production workloads

How to keep large auction integrations fast

Cursor pagination

Continue from API cursors instead of rebuilding the full catalog.

Incremental sync

Process changed or recently updated inventory rather than everything.

Specific filters

Use platform, VIN, lot, make, model, dates and locations intentionally.

Cache stable data

Avoid repeatedly requesting metadata that rarely changes.

Methodology
Production measurement methodology

Performance is aggregated from production /api/v1/vehicle-auction/* request logs. Server-side 5xx responses are treated as service failures; client 4xx responses are not counted as server downtime. Freshness remains a separate measurement from request latency.

Frequently asked questions

Do 401, 422 or 429 responses count as downtime?

No. They are client, authorization, validation or quota responses. Server-side 5xx responses are the primary failure class for production availability.

What do p50, p95 and p99 mean?

They describe response-time distribution. p50 is around the median, while p95 and p99 expose slower tail requests.

Is data freshness the same as API latency?

No. Latency measures how long a request takes. Freshness measures how recently auction data changed in the dataset.

Is there a machine-readable status endpoint?

Yes. Use /status.json and /performance.json.