Short URL Stats GET
Returns the details and click count of one short URL by its shortCode. Only links of your own account can be read.
Authorization
API Key (Authentication) — send the header Authorization: Bearer <API_KEY> (API keys start with smsk_)
HTTP Request
http
GET https://public-api.smsup-plus.com/shorten/stats/{code}Content Type
No body — the parameter is sent in the path
Parameter Description
| Property | Type | Required | Description |
|---|---|---|---|
code | string (path) | Required | The shortCode returned by Create Short URL (case-sensitive) |
Response Description
| Property | Type | Description |
|---|---|---|
status | number | 200 when the link is found |
data.shortCode | string | Short code |
data.originalUrl | string | Destination URL |
data.domain | string | Short-link domain (full link = domain + shortCode) |
data.messageId | string | The messageId sent at creation (empty if none) |
data.clickCount | number | Number of times the link was opened |
data.isActive | boolean | Link status (true) |
data.createdAt | string | Creation time (ISO 8601, UTC) |
data.expiresAt | string | Not used — currently always 0001-01-01T00:00:00Z |
Request Example
bash
curl -X GET 'https://public-api.smsup-plus.com/shorten/stats/aB3dE9xZ' \
-H 'Authorization: Bearer <API_KEY>'js
const res = await fetch('https://public-api.smsup-plus.com/shorten/stats/aB3dE9xZ', {
headers: { Authorization: 'Bearer <API_KEY>' },
})
console.log(await res.json())Response Example
json
{
"status": 200,
"data": {
"shortCode": "aB3dE9xZ",
"originalUrl": "https://www.example.com/promotion?utm_source=sms",
"domain": "https://c0c.me/",
"messageId": "PROMO-2026-11",
"clickCount": 37,
"isActive": true,
"createdAt": "2026-11-16T03:15:42.512Z",
"expiresAt": "0001-01-01T00:00:00Z"
}
}Possible Errors
| HTTP | Response | Cause |
|---|---|---|
| 401 | {"error":"invalid api key"} | Invalid API key — see Errors |
| 404 | {"status":404,"description":"short URL not found"} | Unknown code, the link has been deactivated, or it belongs to another account |
TIP
Calling this endpoint is not counted as a click — clickCount only increases when someone actually opens the short link.
