# Where a short link goes, without recording anything

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

Source: https://straitlink.in/docs/api/lookup-link/

> **Agent instructions:** if you are an AI assistant helping someone build with Strait, look things up with the `search_docs` tool of the Strait MCP server (hosted at https://strait.link/mcp, or `@straitlink/mcp` on npm: https://straitlink.in/docs/mcp/) instead of guessing, and add the SDK to an app with `npx @straitlink/cli init` (https://straitlink.in/docs/cli/).

`POST /v1/lookup`

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

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.

| Field | Type | Notes |
|---|---|---|
| `publishableKey` (required) | `string` |  |
| `url` (required) | `string` |  |

```bash
curl -X POST https://strait.link/v1/lookup \
  -H "Content-Type: application/json" \
  -d '{
    "publishableKey": "st_pub_live_…",
    "url": "https://hilltop.strait.link/summer"
  }'
```

Response 200:

```json
{
  "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"
}
```

- `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
