# VerifEye REST API

The VerifEye REST API provides secure, scalable, and region-specific endpoints for authentication, token management, and verification services.

## Getting Started

### 1. Create Your Account

Sign up at the [VerifEye Developer Console](https://verifeye-console.realeyes.ai/) to get started with the VerifEye REST APIs.

### 2. Get Your API Key

1. Log in to the [VerifEye Developer Console](https://verifeye-console.realeyes.ai/)
2. Navigate to **Settings → API Keys**
3. Generate a new API key for your project
4. Store your API key securely (never commit to version control)

### 3. Choose Your Region

VerifEye APIs are available in two regions:
- **EU (Europe)**: `https://*-api-eu.realeyes.ai/`
- **US (United States)**: `https://*-api-us.realeyes.ai/`

Choose the region closest to your users for optimal performance.

### 4. Authenticate Your Requests

All API requests require authentication. See the [Authentication](/rest-api/authentication/) documentation for details on API Key and JWT Bearer Token authentication methods.

---

## Available APIs

### [Security API](/rest-api/security-api/)
Authentication and token management services for secure API access.

### [Face Verification API](/rest-api/face-verification-api/)
Face detection, embedding extraction, and face comparison services for identity verification.

### [Demographic Estimation API](/rest-api/demographic-estimation-api/)
Age estimation and gender detection services for demographic analysis.

### [Emotion & Attention API](/rest-api/emotion-attention-api/)
Facial emotion detection and attention analysis for understanding user engagement and emotional states.

### [Face Recognition API](/rest-api/face-recognition-api/)
Face recognition and management for building secure identity verification systems with duplicate detection.

### [VerifEye API](/rest-api/verifeye-service-api/)
Verification configuration management and signature validation services for building secure identity verification workflows.

---

## Common Response Codes

| Code | Description |
|------|-------------|
| `200` | Success |
| `400` | Bad Request - Invalid parameters |
| `401` | Unauthorized - Invalid or missing authentication |
| `403` | Forbidden - Valid authentication but insufficient permissions |
| `500` | Internal Server Error |

---

*Last updated: 2026-01-27*
