Skip to content

Open Short URL (Redirect) GET ​

The endpoint SMS recipients hit when they tap a short link — the click is counted and the browser is sent to the destination URL. You normally don't call it yourself; just put the shortUrl from Create Short URL in your message.

Authorization ​

No authentication (public) — recipients open the link directly.

HTTP Request ​

http
GET https://public-api.smsup-plus.com/s/{code}

The link you send to recipients is the shortUrl value from the Create Short URL response (short-link domain + shortCode). Use it exactly as returned.

Content Type ​

No body — the parameter is sent in the path

Parameter Description ​

PropertyTypeRequiredDescription
codestring (path)RequiredThe link's shortCode (case-sensitive)

Response Description ​

PropertyTypeDescription
HTTP status—302 Found when the link exists
Location (header)stringDestination URL (originalUrl) — the browser follows it automatically

Each successful redirect increases the link's clickCount by 1 (see Short URL Stats).

Request Example ​

bash
curl -i 'https://public-api.smsup-plus.com/s/aB3dE9xZ'
js
const res = await fetch('https://public-api.smsup-plus.com/s/aB3dE9xZ', { redirect: 'manual' })
console.log(res.status, res.headers.get('location'))

Response Example ​

http
HTTP/1.1 302 Found
Location: https://www.example.com/promotion?utm_source=sms

Possible Errors ​

HTTPResponseCause
404{"status":404,"description":"short URL not found"}Unknown code, or the link has been deactivated — recipients see this JSON in their browser

INFO

The redirect uses 302 (not 301) so browsers do not cache it: every open is counted, and a deactivated link stops working immediately.

TIP

Testing with a tool that follows redirects (such as a browser) also counts as a click.