---
title: "Get Price Estimates for Multiple Cards (Batch)"
method: POST
path: "/v1/cards/batch-price-estimate"
tags: ["Pricing & Valuations"]
---

# Get Price Estimates for Multiple Cards (Batch)

`POST /v1/cards/batch-price-estimate`

Get price estimates for multiple cards in a single request.

This endpoint allows batch processing of up to 100 card/grade combinations
using CardHedge's correlated price estimation service.

**Request Format:**
```json
{
  "items": [
    {"card_id": "abc123", "grade": "PSA 10"},
    {"card_id": "abc123", "grade": "PSA 9"},
    {"card_id": "xyz789", "grade": "BGS 9.5"}
  ]
}
```

**Response Fields (per item):**
- `card_id`: Card identifier from request
- `grade`: Grade from request
- `price`: Estimated price in USD (null if error)
- `price_low`: Lower bound of price estimate
- `price_high`: Upper bound of price estimate
- `confidence`: Confidence score (0-1)
- `method`: Estimation method ('direct' or 'correlated')
- `freshness_days`: Age of data used for estimation
- `support_grades`: Number of supporting grade data points
- `grade_label`: Grade label used for estimation
- `provider`: Grading provider (e.g., 'PSA', 'BGS')
- `grade_value`: Numeric grade value
- `error`: Error message if estimation failed for this item

**Example curl:**
```bash
curl -X POST -H "X-API-Key: your-api-key-here" \
     -H "Content-Type: application/json" \
     -d '{
       "items": [
         {"card_id": "1586812246197x228181943611293700", "grade": "PSA 10"},
         {"card_id": "1586812246197x228181943611293700", "grade": "PSA 9"}
       ]
     }' \
     "https://api.cardhedger.com/v1/cards/batch-price-estimate"
```

Returns batch results with individual success/error status per item.
Maximum 100 items per request.

## Request body

- BatchPriceEstimateRequest — Request parameters for batch price estimation endpoint.
  - `items` PriceEstimateItem[], required — List of card/grade combinations to estimate (max 100)
    - `card_id` string, required — Unique card identifier from CardHedge
    - `grade` string, required — Card grade (e.g., 'PSA 9', 'PSA 10', 'BGS 9.5')

## Response `200`

Successful Response

- BatchPriceEstimateResponse — Response model for batch price estimation endpoint.
  - `results` BatchPriceEstimateResultItem[], required — List of estimation results
    - `card_id` string, required — Card identifier from request
    - `grade` string, required — Grade from request
    - `price` number, nullable — Estimated price in USD
    - `price_low` number, nullable — Lower bound of price estimate
    - `price_high` number, nullable — Upper bound of price estimate
    - `confidence` number, nullable — Confidence score (0-1)
    - `method` string, nullable — Estimation method used (e.g., 'direct', 'correlated')
    - `freshness_days` integer, nullable — Age of data used for estimation in days
    - `support_grades` integer, nullable — Number of supporting grade data points
    - `grade_label` string, nullable — Grade label used for estimation
    - `provider` string, nullable — Grading provider (e.g., 'PSA', 'BGS')
    - `grade_value` number, nullable — Numeric grade value
    - `error` string, nullable — Error message if estimation failed for this item
  - `total_requested` integer, required — Number of items requested
  - `total_successful` integer, required — Number of successful estimations

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.dev/cardhedger/apis/card-hedge-api.md) · [All operations](https://skmtc.dev/cardhedger/apis/card-hedge-api/llms.txt) · [OpenAPI document](https://skmtc.dev/cardhedger/apis/card-hedge-api/revisions/637bcd3b9a98?raw)