APIHub
Back to Explore

Checks API

The Checks API enables creation, retrieval, and management of background checks—including details, PDF generation, and health monitoring—and also provides endpoints for configuring score rules, managing continuous checks, hook subscriptions, and report generation.

Geocoding
apiKeyHeader
HTTPS
CORS: Unknown
Description enriched
Visit official documentation

Latency

878ms p95

Uptime

77.8% 30d

Playground

Verified

live

Endpoints

REST · JSON
POST

/v1/behavior

Report Behavior

GET

/v1/checks

List Checks

  • start_key (query) — Start key value for the pagination
  • report_id (query) — Report id checks to be returned
POST

/v1/checks

Create a background check

  • Truora-Priority (header) — Describes the background check priority. The amount of high priority checks is limited by country. Medium priority is used by default
GET

/v1/checks/health

Get Health Dashboard

  • country (query) — Country in ISO 3166, uppercase
  • unixTimestampSeconds (query) — Unix timestamp in seconds. Send a day timestamp to view the database hourly status for that day or send the current time to know the current database status
  • unixtimezoneOffsetSeconds (query) — Offset between the local time and the UTC time in seconds. (e.g., Colombia is at UTC -18000 seconds)
GET

/v1/checks/{check_id}

Get Background Check

  • check_id (path, required) — Check ID
GET

/v1/checks/{check_id}/details

List Check Details

  • start_key (query) — Start key value for the pagination
  • lang (query) — This parameter is used to specify the language wanted for details, if not specified details will come in their original language.
GET

/v1/checks/{check_id}/pdf

Get PDF

  • lang (query) — Used to specify the language for the PDF, if not specified the PDF will be downloaded in Spanish.
  • check_id (path, required) — ID of the check
POST

/v1/checks/{check_id}/pdf

Create PDF

  • check_id (path, required) — ID of the check
DELETE

/v1/config

Delete Custom Type

  • type (query, required) — Name of the custom type to be deleted
  • country (query) — Country where the custom type is valid
GET

/v1/config

List Score Configurations

  • start_key (query) — The key to start the pagination
POST

/v1/config

Create Score Configurations

PUT

/v1/config

Update Custom Type

GET

/v1/continuous-checks

Lists all continuous checks

POST

/v1/continuous-checks

Creates a continuous check that will run background checks recurrently according to the frequency provided.

GET

/v1/continuous-checks/{continuous_check_id}

Lists history associated with a Check. It can be paginated

PUT

/v1/continuous-checks/{continuous_check_id}

Updates a continuous check

GET

/v1/continuous-checks/{continuous_check_id}/history

Lists background check logs. It can be paginated

  • continuous_check_id (path, required)
GET

/v1/hooks

Lists all hooks

POST

/v1/hooks

Creates a hook subscription

DELETE

/v1/hooks/{hook_id}

Deletes hook

  • hook_id (path, required) — Hook ID
PUT

/v1/hooks/{hook_id}

Updates hook

  • hook_id (path, required) — Hook ID
GET

/v1/reports

List Reports

  • start_key (query) — Start value for pagination.
  • username (query) — filter reports created by the specified username
POST

/v1/reports

Create Report

GET

/v1/reports/{report_id}

Get Report

POST

/v1/reports/{report_id}/upload

Batch Upload

25 endpoints auto-detected

Authentication

This API uses an API key, passed in the "Truora-API-Key" header. No OAuth required.

curl -X POST \
  "https://api.truora.com/v1/behavior" \
  -H "Truora-API-Key: YOUR_API_KEY"

api.truora.com · HTTPS only