Deepfake Check (Status)

Retrieve the current status and results of a previously submitted deepfake check. Poll this endpoint until status is completed or failed.

Endpoint

GET /api-gateway/v2/deepfake/checks/:request_id

Authentication

Requires a valid API token in the Authorization header.

Authorization: Bearer <your-api-key>

Path Parameters

Parameter	Type	Description
request_id	string	The check id returned from the Deepfake Check (Submit) endpoint

Example Request

curl 'https://api.biometrysolutions.com/api-gateway/v2/deepfake/checks/246fcaf1-0c88-4b21-a96c-05cabefcef55' \
  -H 'Authorization: Bearer <your-api-key>'

Response (Completed)

Status: 200 OK

{
  "data": {
    "id": "246fcaf1-0c88-4b21-a96c-05cabefcef55",
    "status": "completed",
    "score": 0.98,
    "prediction": "fake",
    "message": "Inference completed successfully",
    "created_at": 1763007610,
    "completed_at": 1763008367
  },
  "meta": { "request_id": "fc5605c5-...", "message": "deepfake check state" }
}

Response Fields (data)

Field	Type	Description
id	string	Unique identifier for the check.
status	string	Current status: pending, processing, completed, or failed.
score	number | null	Deepfake probability (0.0–1.0). null until completed.
prediction	string | null	Classification, e.g. real or fake. null until completed.
message	string | null	Human-readable status/result message.
created_at	number	Unix timestamp (seconds) when the check was created.
completed_at	number	Unix timestamp (seconds) when processing completed (present when completed).

Status Values

Status	Description
pending	Check received, queued for processing
processing	Video is currently being analysed
completed	Analysis finished successfully
failed	Analysis failed (check message)

Error Responses

Status	Description
401 Unauthorized	Missing or invalid API token
404 Not Found	Check id not found
500 Internal Server Error	Server error

Client Implementation Tips

Poll every 2–5 seconds until status is completed or failed. Processing typically completes within 1–2 minutes.

async function pollDeepfakeCheck(id, token) {
  while (true) {
    const res = await fetch(
      `https://api.biometrysolutions.com/api-gateway/v2/deepfake/checks/${id}`,
      { headers: { Authorization: `Bearer ${token}` } },
    );
    const { data } = await res.json();
    if (data.status === 'completed' || data.status === 'failed') return data;
    await new Promise((r) => setTimeout(r, 3000));
  }
}