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

# SNH AI Background Check API

> Create verification orders, track searches, and receive webhooks for employment and education checks.

# SNH AI Background Check API

Programmatic API for **employment**, **education**, and related verification workflows. Orders run asynchronously; your integration should **create orders**, **poll search state** (or rely on **webhooks**), and **handle errors** with retries where appropriate.

The API is **multi-tenant**: your JWT must include the tenant claim SNH AI configures for your account.

## Why Theary

* **Automated contact discovery** — AI research finds HR and registrar-facing contacts via web signals, geography, organization research, and scoring (no spreadsheets of phone numbers required).
* **Multi-channel orchestration** — Policies drive email → fax → voice fallbacks in production.
* **Structured outcomes** — Inbound payloads route through extraction so **verification.completed** closes with structured verification data.
* **Async-first integration** — Create orders immediately; track progress via **webhooks** and search polling ([Webhook overview](/api-reference/guides/webhook-overview)).

Start in sandbox with a Theary-issued token, then move the same payloads to production credentials.

## How to integrate

1. **[Authentication](/guides/authentication)** — Bearer JWT on every call except `GET /health`; request sandbox credentials from SNH AI .
2. **[Quickstart](/quickstart)** — Health check, optional release-form upload, create one employment order, fetch order and searches, webhook outline.
3. **[Order lifecycle](/guides/demo-flow)** — Create an order, inspect searches, and handle webhooks.
4. **[Sandbox reference](/guides/sandbox-reference)** — Sandbox-specific limits before production.
5. **[Background Check overview](/api-reference/background-check/overview)** — Stable vs placeholder endpoints, base URLs, OpenAPI note.
6. **Orders** — [Create](/api-reference/endpoints/create-order), [Get](/api-reference/endpoints/get-order), [List searches](/api-reference/endpoints/get-order-searches), [Get search](/api-reference/endpoints/get-specific-search).
7. **Webhooks** — [Overview](/api-reference/guides/webhook-overview), [Events](/api-reference/webhooks/events), [Integration](/api-reference/guides/webhook-integration) (signatures, routing, idempotency).
8. **[Third-party ban](/guides/third-party-ban)** — Configure searches so specific third-party vendors are not used.
9. **[Error handling](/guides/error-handling)** — Status codes and validation payloads.

For request field details, use the **Schemas** section ([VerificationRequest](/api-reference/schemas/verification-request), [Applicant](/api-reference/schemas/applicant), [WebhookConfig](/api-reference/schemas/webhook-config)).

## Common client scenarios

See **[Integration patterns](/guides/integration-patterns)** for short examples: employment-only, education-only, combined checks, skip-research with contact hints, third-party vendor bans, email-only channel policy, manual review, per-search webhook routing, release-form upload, batch create caveats, and webhook idempotency.

## Support

<CardGroup cols={2}>
  <Card title="Support" icon="headset" href="mailto:support@snh-ai.com">
    Contact our support team
  </Card>

  <Card title="Status" icon="globe" href="https://status.theary.ai">
    System status
  </Card>
</CardGroup>