Get deepfake check status

GET

/v2/deepfake/checks/{request_id}

Retrieve current status and prediction results of an asynchronous deepfake check.

Authorizations

• ApiKeyAuth

Parameters

Path Parameters

request_id

required

string format: uuid

Responses

200

Deepfake check state.

object

data

Endpoint-specific payload; omitted when the operation returns no data.

decision

Scoring decision computed for the request when a scoring system applies.

object

status

Decision status from the scoring engine (e.g. pass, fail, refer).

string

score

number

reasons

Array<string>

meta

required

object

request_id

required

string

message

string

warnings

Non-fatal caveats about a successful result — for example an enrollment that succeeded but produced a weaker biometric template.

Array<string>

data

object

request_id

string format: uuid

project_id

string

source_filename

string

session_id

string

status

string

Allowed values: pending processing completed failed

created_at

Unix timestamp (seconds).

integer format: int64

completed_at

Unix timestamp (seconds).

integer format: int64

result

Present once the check reaches a terminal status.

object

success

boolean

message

string

prediction

real or fake.

string

confidence

number

score

Numerical forgery score reported by the model.

number

metadata

object

key

additional properties

any

key

additional properties

any

key

additional properties

any

401

Unauthorized / Missing or Invalid Authentication Credentials.

object

error

required

object

code

required

string

invalid_request

message

required

Human-readable message; a string, or a field-error array for validation failures.

meta

required

object

request_id

required

string

message

string

warnings

Non-fatal caveats about a successful result — for example an enrollment that succeeded but produced a weaker biometric template.

Array<string>

404

Not Found / Specified Resource (User, Session, Reference Image, etc.) does not exist.

object

error

required

object

code

required

string

invalid_request

message

required

Human-readable message; a string, or a field-error array for validation failures.

meta

required

object

request_id

required

string

message

string

warnings

Non-fatal caveats about a successful result — for example an enrollment that succeeded but produced a weaker biometric template.

Array<string>

500

Internal Server Error.

object

error

required

object

code

required

string

invalid_request

message

required

Human-readable message; a string, or a field-error array for validation failures.

meta

required

object

request_id

required

string

message

string

warnings

Non-fatal caveats about a successful result — for example an enrollment that succeeded but produced a weaker biometric template.

Array<string>