Read the app setup
method
GET
host
strait.
version
/v1
resource
/
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)
curl -X GET https://strait.link/v1/app \
-H "Authorization: Bearer $SECRET_KEY"const res = await fetch('https://strait.link/v1/app', {
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",
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');
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"))
.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", 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
{
"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"
}