---
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`

## 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.net/godaddy/apis/aftermarket-api.md) · [All operations](https://skmtc.net/godaddy/apis/aftermarket-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/godaddy/aftermarket-api/versions/d0448818345a/schema)