# Authentication

VerifEye REST APIs support two authentication methods.

# 1. API Key Authentication

VerifEye APIs use API Key authentication with the Authorization header.

# Format

Header Format:

Authorization: ApiKey <API-KEY-FROM-DEV-CONSOLE>

# Example

curl -X POST "https://demographic-estimation-api-eu.realeyes.ai/v1/demographic-estimation/get-age" \
  -H "Authorization: ApiKey <API-KEY-FROM-DEV-CONSOLE>" \
  -H "Content-Type: application/json" \
  -d '{
    "image": {
      "bytes": "/9j/4AAQSkZJRgABAQEAYABgAAD..."
    }
  }'

# 2. JWT Bearer Token Authentication

JWT tokens provide time-limited authentication for client-side applications. Tokens are generated using the Security API's /token/get endpoint.

# Format

Header Format:

Authorization: Bearer <jwt-token>

# How to Get a JWT Token

Step 1: Generate Token

curl -X GET "https://security-api-eu.realeyes.ai/v1/token/get" \
  -H "Authorization: ApiKey <API-KEY-FROM-DEV-CONSOLE>"

Response:

{
  "token": "eyJhbGciOiJSUzUxMiIsInR5cCI6IkpXVCJ9...",
  "expiresAt": "2026-01-27T12:00:00Z"
}

Step 2: Use Token in API Requests

curl -X POST "https://demographic-estimation-api-eu.realeyes.ai/v1/demographic-estimation/get-age" \
  -H "Authorization: Bearer eyJhbGciOiJSUzUxMiIsInR5cCI6IkpXVCJ9..." \
  -H "Content-Type: application/json" \
  -d '{
    "image": {
      "bytes": "/9j/4AAQSkZJRgABAQEAYABgAAD..."
    }
  }'

# Getting Your API Key

Sign up at the VerifEye Developer Portal
Navigate to Settings → API Keys
Generate a new API key for your project
Store your API key securely (never commit to version control)

Last updated: 2026-01-27