# 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
---

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.

## 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.

### 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`