Check the app integration

THE CALL, PART BY PART

method

GET

host

strait.link

version

/v1

resource

/app/verify

GET /v1/app/verify

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

Request

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.

No parameters.

Response

  • 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)
Request · curl
curl -X GET https://strait.link/v1/app/verify \
  -H "Authorization: Bearer $SECRET_KEY"

The response, printed

Response 200
{
  "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
    }
  ]
}