Skip to main content

Retrieve Short URL Details

Description

To retrieve details of a short URL, it is necessary to make a GET request to the SHORT URL API endpoint with the "masked_url_id"

Production Endpoint URL: https://api.cpaas.symphony.rakuten.net/short-url/v1/url/$masked_url_id

Methods: GET

HTTP Headers

ParameterRequiredValue
AuthenticationYType: Bearer
Token: JWT Token
AcceptYapplication/json
Content-TypeYapplication/json; charset=UTF-8

Response:

If successful, the API call will return an HTTP 200 OK with a JSON document as a response. Please see section "Error Codes" for a description of the failure responses.

ParameterDescription
idmasked_url_id
remote_urlDestination URL used for masking
nameName of the Short URL
descriptionDescription of Short URL
valid_until_dateValid until date in yyyy-MM-dd HH:mm:ss
date_createdDate created in yyyy-MM-dd HH:mm:ss
time_last_updatedShort URL last updated in yyyy-MM-dd HH:mm:ss
public_masked_urlhttps://<api.hostname>/<masked_url_id>

Sample Response

{
"id": "masked_url_id",
"remote_url": "...Destination URL...",
"name": "...Name of Short URL...",
"description": "...Description of Short URL...",
"valid_until_date": "...Valid until date in yyyy-MM-dd HH:mm:ss...",
"date_created": "...Date created in yyyy-MM-dd HH:mm:ss...",
"time_last_updated": "...Short URL last updated in yyyy-MM-dd HH:mm:ss...",
"public_masked_url": "https://<api.hostname>/<masked_url_id>"
}