Place bids on auction listings

Overview

Bidding lets you compete for domain names on GoDaddy's auctions marketplace. You check which domains have active listings, review the full cost and optional domain signals, and submit bids. The auction closes on a set date. If you hold the highest bid at close, the domain fulfills to your account. A winning bid is binding, and the full cost includes the renewal or transfer price that only the availability response returns. Check those prices before you bid. The following diagram shows the workflow for bidding on domains in the GoDaddy auctions marketplace:

The following article provides a workflow for bidding on domains in the GoDaddy auctions marketplace.

Prerequisites

The following prerequisites are required before you can bid on domains:

• a Classic Developer Key, exported as GODADDY_API_KEY in your environment
• a domain name you want to bid on, exported as DOMAIN_NAME in your environment

Check listing availability

The following procedure confirms whether domains have active expiring auctions listings and retrieves listing details, including renewal and transfer prices. You need the listingId from the response to place bids. You can check up to 50 domains per request.

Use the includes query parameter to attach additional data to AVAILABLE results:

• Check availability with full listing details:

  curlNodePythonGo

  curl -s -X POST "https://api.godaddy.com/v1/customers/MY/aftermarket/listings/available?includes=listing" \
    -H "Authorization: sso-key $GODADDY_API_KEY" \
    -H "Content-Type: application/json" \
    -d "{
      \"domains\": [\"$DOMAIN_NAME\"]
    }"

Example response:

{
  "availabilities": [
    {
      "domainName": "example.com",
      "status": "AVAILABLE",
      "listing": {
        "kind": "FULL",
        "currencyId": "USD",
        "listingId": 696987004,
        "listingType": "EXPIRY_AUCTIONS",
        "auctionEndAt": "2026-09-01T18:00:00Z",
        "priceCurrent": 50000000,
        "priceNextBid": 55000000,
        "priceTransfer": 11990000,
        "priceRenewal": 21990000
      }
    }
  ]
}

priceRenewal and priceTransfer are in micro-units of currencyId. Divide by 1,000,000 for the dollar amount (for example, 21990000 = $21.99). Go to Check aftermarket listing availability for every field the response returns.

Place bids

The following procedure submits up to 20 bids in a single request. Bid amounts are in USD micro-units. Multiply dollars by 1,000,000 (for example, $100.00 = 100000000). Confirm the renewal and transfer prices from Check listing availability before you submit. Export your bid amount in micro-units as BID_AMOUNT_USD.

• Place bids:

  curlNodePythonGo

  curl -s -X POST "https://api.godaddy.com/v1/customers/MY/aftermarket/listings/bids" \
    -H "Authorization: sso-key $GODADDY_API_KEY" \
    -H "Content-Type: application/json" \
    -d "[
      {
        \"listingId\": $LISTING_ID,
        \"bidAmountUsd\": $BID_AMOUNT_USD,
        \"tosAccepted\": true
      }
    ]"

Example response (200—all bids placed):

[
  {
    "listingId": 696987004,
    "isHighestBidder": true,
    "bidId": "e8f0a45d-53c6-49e5-a1f2-08b993960e1b",
    "bidAmountUsd": 100000000,
    "status": "SUCCESS"
  }
]

If the response is 207, inspect each bid's status and failureReason. Successfully placed bids have a bidId for tracking.

Error reference

Last updated on