Authentication - Tidyhire API

Obtaining Your API Key

To use the Tidyhire API, you need an API key. You can generate one from your Tidyhire Dashboard.

Navigate to For Developers > API Keys in your Tidyhire Dashboard.
Click + Create API Key.

Tidyhire For Developers API Keys — Dashboard > For Developers > API Keys

Using Your API Key

Include your API key in the x-tidyhire-api-key header with every request.

curl -X GET https://api.tidyhire.app/api/public/v1/ \
  -H "x-tidyhire-api-key: YOUR_API_KEY"

fetch('https://api.tidyhire.app/api/public/v1/', {
  method: 'GET',
  headers: {
    'x-tidyhire-api-key': 'YOUR_API_KEY'
  }
});

import requests

response = requests.get(
    'https://api.tidyhire.app/api/public/v1/',
    headers={
        'x-tidyhire-api-key': 'YOUR_API_KEY'
    }
)

Security Best Practices

Never expose your API key in client-side code or public repositories
Store your API key in environment variables or a secrets manager
Rotate your API key periodically from the Tidyhire Dashboard
Use separate keys for development and production environments