Read the app setup

THE CALL, PART BY PART

method

GET

host

strait.link

version

/v1

resource

/app

GET /v1/app

Auth: secret key as Authorization: Bearer. Server-side only.

Request

Your app as Strait sees it, so an AI coding agent can compare it with the app's build files: the Android package, signing fingerprints and scheme; the iPhone Team ID, bundle ID and App Store ID; every host Strait serves your links on (<handle>.strait.link and verified custom domains) with the assetlinks.json and apple-app-site-association it publishes there and whether the scheduled check (every few minutes) found each one served correctly (served: null = not checked yet); and, per platform, the SDK that sent the newest app open among your newest 1,000 opens of the last 30 days (lastSeenAt: the newest app open; reported: the newest version sent; sdk is null when the version alone can't tell which SDK). Changes are made in Dashboard › Setup › Your apps (setupUrl). Nothing secret is returned. Secret key with read or full access; 30 calls a minute per workspace.

No parameters.

Response

  • 200 The app setup
  • 401 Missing or invalid secret key, or a publishable key
  • 403 The key is limited to links
  • 429 Over 30 calls a minute for this workspace (Retry-After)
Request · curl
curl -X GET https://strait.link/v1/app \
  -H "Authorization: Bearer $SECRET_KEY"

The response, printed

Response 200
{
  "android": {
    "packageName": "com.hilltop.shoes",
    "sha256Fingerprints": [
      "AA:BB:…:99"
    ],
    "scheme": "hilltop",
    "appLinksReady": true
  },
  "ios": {
    "teamId": "ABCDE12345",
    "bundleId": "com.hilltop.shoes",
    "appId": "ABCDE12345.com.hilltop.shoes",
    "appStoreId": "1234567890",
    "appClipBundleId": null,
    "universalLinksReady": true
  },
  "domains": [
    {
      "host": "hilltop.strait.link",
      "kind": "link",
      "files": [
        {
          "platform": "android",
          "url": "https://hilltop.strait.link/.well-known/assetlinks.json",
          "served": true,
          "since": "2026-11-01T09:00:00.000Z"
        },
        {
          "platform": "ios",
          "url": "https://hilltop.strait.link/.well-known/apple-app-site-association",
          "served": true,
          "since": "2026-11-01T09:00:00.000Z"
        }
      ]
    }
  ],
  "filesCheckedAt": "2026-11-09T11:55:00.000Z",
  "sdk": {
    "android": {
      "sdk": "react-native",
      "version": "0.11.2",
      "reported": "react-native/0.11.2",
      "versionSeenAt": "2026-11-09T10:02:11.000Z",
      "lastSeenAt": "2026-11-09T10:02:11.000Z"
    },
    "ios": null,
    "web": null
  },
  "sdkWindow": {
    "days": 30,
    "newestOpens": 1000
  },
  "setupUrl": "https://app.straitlink.in/setup#apps"
}