Quickstart

Preview — documented before it ships

The API isn’t live yet. This page shows the exact request and response shape it returns.

The fastest path to a real answer: one unauthenticated request returns one current Verdict. No key, no signup.

1. Ask for a verdict by identifier. Use slug:, steam:, bundle:, or a bare name.

   curl

   curl https://api.doesitarm.com/v1/verdicts/slug:adobe-photoshop

   JavaScript

   const res = await fetch(
     "https://api.doesitarm.com/v1/verdicts/slug:adobe-photoshop"
   )
   const verdict = await res.json()
   console.log(verdict.status) // "native"

   Python

   import requests
   verdict = requests.get(
       "https://api.doesitarm.com/v1/verdicts/slug:adobe-photoshop"
   ).json()
   print(verdict["status"])  # "native"

   MCP

   Tool: lookup_verdict
   Arguments: { "identifier": "slug:adobe-photoshop" }
   → returns the same Verdict object the REST call returns.

2. Read the answer. You get one Verdict:

   {
     "slug": "adobe-photoshop",
     "title": "Adobe Photoshop",
     "kind": "app",
     "status": "native",
     "confidence": "high",
     "basis": ["binary", "vendor", "automated_test"],
     "macosVersion": "26",
     "chip": "apple_silicon",
     "caveats": [],
     "breaksAtRosettaEol": false,
     "lastVerified": "2026-06-21",
     "stale": false,
     "signals": [
       {
         "id": "sig_01",
         "kind": "test",
         "status": "native",
         "confidence": "high",
         "macosVersion": "26",
         "chip": "m3",
         "at": "2026-06-21T00:00:00Z",
         "ref": "https://doesitarm.com/adobe-photoshop#test-01"
       }
     ],
     "alternatives": []
   }

3. Scope it if you care about a specific macOS or chip:

   curl "https://api.doesitarm.com/v1/verdicts/slug:cyberpunk-2077?macosVersion=26&chip=m3"

The branches you should handle

Every example identifier below is real and stable, so you can exercise each branch deterministically:

Identifier	What you get
slug:adobe-photoshop	native, high confidence
slug:cyberpunk-2077	translation, translationLayer: "gptk", a game
slug:figma	native with an Electron caveat in caveats[]
slug:some-ancient-installer	status: "unknown" plus alternatives[]
slug:final-cut-pro	stale: true (an intentionally old lastVerified)
slug:429-demo	trips the rate limit so you can test your retry path

unknown and stale are not errors — they’re honest verdicts. Read them, don’t throw. Only a genuinely ambiguous name returns an error (409).

What next

The Verdict object Every field, including the honesty fields, explained.

Authentication When you need a key, and how the tiers work.

MCP server Give an AI agent these four tools directly.

API Reference The full lookupVerdict contract.