# Moveris Liveness Detection API

> Liveness detection rooted in psychophysiology, not AI training. REST API for FinTech KYC and anti-spoofing that detects real humans vs photos, videos, and deepfakes in under 1 second.

The complete documentation is also available as a single file: [llms-full.txt](https://documentation.moveris.com/llms-full.txt)

## Docs

### Guide

- [About Moveris](https://documentation.moveris.com/): Overview of the liveness detection API, key features, and quick links
- [Glossary](https://documentation.moveris.com/glossary/): Technical terms explained in plain English
- [Getting Started](https://documentation.moveris.com/getting-started/for-decision-makers/): For Decision-Makers — high-level value, use cases, and integration paths
- [How It Works](https://documentation.moveris.com/getting-started/how-it-works/): Science behind liveness detection — psychophysiology, face analysis, and scoring
- [API Key](https://documentation.moveris.com/getting-started/api-key/): How to obtain and manage API credentials from the Developer Portal
- [Endpoints](https://documentation.moveris.com/getting-started/endpoints/): Available API endpoints and their purposes
- [Authentication](https://documentation.moveris.com/getting-started/authentication/): How to authenticate requests using the X-API-Key header
- [Quick Start](https://documentation.moveris.com/getting-started/quick-start/): Get up and running with your first liveness check in minutes
- [AI-Assisted Development](https://documentation.moveris.com/ai-development/vibe-coder-guide/): Vibe Coder Guide — using AI assistants (ChatGPT, Claude, Copilot) to integrate Moveris
- [Claude Code Integration](https://documentation.moveris.com/ai-development/claude-code-integration/): CLAUDE.md file for AI-native development with Moveris API
- [Models Overview](https://documentation.moveris.com/models/overview/): Comparison of all available detection models (Fast, Balanced, Thorough, Extended, Maximum)
- [Model Versioning & Frames](https://documentation.moveris.com/models/versioning-and-frames/): Model aliases, version pinning, frames/crops rules, deprecation lifecycle, and migration guide
- [Fast Model](https://documentation.moveris.com/models/fast/): 10-frame model (mixed-10-v2) — ~0.3 s capture, ~1 s response
- [Balanced Model](https://documentation.moveris.com/models/balanced/): 30-frame model (mixed-30-v2) — recommended default, ~1 s capture, ~3 s response
- [Thorough Model](https://documentation.moveris.com/models/thorough/): 60-frame model (mixed-60-v2) — high-security onboarding
- [Extended Model](https://documentation.moveris.com/models/extended/): 90-frame model (mixed-90-v2) — escalation, compliance-heavy flows
- [Maximum Model](https://documentation.moveris.com/models/maximum/): 120-frame model (mixed-120-v2) — highest scrutiny, regulatory edge cases
- [Best Practices](https://documentation.moveris.com/best-practices/frame-capture/): Frame Capture — guidelines for lighting, FPS, resolution
- [Crop Requirements](https://documentation.moveris.com/best-practices/crop-requirements/): Requirements for pre-cropped face images (224×224 pixels)
- [Changelog](https://documentation.moveris.com/changelog/): Version history and release notes

### API Reference

- [Health Check](https://documentation.moveris.com/api-reference/health-check/): GET /health endpoint for monitoring and uptime checks
- [Video Detect (Async)](https://documentation.moveris.com/api-reference/video-detect/): Tenant-scoped async video submission and status polling endpoints (`POST /api/v1/{tenant_slug}/video/detect`, `GET /api/v1/{tenant_slug}/video/detect/{submission_id}`)
- [Fast Check Stream (Default)](https://documentation.moveris.com/api-reference/fast-check-stream/): POST /api/v1/fast-check-stream — streaming endpoint, sends frames one at a time with session management
- [Fast Check (Legacy)](https://documentation.moveris.com/api-reference/fast-check/): POST /api/v1/fast-check — batch endpoint, sends all frames in a single request with server-side face detection
- [Fast Check Crops](https://documentation.moveris.com/api-reference/fast-check-crops/): POST /api/v1/fast-check-crops — batch endpoint accepting pre-cropped 224×224 face images
- [Rate Limits](https://documentation.moveris.com/api-reference/rate-limits/): Rate limiting policy and headers
- [Errors](https://documentation.moveris.com/api-reference/errors/): Error codes, HTTP status codes, and structured error response format

### Code Examples

- [JavaScript](https://documentation.moveris.com/examples/javascript/): Browser-based implementation with webcam capture and frame extraction
- [React](https://documentation.moveris.com/examples/react/): React component with hooks for webcam-based liveness detection
- [React Native](https://documentation.moveris.com/examples/react-native/): Mobile implementation with expo-camera for iOS and Android
- [Node.js](https://documentation.moveris.com/examples/node/): Server-side proxy implementation for secure API key handling
- [Python](https://documentation.moveris.com/examples/python/): Python implementation using OpenCV for frame capture

### SDK

- [SDK Overview](https://documentation.moveris.com/sdk/overview/): Overview of the Moveris SDK packages for React and React Native
- [Installation](https://documentation.moveris.com/sdk/installation/): How to install @moveris/shared, @moveris/react, and @moveris/react-native
- [LivenessClient](https://documentation.moveris.com/sdk/shared/client/): Core client for session management, frame sending, and result retrieval
- [Types & Constants](https://documentation.moveris.com/sdk/shared/types/): TypeScript types, interfaces, and constants used across SDK packages
- [React Quick Start](https://documentation.moveris.com/sdk/react/quick-start/): Get started with the React SDK — LivenessCheck component and hooks
- [React Components](https://documentation.moveris.com/sdk/react/components/): LivenessCheck and LivenessCheckHeadless components with full prop reference
- [React Hooks](https://documentation.moveris.com/sdk/react/hooks/): useLiveness, useCamera, useFrameCapture, useFaceDetection, useSmartFrameCapture, useDetectionPipeline, useModels
- [React Native Quick Start](https://documentation.moveris.com/sdk/react-native/quick-start/): Get started with the React Native SDK for mobile apps
- [React Native Components](https://documentation.moveris.com/sdk/react-native/components/): LivenessCheck component for iOS and Android
- [React Native Hooks](https://documentation.moveris.com/sdk/react-native/hooks/): useLiveness, useCamera, useFrameProcessor, useFaceDetection, useSmartFrameCapture for custom mobile UI

### MCP (Model Context Protocol)

- [MCP Overview](https://documentation.moveris.com/mcp/overview/): Human verification for AI agent actions — verify real humans before sensitive operations
- [MCP Quick Start](https://documentation.moveris.com/mcp/quick-start/): Set up MCP-based liveness verification in minutes
- [Tools Reference](https://documentation.moveris.com/mcp/tools-reference/): Available MCP tools: health-check, greet, verify_human_presence, check_verification_status, get_verification_result, revoke_session
- [Session Lifecycle](https://documentation.moveris.com/mcp/session-lifecycle/): How MCP sessions work — creation, frame collection, verdict
- [MCP Errors](https://documentation.moveris.com/mcp/errors/): MCP-specific error codes and troubleshooting
- [Agent Configurations](https://documentation.moveris.com/mcp/agent-configurations/): Configuration examples for Claude, GPT, and other AI agents

### Webhook

- [Webhook Overview](https://documentation.moveris.com/webhook/overview/): Receive verification results via HTTP callbacks instead of polling
- [Webhook Quick Start](https://documentation.moveris.com/webhook/quick-start/): Set up webhook notifications in minutes
- [Webhook Setup Guide](https://documentation.moveris.com/webhook/setup-guide/): Step-by-step guide with screenshots for configuring webhooks in the Developer Portal

### Optional

- [Postman Collection](https://documentation.moveris.com/api-reference/moveris-api-v2.postman_collection.json): Importable Postman collection for testing the Fast Check Stream endpoint
- [CLAUDE.md Download](https://documentation.moveris.com/assets/downloads/CLAUDE.md.txt): Downloadable CLAUDE.md rules file for AI-assisted development