# Listings Availability (https://developer.godaddy.com/en/docs/references/rest/auctions/listings-availability) *** title: Listings Availability description: >- Check whether one or more domains have active aftermarket auction listings on GoDaddy, with optional listing details and domain enrichment signals. full: true \_openapi: method: POST toc: * depth: 2 title: Check whether one or more domains have active aftermarket listings url: '#check-whether-one-or-more-domains-have-active-aftermarket-listings' structuredData: headings: * content: Check whether one or more domains have active aftermarket listings id: check-whether-one-or-more-domains-have-active-aftermarket-listings contents: * content: >- Accepts a JSON object with a `domains` array of 1–50 FQDNs and returns one result per input domain, in order, with AVAILABLE or UNAVAILABLE status. Optionally attach listing details (`?includes=listingMin` or `?includes=listing`) and/or domain enrichment signals (`?includes=enrichment`) for AVAILABLE domains. heading: check-whether-one-or-more-domains-have-active-aftermarket-listings *** ## POST /v1/customers/{customerId}/aftermarket/listings/available Check whether one or more domains have active aftermarket listings Accepts a JSON object with a `domains` array of 1–50 FQDNs and returns one result per input domain, in order, with AVAILABLE or UNAVAILABLE status. Optionally attach listing details (`?includes=listingMin` or `?includes=listing`) and/or domain enrichment signals (`?includes=enrichment`) for AVAILABLE domains. ### Path parameters | Name | Type | Required | Description | |------|------|----------|-------------| | `customerId` | string | yes | Customer (shopper) identifier — must match the `customer` claim in the shopper JWT. | ### 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: - object — Request body for the listings availability check. - `domains` (required): array — List of 1–50 fully-qualified domain names to check. - items: ### Responses **200** — Returned for every valid request. Inspect `availabilities[i].status` per domain — UNAVAILABLE domains are still a 200. Content-Type: `application/json` Schema: - object — Response wrapper for the listings availability check. - `availabilities` (required): array — One entry per input domain, in the same order as the request body. - items: - `domainName` (required): string — The domain name that was checked, in normalized (lowercase) form. - `status` (required): string — AVAILABLE — domain has an active, biddable listing. UNAVAILABLE — no active listing. - enum: "AVAILABLE", "UNAVAILABLE" - `listing`: object — Present only when `?includes=listing` or `?includes=listingMin` is set and status is AVAILABLE. - `kind` (required): string — Discriminator indicating which field subset is populated. `MIN` = listingMin subset; `FULL` = full listing subset. - enum: "MIN", "FULL" - `currencyId` (required): string — ISO-4217 currency code for all monetary fields in this listing. - `listingId` (required): integer — Stable identifier for the listing. - `listingType` (required): string — Inventory class. v1 returns only EXPIRY_AUCTIONS. - enum: "EXPIRY_AUCTIONS" - `bidsCount`: integer — Number of bids placed on the listing so far. - `auctionStartAt`: string — Auction start time (UTC ISO-8601). - `auctionEndAt`: string — Auction end time (UTC ISO-8601). - `priceCurrent`: integer — Current leading bid price, in micro-units of `currencyId` (1,000,000 = 1 unit). - `priceNextBid`: integer — Minimum valid next bid (current price + bid increment), in micro-units of `currencyId`. - `priceBuyItNow`: integer — Buy-it-now price in micro-units of `currencyId`, if set. - `memberBiddingStatus`: string — Caller's bidding state. Derived from {customerId} in the request path. - enum: "NOT_BIDDING", "OUTBID", "WINNING" - `extended`: boolean — Whether the listing auto-extends its end time on late bids (anti-sniping). Returned with ?includes=listing only. - `priceProxyBid`: integer — Customer's currently-set proxy/max bid in micro-units of `currencyId`. 0 when none is set. Returned with ?includes=listing only. - `watching`: boolean — Whether the requesting customer has this listing in their watchlist. Returned with ?includes=listing only. - `priceTransfer`: integer — Transfer price for the domain in micro-units of `currencyId`. Returned with ?includes=listing only. - `priceRenewal`: integer — Annual renewal price in micro-units of `currencyId` (when domain is registered at GoDaddy). Returned with ?includes=listing only. - `estimatedTransferAt`: string — Estimated UTC timestamp by which the domain transfer completes after auction close. Returned with ?includes=listing only. - `domainExpiresAt`: string — When the underlying domain registration expires. Returned with ?includes=listing only. - `domainCreatedAt`: string — When the domain was first registered (WHOIS). Returned with ?includes=listing only. - `domainAgeYears`: integer — Domain age in whole years, derived from domainCreatedAt. Returned with ?includes=listing only. - `charPattern`: string — Vowel/consonant signature of the SLD (`v` = vowel, `c` = consonant). Returned with ?includes=listing only. - `enrichment`: object — Present only when `?includes=enrichment` and status is AVAILABLE. - `godaddy`: object — GoDaddy-native signals: GoValue appraisal, parking traffic, parking revenue. - `estimatedValue`: integer — GoDaddy's estimated retail value (GoValue appraisal), in micro-units of `currencyId`. - `monthlyVisits`: integer — Estimated monthly visits to the FQDN. - `parkingRevenue`: integer — Last-period parking revenue in micro-units of `currencyId`. 0 when domain is not parked. - `estibot`: object — Estibot SLD-footprint counts. - `extensionsRegistered`: integer — Number of TLDs where this exact SLD is registered. - `extensionsDeveloped`: integer — Subset of extensionsRegistered pointed at a live website. - `similarDomainsRegistered`: integer — Total registered domains whose SLD contains this SLD as a substring. - `similarDomainsDeveloped`: integer — Subset of similarDomainsRegistered pointed at a live website. - `semrush`: object — SEMrush link-graph and keyword signals. - `authorityScore`: integer — 0–100. SEMrush overall SEO-strength score. - `totalBacklinks`: integer — Total inbound links, per SEMrush crawl. - `referringDomainsCount`: integer — Unique referring root domains, per SEMrush crawl. - `referringUrlsCount`: integer — Unique referring URLs, per SEMrush crawl. - `keywordMonthlySearchVolume`: integer — Average monthly searches for the SLD as a keyword. - `keywordCostPerClick`: integer — Average paid-search cost-per-click for the SLD as a keyword, in micro-units of `currencyId`. - `topReferringDomains`: array — Capped sample of the strongest referring domains. - items: - `domain` (required): string — The referring root domain. - `backlinkCount`: integer — Number of inbound links from this referring domain. - `majestic`: object — Majestic SEO link metrics. - `backlinks`: integer — External backlinks pointing at the FQDN, per Majestic index. - `referringDomains`: integer — Unique referring domains, per Majestic index. - `citationFlow`: integer — 0–100. Majestic link-quantity score. - `trustFlow`: integer — 0–100. Majestic link-quality score. **400** — Request was malformed — missing or empty `domains` array, more than 50 domains, or unknown `includes` token. Content-Type: `application/json` Schema: - object - `code` (required): string — Short identifier for the error, suitable for indicating the specific error within client code - `fields`: array — List of the specific fields, and the errors found with their contents - items: - `code` (required): string — Short identifier for the error, suitable for indicating the specific error within client code - `message`: string — Human-readable, English description of the problem with the contents of the field - `path` (required): string —
    - `pathRelated`: string — JSONPath referring to a field containing an error, which is referenced by `path` - `message`: string — Human-readable, English description of the error **401** — Authentication info not sent or invalid. Content-Type: `application/json` Schema: - object - `code` (required): string — Short identifier for the error, suitable for indicating the specific error within client code - `fields`: array — List of the specific fields, and the errors found with their contents - items: - `code` (required): string — Short identifier for the error, suitable for indicating the specific error within client code - `message`: string — Human-readable, English description of the problem with the contents of the field - `path` (required): string —
      - `pathRelated`: string — JSONPath referring to a field containing an error, which is referenced by `path` - `message`: string — Human-readable, English description of the error **403** — Authenticated user is not allowed access (e.g. `{customerId}` does not match JWT `customer` claim). Content-Type: `application/json` Schema: - object - `code` (required): string — Short identifier for the error, suitable for indicating the specific error within client code - `fields`: array — List of the specific fields, and the errors found with their contents - items: - `code` (required): string — Short identifier for the error, suitable for indicating the specific error within client code - `message`: string — Human-readable, English description of the problem with the contents of the field - `path` (required): string —
        - `pathRelated`: string — JSONPath referring to a field containing an error, which is referenced by `path` - `message`: string — Human-readable, English description of the error **422** — Mutually-exclusive `includes` tokens supplied (`listing` and `listingMin` together). Content-Type: `application/json` Schema: - object - `code` (required): string — Short identifier for the error, suitable for indicating the specific error within client code - `fields`: array — List of the specific fields, and the errors found with their contents - items: - `code` (required): string — Short identifier for the error, suitable for indicating the specific error within client code - `message`: string — Human-readable, English description of the problem with the contents of the field - `path` (required): string —
          - `pathRelated`: string — JSONPath referring to a field containing an error, which is referenced by `path` - `message`: string — Human-readable, English description of the error **429** — Too many requests received within interval. Content-Type: `application/json` Schema: - object - `code` (required): string — Short identifier for the error, suitable for indicating the specific error within client code - `fields`: array — List of the specific fields, and the errors found with their contents - items: - `code` (required): string — Short identifier for the error, suitable for indicating the specific error within client code - `message`: string — Human-readable, English description of the problem with the contents of the field - `path` (required): string —
            - `pathRelated`: string — JSONPath referring to a field containing an error, which is referenced by `path` - `message`: string — Human-readable, English description of the error - `retryAfterSec` (required): integer — Number of seconds to wait before attempting a similar request **500** — Internal server error — upstream dependency (database or FIND) is unreachable or an unexpected error occurred. Content-Type: `application/json` Schema: - object - `code` (required): string — Short identifier for the error, suitable for indicating the specific error within client code - `fields`: array — List of the specific fields, and the errors found with their contents - items: - `code` (required): string — Short identifier for the error, suitable for indicating the specific error within client code - `message`: string — Human-readable, English description of the problem with the contents of the field - `path` (required): string —
              - `pathRelated`: string — JSONPath referring to a field containing an error, which is referenced by `path` - `message`: string — Human-readable, English description of the error