# Register and Renew Domains (https://developer.godaddy.com/en/docs/references/rest/domains/v1/register-and-renew-domains)

***

title: Register and Renew Domains
full: true
\_openapi:
preload:

* ./openapi-specs/specs/domains-v1.yaml
  toc:
* depth: 2
  title: Retrieve the legal agreement(s) required to purchase the specified TLD
  and add-ons
  url: '#retrieve-the-legal-agreements-required-to-purchase-the-specified-tld-and-add-ons'
* depth: 2
  title: Purchase and register the specified Domain
  url: '#purchase-and-register-the-specified-domain'
* depth: 2
  title: Retrieve the schema to be submitted when registering a Domain for the
  specified TLD
  url: '#retrieve-the-schema-to-be-submitted-when-registering-a-domain-for-the-specified-tld'
* depth: 2
  title: Validate the request body using the Domain Purchase Schema for the
  specified TLD
  url: '#validate-the-request-body-using-the-domain-purchase-schema-for-the-specified-tld'
* depth: 2
  title: Retrieves a list of TLDs supported and enabled for sale
  url: '#retrieves-a-list-of-tlds-supported-and-enabled-for-sale'
* depth: 2
  title: Renew the specified Domain
  url: '#renew-the-specified-domain'
  structuredData:
  headings:
  * content: Retrieve the legal agreement(s) required to purchase the specified TLD
    and add-ons
    id: retrieve-the-legal-agreements-required-to-purchase-the-specified-tld-and-add-ons
  * content: Purchase and register the specified Domain
    id: purchase-and-register-the-specified-domain
  * content: Retrieve the schema to be submitted when registering a Domain for the
    specified TLD
    id: retrieve-the-schema-to-be-submitted-when-registering-a-domain-for-the-specified-tld
  * content: Validate the request body using the Domain Purchase Schema for the
    specified TLD
    id: validate-the-request-body-using-the-domain-purchase-schema-for-the-specified-tld
  * content: Retrieves a list of TLDs supported and enabled for sale
    id: retrieves-a-list-of-tlds-supported-and-enabled-for-sale
  * content: Renew the specified Domain
    id: renew-the-specified-domain
    contents:
  * content: Returns the TLD-specific legal agreements that must be accepted before
    purchase or transfer. The agreementKeys from this response are
    required in the consent object.
    heading: retrieve-the-legal-agreements-required-to-purchase-the-specified-tld-and-add-ons
  * content: Registers the specified domain. Requires a consent object with
    agreement keys from GET /v1/domains/agreements. Charges the account's
    billing method.
    heading: purchase-and-register-the-specified-domain
  * content: Returns the JSON schema for the domain purchase request body for the
    specified TLD. Fetch before purchasing to identify required fields and
    TLD-specific constraints.
    heading: retrieve-the-schema-to-be-submitted-when-registering-a-domain-for-the-specified-tld
  * content: Validates a purchase request body against the TLD schema with no side
    effects and no charge. Returns 200 on success.
    heading: validate-the-request-body-using-the-domain-purchase-schema-for-the-specified-tld
  * content: Returns all TLDs currently available for registration, including
    pricing and any eligibility requirements.
    heading: retrieves-a-list-of-tlds-supported-and-enabled-for-sale
  * content: Renews the domain for the specified period, extending the expiration
    date. Charges the account's billing method.
    heading: renew-the-specified-domain

***