Skip to content

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 ​

PropertyTypeRequiredDescription
codestring (path)RequiredThe shortCode returned by Create Short URL (case-sensitive)

Response Description ​

PropertyTypeDescription
statusnumber200 when the link is found
data.shortCodestringShort code
data.originalUrlstringDestination URL
data.domainstringShort-link domain (full link = domain + shortCode)
data.messageIdstringThe messageId sent at creation (empty if none)
data.clickCountnumberNumber of times the link was opened
data.isActivebooleanLink status (true)
data.createdAtstringCreation time (ISO 8601, UTC)
data.expiresAtstringNot 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 ​

HTTPResponseCause
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.