Start a check
POST /v1/checks
A multipart form. Send file, or url for a public address the engine should download. Answers 202 straight away. access_token is shown once and keeps the check private.
- file
- The photo, video or audio file.
- url
- A public http or https address, instead of file.
- claim
- JSON: where and when it was supposedly made. See the claim format.
- checks
- Run only these, comma separated. Default: all that apply.
- second_file
- A second clip, for HumPrint's two clip match.
- webhook_url
- Called when the check finishes. See webhooks.
curl "https://aadam-2012legend--truthkit-engine-web.us-east.modal.run/v1/checks" \
-H "Authorization: Bearer $TRUTHKIT_API_KEY" \
-F 'file=@photo.jpg' \
-F 'claim={"place":{"mode":"city","label":"Sharjah, UAE","lat":25.35,"lon":55.42},"time":{"mode":"exact","iso":"2026-10-12T14:00:00","tz":"auto"}}'import os
import requests
response = requests.post(
"https://aadam-2012legend--truthkit-engine-web.us-east.modal.run/v1/checks",
headers={"Authorization": f"Bearer {os.environ['TRUTHKIT_API_KEY']}"},
data={"claim": '{"place":{"mode":"city","label":"Sharjah, UAE","lat":25.35,"lon":55.42},"time":{"mode":"exact","iso":"2026-10-12T14:00:00","tz":"auto"}}'},
files={"file": open("photo.jpg", "rb")},
)
print(response.status_code, response.json())import { openAsBlob } from "node:fs";
const form = new FormData();
form.append("file", await openAsBlob("photo.jpg"), "photo.jpg");
form.append("claim", "{\"place\":{\"mode\":\"city\",\"label\":\"Sharjah, UAE\",\"lat\":25.35,\"lon\":55.42},\"time\":{\"mode\":\"exact\",\"iso\":\"2026-10-12T14:00:00\",\"tz\":\"auto\"}}");
const response = await fetch("https://aadam-2012legend--truthkit-engine-web.us-east.modal.run/v1/checks", {
method: "POST",
headers: { Authorization: `Bearer ${process.env.TRUTHKIT_API_KEY}` },
body: form,
});
console.log(response.status, await response.json());Real response202Captured 6 November 2026
POST /v1/checks
X-RateLimit-Remaining: 5
{
"id": "SWO9cpoo8wx3",
"status": "queued",
"access_token": "tkj_8ZMkT7ni[redacted on this page]",
"sha256": "a19cef68ca8657383eaa3e48d4e1d0b32823a3e016576063e99156fda18864e0",
"kind": "image"
}