---
title: "Get Auction Bids - API Documentation"
description: "Retrieve paginated BaT bid history for a live or completed auction. Auction bids are currently in beta."
url: "https://oldcarsdata.com/docs/auction-bids"
dateModified: "2026-05-04T13:21:08.633Z"
type: "api-docs"
tags: ["API", "documentation", "Auctions"]
---

# Get Auction Bids

**GET** `/auctions/{auction_id}/bids`

Retrieve paginated BaT bid history for a live or completed auction. Auction bids are currently in beta.

## Code Examples

### cURL

```bash
curl "https://api.oldcarsdata.com/auctions/98765/bids?sort=bid_at&direction=asc" \
  -H "Authorization: Bearer YOUR_API_KEY"
```

### JavaScript

```javascript
const auctionId = 98765;
const response = await fetch(
  `https://api.oldcarsdata.com/auctions/${auctionId}/bids?sort=bid_at&direction=asc`,
  {
    headers: {
      'Authorization': 'Bearer YOUR_API_KEY'
    }
  }
);
const data = await response.json();
```

### Python

```python
import requests

response = requests.get(
    'https://api.oldcarsdata.com/auctions/98765/bids',
    params={'sort': 'bid_at', 'direction': 'asc'},
    headers={'Authorization': 'Bearer YOUR_API_KEY'}
)
data = response.json()
```

## Response

```json
{
  "data": [
    {
      "id": 12345,
      "auction_id": 98765,
      "bidder_name": "user123",
      "amount": 25000,
      "currency": "USD",
      "bid_at": "2026-05-03T18:42:11.000Z",
      "created_at": "2026-05-03T18:43:02.000Z"
    }
  ],
  "meta": {
    "total": 42,
    "page": 1,
    "limit": 100,
    "total_pages": 1
  }
}
```

## Related Endpoints

- [Get Auctions](/docs/auctions)
- [Get Live Auctions](/docs/auctions-live)
- [Get Stats](/docs/stats)
- [Get Makes](/docs/makes)
- [Get Models](/docs/models)