Where a short link goes, without recording anything

Where a short link goes, without recording anything (user opted out).

THE CALL, PART BY PART

method

POST

host

strait.link

version

/v1

resource

/lookup

POST /v1/lookup

Auth: publishable key as publishableKey in the JSON body. Safe in apps and websites.

Request

Called by the Strait SDKs instead of /v1/resolve when the app's user has opted out (setEnabled(false)), so a short link that opens the app still lands on the right screen. Same lookup as /v1/resolve (scoped to the key's workspace, old Firebase host + code first), but nothing is recorded: no tap, no app open, no counter, no webhook, and no clickId comes back. Only publishableKey and url are read, and Strait's code writes no IP address or user agent for this call (our hosting providers keep their usual short-lived request logs). An A/B link answers one variant at random. Rate limited per IP.

Body (JSON)

publishableKey required string
url required string

Response

  • 200 { matched, longUrl?, linkId?, slug?, reason? } — reason: not_found | link_unavailable (blocked for abuse or an unsafe destination) | expired | not_live (scheduled, before go-live) | password_protected | long_link (an old page.link long link: read its link= in the app).
  • 400 url is not a short link
  • 401 Missing or invalid key
  • 429 Too many lookups from this IP; try again shortly
Request · curl
curl -X POST https://strait.link/v1/lookup \
  -H "Content-Type: application/json" \
  -d '{
    "publishableKey": "st_pub_live_…",
    "url": "https://hilltop.strait.link/summer"
  }'

The response, printed

Response 200
{
  "matched": true,
  "longUrl": "https://shop.example.com/sale/summer?utm_source=whatsapp&utm_campaign=summer-2026",
  "linkId": "lnk_5f0c2a8e-3b1d-4f6a-9c7e-2d8b1a0e4f63",
  "slug": "summer"
}