# Read the app setup

Source: https://straitlink.in/docs/api/get-app-setup/

> **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/).

`GET /v1/app`

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

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.

```bash
curl -X GET https://strait.link/v1/app \
  -H "Authorization: Bearer $SECRET_KEY"
```

Response 200:

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

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