Check the app integration
method
GET
host
strait.
version
/v1
resource
/
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)
curl -X GET https://strait.link/v1/app/verify \
-H "Authorization: Bearer $SECRET_KEY"const res = await fetch('https://strait.link/v1/app/verify', {
headers: { Authorization: `Bearer ${process.env.SECRET_KEY}` },
});
const data = await res.json();
console.log(res.status, data);import os
import requests
res = requests.get(
"https://strait.link/v1/app/verify",
headers={"Authorization": f"Bearer {os.environ['SECRET_KEY']}"},
)
print(res.status_code, res.json())<?php
// Plain PHP with ext-curl, no packages. In Laravel, Http::withToken($secretKey)->get($url) sends the same request.
$ch = curl_init('https://strait.link/v1/app/verify');
curl_setopt_array($ch, [
CURLOPT_RETURNTRANSFER => true,
CURLOPT_HTTPHEADER => [
'Authorization: Bearer ' . getenv('SECRET_KEY'),
],
]);
$response = curl_exec($ch);
if ($response === false) {
throw new RuntimeException(curl_error($ch));
}
$status = curl_getinfo($ch, CURLINFO_RESPONSE_CODE);
echo $status, PHP_EOL;
print_r(json_decode($response, true));import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;
// Java 17+, java.net.http only (no dependencies).
public class Main {
public static void main(String[] args) throws Exception {
HttpRequest request = HttpRequest.newBuilder(URI.create("https://strait.link/v1/app/verify"))
.header("Authorization", "Bearer " + System.getenv("SECRET_KEY"))
.GET()
.build();
HttpResponse<String> res = HttpClient.newHttpClient().send(request, HttpResponse.BodyHandlers.ofString());
System.out.println(res.statusCode() + " " + res.body());
}
}package main
import (
"fmt"
"io"
"log"
"net/http"
"os"
)
func main() {
req, err := http.NewRequest(http.MethodGet, "https://strait.link/v1/app/verify", nil)
if err != nil {
log.Fatal(err)
}
req.Header.Set("Authorization", "Bearer "+os.Getenv("SECRET_KEY"))
res, err := http.DefaultClient.Do(req)
if err != nil {
log.Fatal(err)
}
defer res.Body.Close()
data, err := io.ReadAll(res.Body)
if err != nil {
log.Fatal(err)
}
fmt.Println(res.StatusCode, string(data))
}The response, printed
{
"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
}
]
}