GET
https://jmpy.me/api/v1
/
short-urls
/
{alias}
Get by Alias
curl --request GET \
  --url https://jmpy.me/api/v1/short-urls/{alias} \
  --header 'Authorization: Bearer <token>'
{
  "id": "<string>",
  "short_code": "<string>",
  "short_url": "<string>",
  "original_url": "<string>",
  "click_count": 123,
  "created_at": "<string>",
  "expires_at": "<string>",
  "tracking_enabled": true
}
Get the full details and current state of a short URL by providing its custom alias (or short code). This is useful for retrieving analytics summaries, checking expiration dates, or verifying destination URLs.

Path Parameters

alias
string
required
The custom alias (or short code) of the short URL.

Response

id
string
Unique identifier (UUID).
short_code
string
The system short code or custom alias.
short_url
string
The full short URL.
original_url
string
The destination URL.
click_count
integer
Total number of clicks tracked.
created_at
string
Creation timestamp (ISO 8601).
expires_at
string
expiration timestamp (ISO 8601) or null.
tracking_enabled
boolean
Whether tracking is active.

Request Examples

curl -X GET "https://jmpy.me/api/v1/short-urls/summer2024" \
  -H "Authorization: Bearer YOUR_API_KEY"

Response Examples

{
  "success": true,
  "data": {
    "id": "550e8400-e29b-41d4-a716-446655440000",
    "short_code": "summer2024",
    "short_url": "https://jmpy.me/summer2024",
    "original_url": "https://example.com/summer-sale",
    "custom_alias": "summer2024",
    "click_count": 1250,
    "created_at": "2024-01-01T12:00:00Z",
    "expires_at": null,
    "tracking_enabled": true
  }
}