v1
latestSwagger 2.02026-07-133915.9 KBExpiry Auctions: Registrar Partners
Get listings from GoDaddy Auctions
get/v1/customers/{customerId}/auctions/listings
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"
}
]
}