---
title: "Value up to N items in one request (one valuation call per query)"
method: POST
path: "/comps/batch"
---

# Value up to N items in one request (one valuation call per query)

`POST /comps/batch`

## Request

- Base URL: `https://govauctions.app/api/v1`
- URL: `https://govauctions.app/api/v1/comps/batch`
- Auth: HTTP bearer

Send item descriptions and get one comp range per query. Each query costs one valuation call, the same as sending them separately. If the valuation allowance runs out mid-batch, the priced queries are returned and a `truncated` block names the rest.

## Request body

- object
  - `queries` union[], required: Item descriptions, or per-item objects {q, category, country, state}.
    - union
      - string
      - object
  - `country` 'US' | 'UK' | 'CA' | 'AU' | 'DE' | 'FR'
  - `state` string
  - `include` 'comps'
  - `limit` integer

## Response `200`

One result per query, in submission order

## Other responses

- `400`: Malformed body, or more queries than the plan allows
- `403`: Not in plan

---

[API](https://skmtc.dev/govauctions/apis/govauctions-data-api.md) · [All operations](https://skmtc.dev/govauctions/apis/govauctions-data-api/llms.txt) · [OpenAPI document](https://skmtc.dev/govauctions/apis/govauctions-data-api/revisions/7e81b5468d24?raw)