# Check aftermarket listing availability (https://developer.godaddy.com/en/docs/references/rest/auctions/check-listing-availability)

---
title: Check aftermarket listing availability
description: >-
  Accepts a domains array of 1-50 FQDNs and returns one result per input domain
  in order, with AVAILABLE or UNAVAILABLE status.
full: true
pageId: 888d6b4b-245d-4936-bb0b-1e67c488896f
---

Full description

Accepts a domains array of 1-50 FQDNs and returns one result per input domain in order, with AVAILABLE or UNAVAILABLE status. Optionally include listing details or domain enrichment signals using the includes query parameter. Call this endpoint with includes=listing to check transfer and renewal pricing before you place a bid.

## POST /v1/customers/{customerId}/aftermarket/listings/available

Check aftermarket listing availability

Accepts a domains array of 1-50 FQDNs and returns one result per input domain in order, with AVAILABLE or UNAVAILABLE status. Optionally include listing details or domain enrichment signals using the includes query parameter. Call this endpoint with includes=listing to check transfer and renewal pricing before you place a bid.

### Path parameters

| Name | Type | Required | Description |
|------|------|----------|-------------|
| `customerId` | string <uuid> | 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`. |

### Query parameters

| Name | Type | Required | Description |
|------|------|----------|-------------|
| `currencyId` | string | no | ISO-4217 currency code for all monetary fields (e.g. `USD`, `EUR`). Defaults to `USD`. |
| `includes` | string | no | Comma-separated field groups to include on each AVAILABLE result. Allowed tokens: `listingMin`, `listing`, `enrichment`. `listing` and `listingMin` are mutually exclusive. |

### Header parameters

| Name | Type | Required | Description |
|------|------|----------|-------------|
| `X-Request-Id` | string | no | Optional client-supplied request correlation ID. Echoed in the response `X-Request-Id` header. |

### Request body (required)

Request body containing the domains to check.

Content-Type: `application/json`

Schema:

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

### Responses

**200** — Returned for every valid request. Inspect `availabilities[i].status` per domain — UNAVAILABLE domains are still a 200.

Content-Type: `application/json`

Schema:

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

**400** — Request was malformed — missing or empty `domains` array, more than 50 domains, or unknown `includes` token.

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 (e.g. `{customerId}` does not match JWT `customer` claim).

Content-Type: `application/json`

Schema:

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

**422** — Mutually-exclusive `includes` tokens supplied (`listing` and `listingMin` together).

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 — upstream dependency (database or FIND) is unreachable or an unexpected error occurred.

Content-Type: `application/json`

Schema:

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