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 pricing 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. 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 legacy API key, exported as GODADDY_API_KEY in your environment
• one or more domain names you want to bid on

Check listing availability

The following procedure confirms whether domains have active expiring auctions listings and retrieves listing details. 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 listing details:

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

Example response:

{
  "availabilities": [
    {
      "domainName": "example.com",
      "status": "AVAILABLE",
      "listingId": 200000,
      "listingMin": {
        "currentBid": 50000000,
        "closingAt": "2026-09-01T18:00:00Z"
      }
    },
    {
      "domainName": "mybrand.net",
      "status": "UNAVAILABLE"
    }
  ]
}

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

• Place bids:

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": 200000,
      "bidAmountUsd": 100000000,
      "tosAccepted": true
    }
  ]'

Example response (200 — all bids placed):

[
  {
    "listingId": 200000,
    "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