Authentication

All API requests require authentication using an API key sent as a bearer token.

Bearer Token Authentication

Include your API key in the Authorization header of every request:

Authorization: Bearer tv_live_your_api_key_here

Getting your API Key

  1. Sign up for a Pro or Business plan
  2. Go to Settings
  3. Create a new API key with a descriptive name
  4. Copy and securely store your key (it won't be shown again)

Key Prefixes

TenantVerify API keys use prefixes to help you identify the key type:

PrefixEnvironment
tv_live_Production — real verifications, real charges
tv_test_Sandbox — test verifications, no charges (see Sandbox Mode)

Security Best Practices

  • Never expose API keys in client-side code
  • Use environment variables to store keys
  • Rotate keys periodically and after any suspected compromise
  • Use separate keys for development and production
  • Use test keys (tv_test_) for development