Skip to main content

Get Link by SID

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

get /shortener/links/{link_sid}

Sample

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

curl -X GET \
'https://api.carrierx.com/core/v2/shortener/links/a533f53a-7e6f-4822-be3c-3767924ee2a9' \
-H 'Authorization: Bearer 5ebc03d6-8b2b-44ad-bf65-72d4f1491dda'

Response

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

{
"date_accessed": null,
"date_created": "2024-01-18T19:26:02.000Z",
"destination_url": "http://destinationurl.com",
"domain_sid": "330a8a83-d4bb-4f39-ae54-c59c8d87cd44",
"hits": 0,
"link_sid": "a533f53a-7e6f-4822-be3c-3767924ee2a9",
"maximum_ttl": -1,
"mode": "redirect_temporary",
"partner_sid": "e00430c3-a7d0-4666-ab5c-f7202448382f",
"short_name": "eOtEtO",
"url": "http://newdomain.com/eOtEtO"
}

This request is enabled for Field Filtering.

Required Scopes

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

  • shortener.manage
  • shortener.read

Path Arguments

ParameterData TypeDescription
link_sid requiredstringThe link secure ID.