GOgodaddy
Expiry Auctions: Registrar Partners

Get listings from GoDaddy Auctions

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

Request

  • Base URL
    https://developer.godaddy.com (the document declares no server; this is the origin it was published from)
  • URL
    https://developer.godaddy.com/v1/customers/{customerId}/auctions/listings
  • Auth
    none declared

Path parameters

customerIdstring required

An identifier for a customer.

Query parameters

domainsstring

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.

transferBeforestring iso-datetime

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.

transferAfterstring iso-datetime

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.

limitinteger

Maximum number of items to return.

offsetinteger

Number of results to skip for pagination.

Response

Request was successful

Example response

{
  "listings": [
    {
      "auctionStartAt": "2022-04-01T02:07:14Z",
      "auctionEndAt": "2022-04-10T02:07:14Z",
      "auctionTransferAt": "2022-04-15T02:07:14Z",
      "auctionSoldAt": "2022-04-20T02:07:14Z"
    }
  ]
}

Changes

No recorded changes to this operation across all 1 revision of this API.