# Check the app integration

Source: https://straitlink.in/docs/api/verify-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/verify`

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

Runs the checks behind Dashboard › Setup › Integration health and answers each as `pass`, `warn`, `fail`, `unknown` (could not check just now) or `skip` (not used), with a plain-words `fix`: the Android and iPhone app details; each hosted app file, fetched live from every host (falls back to the scheduled check, labelled, when the fetch itself fails); whether your app has reported in the last 24 hours; whether the SDK it runs misses a fix (last 14 days); whether app opens from a link showed their screen; and webhook delivery (last 7 days). `ok` is true when nothing failed. Read-only. Secret key with `read` or `full` access; 6 calls a minute per workspace.

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

Response 200:

```json
{
  "ok": false,
  "checkedAt": "2026-11-09T12:00:00.000Z",
  "summary": {
    "pass": 3,
    "warn": 0,
    "fail": 1,
    "unknown": 0,
    "skip": 2
  },
  "checks": [
    {
      "id": "android_app",
      "status": "pass",
      "title": "Android app details are complete",
      "detail": "Package com.hilltop.shoes with 1 signing fingerprint(s).",
      "fix": null
    },
    {
      "id": "ios_app",
      "status": "skip",
      "title": "No iPhone app",
      "detail": "Only an Android app is set up.",
      "fix": null
    },
    {
      "id": "app_file.android.hilltop.strait.link",
      "status": "pass",
      "title": "Android file served correctly on hilltop.strait.link",
      "detail": "The Android file (https://hilltop.strait.link/.well-known/assetlinks.json) was fetched just now and is what phones expect.",
      "fix": null,
      "host": "hilltop.strait.link",
      "platform": "android"
    },
    {
      "id": "sdk_connected",
      "status": "fail",
      "title": "Your app has not reported to Strait yet",
      "detail": "No app open has reached Strait from the SDK, so installs and opens are not counted and deferred links cannot be delivered.",
      "fix": "Install the Strait SDK, initialise it at app start with the workspace's publishable key (Dashboard › Setup), then open the app once on a phone. Docs: https://straitlink.in/docs/sdks/"
    },
    {
      "id": "sdk_current",
      "status": "skip",
      "title": "Is your SDK current?",
      "detail": "No SDK has reported yet.",
      "fix": null
    },
    {
      "id": "link_opens",
      "status": "skip",
      "title": "Do app opens from a link show the right screen?",
      "detail": "No app opens from a link in the last 7 days.",
      "fix": null
    }
  ]
}
```

- `200`: The checks
- `401`: Missing or invalid secret key, or a publishable key
- `403`: The key is limited to links
- `429`: Over 6 calls a minute for this workspace (Retry-After)
