API reference - TruthFactor Signal API

The pages in this section are generated from the OpenAPI 3.1 document the API serves at GET /api/v1/openapi.json — the same catalogue and contracts that drive the API itself, so the reference and the API cannot drift.

Base URL

All routes live under the /api/v1 namespace.

Environment	Base URL
Production	`https://api.truthfactor.ai/api`
Staging	`https://api.staging.truthfactor.ai/api`

Authentication

Every request carries an account-scoped bearer key:

Authorization: Bearer tf_live_…

See Authentication for how keys are minted.

Endpoints

Method	Path	Purpose
`POST`	`/v1/signals`	Submit a batch for background scoring. Returns `202` with a `request_id`.
`GET`	`/v1/signals/{request_id}`	Poll batch status and results (the same payload the webhook delivers).

The signalsComplete webhook delivery is also described in the spec — see Webhooks for the verification recipe.

The raw spec

Point your codegen or an external viewer directly at the live document — it is public and needs no key:

curl -sS https://api.truthfactor.ai/api/v1/openapi.json

​Base URL

​Authentication

​Endpoints

​The raw spec

Base URL

Authentication

Endpoints

The raw spec