# Preview pricing for closeout auction domains (https://developer.godaddy.com/en/docs/references/rest/auctions/preview-purchase)

---
title: Preview pricing for closeout auction domains
full: true
---

## POST /v1/customers/{customerId}/auctions/purchases/preview

Preview pricing for closeout auction domains

### Path parameters

| Name | Type | Required | Description |
|------|------|----------|-------------|
| `customerId` | string | yes | Customer identifier (UUID). Use `MY` for the authenticated customer's own data, or supply the UUID returned by `GET /v1/shoppers/{shopperId}?includes=customerId`. |

### Request body (required)

An object containing the list of domain names to preview pricing for

Content-Type: `application/json`

Schema:

- schema reference: `#/components/schemas/PurchasePreviewCreate`

### Responses

**200** — Pricing retrieved for all domains

Content-Type: `application/json`

Schema:

- schema reference: `#/components/schemas/PurchasePreview`

**207** — Pricing retrieved for some domains; others failed

Content-Type: `application/json`

Schema:

- schema reference: `#/components/schemas/PurchasePreview`

**400** — Request was malformed

Content-Type: `application/json`

Schema:

- schema reference: `#/components/schemas/Error`

**401** — Authentication info not sent or invalid

Content-Type: `application/json`

Schema:

- schema reference: `#/components/schemas/Error`

**403** — Authenticated user is not allowed access

Content-Type: `application/json`

Schema:

- schema reference: `#/components/schemas/Error`

**422** — Required parameters must be specified in correct format

Content-Type: `application/json`

Schema:

- schema reference: `#/components/schemas/Error`

**429** — Too many requests received within interval

Content-Type: `application/json`

Schema:

- schema reference: `#/components/schemas/ErrorLimit`

**500** — Internal server error

Content-Type: `application/json`

Schema:

- schema reference: `#/components/schemas/Error`