Skip to content

List Short URLs GET ​

Lists your account's active short URLs, newest first, with pagination.

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/list?page=1&pageSize=20

Content Type ​

No body — parameters are sent in the query string

Parameter Description ​

PropertyTypeRequiredDescription
pageinteger (query)OptionalPage number, starting at 1. Default 1
pageSizeinteger (query)OptionalItems per page, an integer of 1 or more. Default 20, maximum 100 (larger values are capped to 100)

Response Description ​

PropertyTypeDescription
statusnumber200 on success
dataarrayShort URLs (see table below) — may be null when the page is empty
totalnumberTotal number of active short URLs in the account
totalpagenumberTotal number of pages for the given pageSize

data[] ​

PropertyTypeDescription
shortCodestringShort code
originalUrlstringDestination URL
domainstringShort-link domain (full link = domain + shortCode)
accountIdnumberOwning account ID
userIdnumberID of the user who created the link
messageIdstringThe messageId sent at creation (empty if none)
clickCountnumberNumber of times the link was opened
isActivebooleanLink status (this list only returns true)
createdAtstringCreation time (ISO 8601, UTC)
expiresAtstringNot used — currently always 0001-01-01T00:00:00Z (links do not expire)

Request Example ​

bash
curl -X GET 'https://public-api.smsup-plus.com/shorten/list?page=1&pageSize=20' \
  -H 'Authorization: Bearer <API_KEY>'
js
const res = await fetch('https://public-api.smsup-plus.com/shorten/list?page=1&pageSize=20', {
  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/",
      "accountId": 1024,
      "userId": 2048,
      "messageId": "PROMO-2026-11",
      "clickCount": 37,
      "isActive": true,
      "createdAt": "2026-11-16T03:15:42.512Z",
      "expiresAt": "0001-01-01T00:00:00Z"
    }
  ],
  "total": 1,
  "totalpage": 1
}

Possible Errors ​

HTTPResponseCause
401{"error":"invalid api key"}Invalid API key — see Errors
400{"status":400,"description":"page and pageSize must be positive integers"}page or pageSize is not a number, or is 0 or negative
500{"status":500,"description":"failed to query URLs"}Query failed — retry