---
title: "Get listings from GoDaddy Auctions"
method: GET
path: "/v1/customers/{customerId}/auctions/listings"
tags: ["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

- `customerId` string, required

## Query parameters

- `domains` string
- `listingStatus` 'FULFILLED'
- `transferBefore` string, iso-datetime
- `transferAfter` string, iso-datetime
- `limit` integer
- `offset` integer

## Response `200`

Request was successful

- Listings
  - `listings` Listing[]: Array of listings
    - `listingId` integer: An identifier for the listing.
    - `domainName` string, domain-name, required: The domain name for the listing.
    - `domainCreatedAt` string, iso-datetime: Date when the domain was first registered in ISO-8601 format
    - `domainExpiresAt` string, iso-datetime: Date when the domain expires in ISO-8601 format
    - `domainRegistrarIanaId` integer: Source registrar IANA id for the domain name. Reference - https://www.iana.org/assignments/registrar-ids/registrar-ids.xhtml
    - `pageViewsMonthly` integer: Monthly traffic page view for the domain
    - `revenueMonthly` integer: Monthly parking revenue (in USD micro unit) for the domain
    - `auctionStartAt` string, iso-datetime: The UTC date and time, in RFC 3339 format, that the auction starts.
    - `auctionEndAt` string, iso-datetime: The UTC date and time, in RFC 3339 format, that the auction ends.
    - `auctionTransferAt` string, iso-datetime: The UTC date and time, in RFC 3339 format, that the auction domain is transferred. Applicable only for listings in `FULFILLED` status.
    - `auctionSoldAt` string, iso-datetime: The UTC date and time, in RFC 3339 format, that the auction domain is sold. Applicable only for listings in `FULFILLED` status.
    - `auctionBookingAmountUsd` integer: The booking amount (in USD micro units) for the auction domain. Applicable only for listings in `FULFILLED` status.
    - `createdAt` string, iso-datetime
    - `updatedAt` string, iso-datetime
  - `pagination` Pagination
    - `first` string: URI to access the first page
    - `previous` string: URI to access the previous page
    - `next` string: URI to access the next page
    - `last` string: URI to access the last page
    - `total` integer: Number of records available

## Other responses

- `400`: Request was malformed
- `401`: Authentication info not sent or invalid
- `403`: Authenticated user is not allowed access
- `422`: Required parameters must be specified in correct format
- `429`: Too many requests received within interval
- `500`: Internal server error

---

[API](https://skmtc.dev/godaddy/apis/aftermarket-api.md) - [All operations](https://skmtc.dev/godaddy/apis/aftermarket-api/llms.txt) - [OpenAPI document](https://skmtc.dev/godaddy/apis/aftermarket-api/revisions/d0448818345a?raw)