> ## Documentation Index
> Fetch the complete documentation index at: https://docs.truthfactor.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# API reference

> The Signal API endpoints, rendered from the OpenAPI 3.1 spec.

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:

```http theme={null}
Authorization: Bearer tf_live_…
```

See [Authentication](https://docs.truthfactor.ai/essentials/authentication.md) 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](https://docs.truthfactor.ai/essentials/webhooks.md) 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:

```bash theme={null}
curl -sS https://api.truthfactor.ai/api/v1/openapi.json
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.