Skip to main content
GET
/
core
/
v1
/
domains
/
{domainName}
/
url
/
forwarding
/
{host}
Get URLForwarding
curl --request GET \
  --url https://api.dev.name.com/core/v1/domains/{domainName}/url/forwarding/{host} \
  --header 'Authorization: Basic <encoded-value>'
{
  "domainName": "example.org",
  "forwardsTo": "https://destination-site.com",
  "host": "www.example.org",
  "meta": "<meta name='keywords' content='website, forwarding, masked'>",
  "title": "Welcome to my forwarded website",
  "type": "redirect"
}

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.

Path Parameters

​
domainName
string<hostname>
required

DomainName is the domain to get the URL forwarding entry for.

Example:

"example.com"

​
host
string<hostname>
required

The full hostname, including subdomain.

Example:

"www.example.org"

Response

A successful response containing the requested URL forwarding entry.

URLForwarding represents a URL forwarding entry response, allowing a domain to redirect to another URL using different forwarding methods. URLForwarding represents a URL forwarding entry, allowing a domain to redirect to another URL using different forwarding methods.

​
forwardsTo
string<uri>
required

The destination URL to which this hostname will be forwarded.

Example:

"https://destination-site.com"

​
host
string<hostname>
required

The subdomain portion of the hostname that is being forwarded. The complete hostname that is being forwarded (subdomain + domain).

Example:

"www.example.org"

​
type
enum<string>
required

The type of URL forwarding. Valid values:

  • masked: Retains the original domain in the address bar, preventing the user from seeing the actual destination URL. Sometimes called iframe forwarding.
  • redirect: Uses a standard HTTP redirect (301), which changes the address bar to the destination URL.
  • 302: Uses a temporary HTTP redirect (302), which changes the address bar to the destination URL but indicates the resource is temporarily located elsewhere.
Available options:
masked,
redirect,
302
Example:

"redirect"

​
domainName
string<hostname>

The domain name (without subdomains) that is being forwarded.

Example:

"example.org"

​
meta
string | null

Meta tags to include in the HTML page when using "masked" forwarding. Ignored for other forwarding types. Example: <meta name='keywords' content='fish, denver, platte'>

Example:

"<meta name='keywords' content='website, forwarding, masked'>"

​
title
string | null

The title to be used for the HTML page when using "masked" forwarding. Ignored for other forwarding types.

Example:

"Welcome to my forwarded website"

⌘I