Skip to main content

​
Authentication

The THEARY Background Check API uses JWT Bearer tokens for authentication. All API requests must include a valid JWT token in the Authorization header.

​
Authentication Method

  • Type: Bearer JWT
  • Header: Authorization: Bearer <jwt_token>

​
Getting Your API Token

Contact the THEARY team to obtain your API credentials and JWT token for accessing the Background Check API.

​
Making Authenticated Requests

Include your JWT token in the Authorization header for all API requests: 
curl -X GET "https://api.theary.ai/health" \
  -H "Authorization: Bearer YOUR_JWT_TOKEN"

​
Security Features

  • All endpoints require valid JWT authentication
  • Secure data isolation and access control
  • JWT token validation

​
Error Responses

​
Authentication Errors (401)

{
  "statusCode": 401,
  "message": "Unauthorized"
}

​
Invalid Token (401)

{
  "statusCode": 401,
  "message": "Invalid or expired token"
}

​
Testing Authentication

Test your authentication setup with a simple health check: 
bash cURL curl -X GET "https://api.theary.ai/health" \ -H "Authorization: Bearer YOUR_JWT_TOKEN"
Expected Response: 
{
  "success": true,
  "image": "verification-api:latest"
}

​
Next Steps

Once authenticated, you can:
  1. Create background check orders
  2. Process batch orders
  3. Track order status and searches
For detailed endpoint documentation, see the API Reference.