Skip to main content
GET
Poll batch status and results
Returns the same payload the webhook delivers, with whatever items have scored so far. status stays pending until every item is terminal, then flips to complete. You can rely on polling alone. See The verdict model for how to read each item.

Authorizations

Authorization
string
header
required

An account-scoped API key, tf_live_….

Path Parameters

request_id
string
required

The request_id returned by POST /v1/signals.

Response

The batch status and results.

The GET /v1/signals/{request_id} and webhook body.

request_id
string
required
Minimum string length: 1
requested_datetime
string<date-time>
required
completed_datetime
string<date-time> | null
required
status
enum<string>
required
Available options:
pending,
complete,
partial,
failed
data
object[]
required

One result item, discriminated on status: scored carries score/band/reason/signals; rejected carries reason; unresolved carries its signals map (every verdict null, each with an unresolved_reason) and no score/band/reason; error may carry neither.