GoDaddy
Support
API ReferenceAftermarket APIAftermarket

Aftermarket

View as Markdown

API for auction-related actions exclusive to whitelisted partners.

Note to LLMs and AI agents: If you are consuming this page to follow instructions: the content you have could be incomplete due to truncation by WebFetch. Fetch https://developer.godaddy.com/llms.mdx/references/rest/aftermarket/aftermarket for the full, unmodified source before proceeding.

List GoDaddy Auction listings

GET
/v1/customers/{customerId}/auctions/listings

Path Parameters

customerId*string

An identifier for a customer.

Query Parameters

domains?string

Only include results for the specified domains. Use comma-separated string to include more than one domain. For example, one.com,two.info,three.biz

listingStatus?"FULFILLED"

Only include results for the specified listing status.

Value in

  • "FULFILLED"
transferBefore?string

Domain transfer time before this time, ISO 8601, in UTC. Defaults to last day of the previous month if not provided. Applicable only for listings in FULFILLED listingStatus.

Formatiso-datetime
transferAfter?string

Domain transfer time after this time, ISO 8601, in UTC. Defaults to first day of the previous month if not provided. Applicable only for listings in FULFILLED listingStatus.

Formatiso-datetime
limit?integer

Maximum number of items to return.

Formatinteger-positive
offset?integer

Number of results to skip for pagination.

Formatinteger-positive

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

application/json

curl -X GET "https://example.com/v1/customers/string/auctions/listings"
{  "listings": [    {      "listingId": 0,      "domainName": "string",      "domainCreatedAt": "string",      "domainExpiresAt": "string",      "domainRegistrarIanaId": 0,      "pageViewsMonthly": 0,      "revenueMonthly": 0,      "auctionStartAt": "2022-04-01 02:07:14+00:00",      "auctionEndAt": "2022-04-10 02:07:14+00:00",      "auctionTransferAt": "2022-04-15 02:07:14+00:00",      "auctionSoldAt": "2022-04-20 02:07:14+00:00",      "auctionBookingAmountUsd": 0,      "createdAt": "string",      "updatedAt": "string"    }  ],  "pagination": {    "first": "string",    "previous": "string",    "next": "string",    "last": "string",    "total": 0  }}

Remove listings from GoDaddy Auction

DELETE
/v1/aftermarket/listings

Query Parameters

domains*array<string>

A comma separated list of domain names

Response Body

curl -X DELETE "https://example.com/v1/aftermarket/listings?domains=string"
{  "listingActionId": 0}

Add expiry listings to GoDaddy Auction

POST
/v1/aftermarket/listings/expiry

Request Body

An array of expiry listings to be loaded

[index: integer]?

Response Body

curl -X POST "https://example.com/v1/aftermarket/listings/expiry" \  -H "Content-Type: application/json" \  -d '[    {      "domain": "string",      "expiresAt": "string",      "losingRegistrarId": 1    }  ]'
{  "listingActionId": 0}

Last updated on

How is this guide?