Skip to main content
GET
/
core
/
v1
/
premiumdomainslist
Download Premium Domain Lists
curl --request GET \
  --url https://api.dev.name.com/core/v1/premiumdomainslist \
  --header 'Authorization: Basic <encoded-value>'
{
  "downloadUrl": "https://name-ote-downloads/PremiumList_123456.zip",
  "expireDate": "2025-09-04T16:45:00Z"
}

Authorizations

​
Authorization
string
header
required

Authenticate via HTTP Basic with your account username and API token. Examples use an explicit 'Authorization: Basic <base64(username:token)>' header; 'curl -u username:token' is equivalent. For sandbox, append "-test" to your username and use your sandbox token on api.dev.name.com.

Response

A successful response containing the pre-signed URL to download the file.

​
downloadUrl
string<uri>
required

The pre-signed URL to use to download the list.

Example:

"https://name-ote-downloads/PremiumList_123456.zip"

​
expireDate
string<date-time>
required

The timestamp that the URL will expire.

Example:

"2025-09-04T16:45:00Z"