GoDaddy

GoDaddy Expiry Auctions: Registrar Partners API

API for auction-related actions exclusive to whitelisted partners.

GitHub OpenAPI

Operations 3

GET /v1/customers/{customerId}/auctions/listings Get listings from GoDaddy Auctions #
DELETE /v1/aftermarket/listings Remove listings from GoDaddy Auction #
POST /v1/aftermarket/listings/expiry Add expiry listings into GoDaddy Auction #

Documentation

📖
Documentation
https://developer.godaddy.com/doc/endpoint/domains
📖
Documentation
https://developer.godaddy.com/doc/endpoint/certificates
📖
Documentation
https://developer.godaddy.com/doc/endpoint/shoppers
📖
Documentation
https://developer.godaddy.com/doc/endpoint/subscriptions
📖
Documentation
https://developer.godaddy.com/doc/endpoint/orders
📖
Documentation
https://developer.godaddy.com/doc/endpoint/aftermarket
📖
Documentation
https://developer.godaddy.com/doc/endpoint/abuse
📖
Documentation
https://developer.godaddy.com/doc/endpoint/agreements
📖
Documentation
https://developer.godaddy.com/doc/endpoint/countries

Specifications

⚙
OpenAPI
https://raw.githubusercontent.com/api-evangelist/godaddy/refs/heads/main/openapi/godaddy-expiry-auctions-registrar-partners-api-openapi.yml

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API 
curl "https://apis.io/api/v1/apis/godaddy-expiry-auctions-registrar-partners-api"
All apis 
curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

godaddy-expiry-auctions-registrar-partners-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  title: 'Aftermarket Expiry Auctions: Registrar Partners API'
  version: 1.0.0
  description: API for auction-related actions exclusive to whitelisted partners.
tags:
- name: 'Expiry Auctions: Registrar Partners'
  description: API for auction-related actions exclusive to whitelisted partners.
paths:
  /v1/customers/{customerId}/auctions/listings:
    get:
      tags:
      - 'Expiry Auctions: Registrar Partners'
      parameters:
      - name: customerId
        required: true
        in: path
        description: An identifier for a customer.
        schema:
          type: string
      - name: domains
        required: false
        in: query
        description: 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`
        schema:
          type: string
      - name: listingStatus
        required: false
        in: query
        description: Only include results for the specified listing status.
        schema:
          type: string
          enum:
          - FULFILLED
      - name: transferBefore
        required: false
        in: query
        description: 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.
        schema:
          type: string
          format: iso-datetime
      - name: transferAfter
        required: false
        in: query
        description: 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.
        schema:
          type: string
          format: iso-datetime
      - name: limit
        required: false
        in: query
        description: Maximum number of items to return.
        schema:
          type: integer
          format: integer-positive
      - name: offset
        required: false
        in: query
        description: Number of results to skip for pagination.
        schema:
          type: integer
          format: integer-positive
      responses:
        '200':
          description: Request was successful
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Listings'
        '400':
          description: Request was malformed
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '401':
          description: Authentication info not sent or invalid
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '403':
          description: Authenticated user is not allowed access
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '422':
          description: Required parameters must be specified in correct format
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '429':
          description: Too many requests received within interval
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorLimit'
        '500':
          description: Internal server error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
      operationId: getListings
      summary: Get listings from GoDaddy Auctions
  /v1/aftermarket/listings:
    delete:
      tags:
      - 'Expiry Auctions: Registrar Partners'
      parameters:
      - description: A comma separated list of domain names
        in: query
        name: domains
        required: true
        schema:
          type: array
          items:
            type: string
      responses:
        '200':
          description: Request was successful
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AftermarketListingAction'
            application/javascript:
              schema:
                $ref: '#/components/schemas/AftermarketListingAction'
            application/xml:
              schema:
                $ref: '#/components/schemas/AftermarketListingAction'
            text/javascript:
              schema:
                $ref: '#/components/schemas/AftermarketListingAction'
            text/xml:
              schema:
                $ref: '#/components/schemas/AftermarketListingAction'
        '400':
          description: Request was malformed
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
            application/javascript:
              schema:
                $ref: '#/components/schemas/Error'
            application/xml:
              schema:
                $ref: '#/components/schemas/Error'
            text/javascript:
              schema:
                $ref: '#/components/schemas/Error'
            text/xml:
              schema:
                $ref: '#/components/schemas/Error'
        '401':
          description: Authentication info not sent or invalid
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
            application/javascript:
              schema:
                $ref: '#/components/schemas/Error'
            application/xml:
              schema:
                $ref: '#/components/schemas/Error'
            text/javascript:
              schema:
                $ref: '#/components/schemas/Error'
            text/xml:
              schema:
                $ref: '#/components/schemas/Error'
        '403':
          description: Authenticated user is not allowed access
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
            application/javascript:
              schema:
                $ref: '#/components/schemas/Error'
            application/xml:
              schema:
                $ref: '#/components/schemas/Error'
            text/javascript:
              schema:
                $ref: '#/components/schemas/Error'
            text/xml:
              schema:
                $ref: '#/components/schemas/Error'
        '422':
          description: "\tRequired parameters must be specified in correct format"
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
            application/javascript:
              schema:
                $ref: '#/components/schemas/Error'
            application/xml:
              schema:
                $ref: '#/components/schemas/Error'
            text/javascript:
              schema:
                $ref: '#/components/schemas/Error'
            text/xml:
              schema:
                $ref: '#/components/schemas/Error'
        '429':
          description: Too many requests received within interval
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorLimit'
            application/javascript:
              schema:
                $ref: '#/components/schemas/ErrorLimit'
            application/xml:
              schema:
                $ref: '#/components/schemas/ErrorLimit'
            text/javascript:
              schema:
                $ref: '#/components/schemas/ErrorLimit'
            text/xml:
              schema:
                $ref: '#/components/schemas/ErrorLimit'
        '500':
          description: Internal server error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
            application/javascript:
              schema:
                $ref: '#/components/schemas/Error'
            application/xml:
              schema:
                $ref: '#/components/schemas/Error'
            text/javascript:
              schema:
                $ref: '#/components/schemas/Error'
            text/xml:
              schema:
                $ref: '#/components/schemas/Error'
      operationId: deleteListings
      summary: Remove listings from GoDaddy Auction
  /v1/aftermarket/listings/expiry:
    post:
      tags:
      - 'Expiry Auctions: Registrar Partners'
      responses:
        '200':
          description: Request was successful
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AftermarketListingAction'
            application/javascript:
              schema:
                $ref: '#/components/schemas/AftermarketListingAction'
            application/xml:
              schema:
                $ref: '#/components/schemas/AftermarketListingAction'
            text/javascript:
              schema:
                $ref: '#/components/schemas/AftermarketListingAction'
            text/xml:
              schema:
                $ref: '#/components/schemas/AftermarketListingAction'
        '400':
          description: Request was malformed
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
            application/javascript:
              schema:
                $ref: '#/components/schemas/Error'
            application/xml:
              schema:
                $ref: '#/components/schemas/Error'
            text/javascript:
              schema:
                $ref: '#/components/schemas/Error'
            text/xml:
              schema:
                $ref: '#/components/schemas/Error'
        '401':
          description: Authentication info not sent or invalid
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
            application/javascript:
              schema:
                $ref: '#/components/schemas/Error'
            application/xml:
              schema:
                $ref: '#/components/schemas/Error'
            text/javascript:
              schema:
                $ref: '#/components/schemas/Error'
            text/xml:
              schema:
                $ref: '#/components/schemas/Error'
        '403':
          description: Authenticated user is not allowed access
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
            application/javascript:
              schema:
                $ref: '#/components/schemas/Error'
            application/xml:
              schema:
                $ref: '#/components/schemas/Error'
            text/javascript:
              schema:
                $ref: '#/components/schemas/Error'
            text/xml:
              schema:
                $ref: '#/components/schemas/Error'
        '422':
          description: Required parameters must be specified in correct format<br>Too many Listings provided<br>Invalid Losing Registrar Id
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
            application/javascript:
              schema:
                $ref: '#/components/schemas/Error'
            application/xml:
              schema:
                $ref: '#/components/schemas/Error'
            text/javascript:
              schema:
                $ref: '#/components/schemas/Error'
            text/xml:
              schema:
                $ref: '#/components/schemas/Error'
        '429':
          description: Too many requests received within interval
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorLimit'
            application/javascript:
              schema:
                $ref: '#/components/schemas/ErrorLimit'
            application/xml:
              schema:
                $ref: '#/components/schemas/ErrorLimit'
            text/javascript:
              schema:
                $ref: '#/components/schemas/ErrorLimit'
            text/xml:
              schema:
                $ref: '#/components/schemas/ErrorLimit'
        '500':
          description: Internal server error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
            application/javascript:
              schema:
                $ref: '#/components/schemas/Error'
            application/xml:
              schema:
                $ref: '#/components/schemas/Error'
            text/javascript:
              schema:
                $ref: '#/components/schemas/Error'
            text/xml:
              schema:
                $ref: '#/components/schemas/Error'
      operationId: addExpiryListings
      summary: Add expiry listings into GoDaddy Auction
      requestBody:
        content:
          application/json:
            schema:
              items:
                $ref: '#/components/schemas/AftermarketListingExpiryCreate'
              type: array
          application/xml:
            schema:
              items:
                $ref: '#/components/schemas/AftermarketListingExpiryCreate'
              type: array
          text/xml:
            schema:
              items:
                $ref: '#/components/schemas/AftermarketListingExpiryCreate'
              type: array
        description: An array of expiry listings to be loaded
        required: true
components:
  schemas:
    Pagination:
      type: object
      properties:
        first:
          type: string
          description: URI to access the first page
        previous:
          type: string
          description: URI to access the previous page
        next:
          type: string
          description: URI to access the next page
        last:
          type: string
          description: URI to access the last page
        total:
          type: integer
          description: Number of records available
    Listings:
      type: object
      properties:
        listings:
          description: Array of listings
          type: array
          items:
            $ref: '#/components/schemas/Listing'
        pagination:
          $ref: '#/components/schemas/Pagination'
    AftermarketListingExpiryCreate:
      properties:
        domain:
          description: Domain name
          type: string
        expiresAt:
          description: Date when the domain expires
          format: iso-datetime
          type: string
        losingRegistrarId:
          default: 1
          description: Losing registrar id for the domain
          minimum: 1
          type: integer
        pageViewsMonthly:
          description: Monthly traffic page view for the domain
          type: integer
        revenueMonthly:
          description: Monthly parking revenue (in USD micro unit) for the domain
          type: integer
      required:
      - domain
      - expiresAt
      - losingRegistrarId
    Listing:
      type: object
      required:
      - domainName
      properties:
        listingId:
          description: An identifier for the listing.
          type: integer
          format: integer-positive
        domainName:
          description: The domain name for the listing.
          type: string
          format: domain-name
        domainCreatedAt:
          description: Date when the domain was first registered in ISO-8601 format
          format: iso-datetime
          type: string
        domainExpiresAt:
          description: Date when the domain expires in ISO-8601 format
          format: iso-datetime
          type: string
        domainRegistrarIanaId:
          description: Source registrar IANA id for the domain name. Reference - https://www.iana.org/assignments/registrar-ids/registrar-ids.xhtml
          type: integer
          format: integer-positive
        pageViewsMonthly:
          description: Monthly traffic page view for the domain
          type: integer
          format: integer-positive
        revenueMonthly:
          description: Monthly parking revenue (in USD micro unit) for the domain
          type: integer
          format: currency-micro-unit-positive
        auctionStartAt:
          description: The UTC date and time, in RFC 3339 format, that the auction starts.
          format: iso-datetime
          type: string
          example: '2022-04-01T02:07:14Z'
        auctionEndAt:
          description: The UTC date and time, in RFC 3339 format, that the auction ends.
          format: iso-datetime
          type: string
          example: '2022-04-10T02:07:14Z'
        auctionTransferAt:
          description: The UTC date and time, in RFC 3339 format, that the auction domain is transferred. Applicable only for listings in `FULFILLED` status.
          format: iso-datetime
          type: string
          example: '2022-04-15T02:07:14Z'
        auctionSoldAt:
          description: The UTC date and time, in RFC 3339 format, that the auction domain is sold. Applicable only for listings in `FULFILLED` status.
          format: iso-datetime
          type: string
          example: '2022-04-20T02:07:14Z'
        auctionBookingAmountUsd:
          description: The booking amount (in USD micro units) for the auction domain. Applicable only for listings in `FULFILLED` status.
          type: integer
          format: currency-micro-unit-positive
        createdAt:
          type: string
          format: iso-datetime
        updatedAt:
          type: string
          format: iso-datetime
    AftermarketListingAction:
      properties:
        listingActionId:
          description: Action Id
          type: integer
      required:
      - listingActionId
    ErrorField:
      properties:
        code:
          description: Short identifier for the error, suitable for indicating the specific error within client code
          format: constant
          type: string
        message:
          description: Human-readable, English description of the problem with the contents of the field
          type: string
        path:
          description: '<ul>

            <li style=''margin-left: 12px;''>JSONPath referring to a field containing an error</li>

            <strong style=''margin-left: 12px;''>OR</strong>

            <li style=''margin-left: 12px;''>JSONPath referring to a field that refers to an object containing an error, with more detail in `pathRelated`</li>

            </ul>'
          format: json-path
          type: string
        pathRelated:
          description: JSONPath referring to a field containing an error, which is referenced by `path`
          format: json-path
          type: string
      required:
      - path
      - code
    ErrorLimit:
      properties:
        code:
          description: Short identifier for the error, suitable for indicating the specific error within client code
          format: constant
          type: string
        fields:
          description: List of the specific fields, and the errors found with their contents
          items:
            $ref: '#/components/schemas/ErrorField'
          type: array
        message:
          description: Human-readable, English description of the error
          type: string
        retryAfterSec:
          description: Number of seconds to wait before attempting a similar request
          format: integer-positive
          type: integer
      required:
      - retryAfterSec
      - code
    Error:
      properties:
        code:
          description: Short identifier for the error, suitable for indicating the specific error within client code
          format: constant
          type: string
        fields:
          description: List of the specific fields, and the errors found with their contents
          items:
            $ref: '#/components/schemas/ErrorField'
          type: array
        message:
          description: Human-readable, English description of the error
          type: string
      required:
      - code