Skip to main content

Get Domain by SID

This request returns data for a domain, targeted by secure ID.

get /shortener/domains/{domain_sid}

Sample

A sample GET request to get a domain, targeted by secure ID:

curl -X GET \
'https://api.carrierx.com/core/v2/shortener/domains/a0625551-63de-428e-889d-2d467b4e77a3' \
-H 'Authorization: Bearer 5ebc03d6-8b2b-44ad-bf65-72d4f1491dda'

Response

200 status code with a serialized copy of the Domain object:

{
"domain_name": "newdomain.com",
"domain_sid": "a0625551-63de-428e-889d-2d467b4e77a3",
"expired_mode": "redirect_temporary",
"expired_page": null,
"expired_status_code": null,
"minimum_length": 6,
"not_found_mode": "redirect_temporary",
"not_found_page": null,
"not_found_status_code": null,
"partner_sid": "e00430c3-a7d0-4666-ab5c-f7202448382f",
"scope": "children",
"secure": "disabled",
"suffix_pattern": null
}

This request is enabled for Field Filtering.

Required Scopes

To get information about a Domain object, the partner must have one of the following scopes enabled:

  • shortener.manage
  • shortener.read

Path Arguments

ParameterData TypeDescription
domain_sid requiredstringThe domain secure ID.