Domain Products2026.8.0

Get TLD restrictions

Fetches registration restrictions for specified TLDs from OpenProvider. Results are cached server-side for 24 hours to ensure fast response times. Restrictions include eligibility requirements and WHOIS privacy availability.

GET/api/v1/products/domains/restrictions

The source export uses a local development server. Examples use the configured Dashio API origin.

Authentication

Authentication is not declared in this export. This does not imply anonymous access.

Understand authentication

Path parameters

None declared in this export.

Query parameters

extensionsstringRequired: Comma-separated list of TLD extensions without leading dots (e.g., "us,de,eu,io")

Header parameters

None declared in this export.

Request body

No content type declared

No body schema declared in this export.

Request & response examples

Copy an example in your preferred language.

request.sh

curl --request GET 'https://dashio.net/api/v1/products/domains/restrictions?extensions={extensions}'

Replace URL parameters, credentials, and schema placeholders before running. No request is sent by this page.

Example supplied in the OpenAPI export.

{
  "restrictions": [
    {
      "extension": "us",
      "restrictions": [
        "Local address of the domain owner is required.",
        "The listed nameservers for a .us domain have to be located within the United States."
      ],
      "isPrivateWhoisAllowed": false,
      "dnssecAllowed": true,
      "minPeriod": 1,
      "maxPeriod": 10,
      "transferAvailable": true,
      "renewAvailable": true,
      "status": "ACT"
    }
  ],
  "cached": true,
  "cachedAt": "2026-05-11T10:30:00.000Z"
}

Examples use the configured API origin. Replace credentials, URL parameters, and schema placeholders before running.

Responses

200

TLD restrictions retrieved successfully

restrictionsobject[]Required

No field description supplied.

extensionstringRequired: TLD extension (e.g., "us")
restrictionsstring[]Required: Array of restriction messages
isPrivateWhoisAllowedbooleanRequired: Whether WHOIS privacy is available
dnssecAllowedbooleanRequired: Whether DNSSEC is available
minPeriodintegerRequired: Minimum registration period in years
maxPeriodintegerRequired: Maximum registration period in years
transferAvailablebooleanRequired: Whether transfers are available
renewAvailablebooleanRequired: Whether renewals are available
statusstringRequired: TLD status (e.g., "ACT")

cachedbooleanRequired

Whether the response was served from cache

cachedAtstring | nullOptional

ISO timestamp of when the data was cached

400

Invalid request parameters

errorstringOptional: No field description supplied.
statusintegerOptional: No field description supplied.

500

Server error

errorstringOptional: No field description supplied.
statusintegerOptional: No field description supplied.

Was this helpful?