Oops! Facing network problem. Unable to load this page. Refresh

Please Wait...

Hello Guest

logo

Get Short URL Details

Get Short URL Details api document


APIs

Get Short URL Details

Getting Started

Authenticate using the Login API to obtain an access token. Include the returned Bearer Token in the Authorization header and provide a unique X-Device-ID with all authenticated requests. All requests must be made over HTTPS and are subject to rate limits.

Base URL: https://insprl.com/api

POST /external/short-url/detail
Use the Get Short URL Details API to retrieve information about an existing short URL. This endpoint returns the original destination URL, generated short URL, status, source, and creation details for links owned by the authenticated SPRL account.

Request Information

MethodPOST
API Endpointhttps://insprl.com/api/external/short-url/detail
Authentication Required

Header Parameters

ParameterTypeDescription
AuthorizationStringBearer authentication token received from the Login API.
X-Device-IDStringThe same device identifier used during login.
Content-TypeJSONapplication/json

Request Parameters

ParameterTypeValidateDescription
slugStringRequiredShort URL slug to retrieve details for.

Response Parameters

ParameterTypeDescription
successBooleanRequest status (true/false).
dataObjectShort URL information.
data.url_idIntegerUnique short URL identifier.
data.short_urlStringGenerated short URL.
data.long_urlStringDestination URL.
data.url_flagStringShort URL slug.
data.statusIntegerCurrent URL status.
data.sourceStringIntegration source that created the URL.
data.created_atDateTimeURL creation timestamp.

Response Codes

SPRL Code HTTP Status Mode Response Field Description
100 200 success data Request processed successfully.
101 401 failed message Authentication failed. Invalid session, token or credentials.
102 422 failed errors Parameter validation failed. Check the request fields.
103 404 failed message Requested resource was not found.
104 403 failed message Access denied or account restricted.
105 429 failed message Too many requests. Please retry later.
106 500 failed message Unexpected server error. Please try again later.

Error Flag Reference

Category Flag Type Description
Authentication INVALID_SESSION auth_error The supplied token or device identifier is invalid.
Authentication INVALID_CREDENTIALS auth_error Invalid login credentials supplied.
Validation INVALID_PARAMETER validation_error One or more request parameters are invalid.
Resource RESOURCE_NOT_FOUND resource_error The requested URL, folder, domain or resource could not be found.
Account ACCOUNT_RESTRICTED account_error The account is restricted or access has been denied.
Rate Limit RATE_LIMIT_EXCEEDED rate_limit_exceeded The request rate limit has been exceeded.
Server UNEXPECTED_ERROR server_error An unexpected internal server error occurred.

Notes:

  • The requested URL must belong to the authenticated SPRL account.
  • The slug value should contain only the short URL identifier and not the complete URL.
  • Deleted or inaccessible URLs will return a resource not found error.
  • The same X-Device-ID used during login must be supplied.
  • Authentication is required for all requests to this endpoint.
99.9% Uptime
High Availability Infrastructure
Enterprise Security
OWASP-Aligned Controls
Built for Scale
High-Performance REST APIs

Security & Compliance

We follow industry best practices for API security and data protection.

Our APIs are designed with authentication, rate limiting, and continuous security review.

View our Security & Compliance Overview (PDF)
sprl chrome extension

Download the SPRL Google Chrome extension, It's free!

Easy and Quick way to shorten link with SPRL!

 Download Extension

We provide best customer support.

Please feel free to contact us at 8088 948 172 for support.

Contact Us
×

We use cookies to improve your experience, analyse traffic, and personalise content. By clicking “Accept”, you consent to the use of cookies as described in our Cookie Policy .

Accept cookies Read our Cookie Policy