# 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

#### V1

- [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
- [Live Check](https://documentation.moveris.com/api-reference/live-check/): POST /api/v1/live-check — V3 batch path with client-supplied MediaPipe landmarks per frame

#### V2

- [Upload-First Pipeline](https://documentation.moveris.com/api-reference/v2-pipeline/): POST /api/v2/upload, /api/v2/fast-check, /api/v2/live-check — upload frames during capture, infer by session_id

#### Config

- [Errors](https://documentation.moveris.com/api-reference/errors/): Error codes, HTTP status codes, and structured error response format
- [Rate Limits](https://documentation.moveris.com/api-reference/rate-limits/): Rate limiting policy and headers

### 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, @moveris/webrtc, 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, useLivenessV2, useWebRTCLiveness, useCamera, useFrameCapture, useFaceDetection, useSmartFrameCapture, useDetectionPipeline, useModels
- [WebRTC Quick Start](https://documentation.moveris.com/sdk/webrtc/quick-start/): Observer-based WebRTC transport with @moveris/webrtc and useWebRTCLiveness
- [WebRTC Client Reference](https://documentation.moveris.com/sdk/webrtc/client/): WebRTCLivenessClient API, types, and constants
- [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
- [Cognito Check Quick Start](https://documentation.moveris.com/sdk/cognito-check/quick-start/): Get started with @moveris/cognito-check for framework-agnostic embeddable verification
- [Cognito Check API & Options](https://documentation.moveris.com/sdk/cognito-check/api/): Reference for Web Component attributes (`api-key`) and DOM events (`cognitoSuccess`, `cognitoError`)
- [Cognito Check React Quick Start](https://documentation.moveris.com/sdk/cognito-check-react/quick-start/): Get started with @moveris/cognito-check-react in React apps
- [Cognito Check React API & Props](https://documentation.moveris.com/sdk/cognito-check-react/props/): Reference for `apiKey`, `onSuccess`, `onError`, and `style` props

### 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

### Meeting Liveness Bot

- [Meeting Liveness Bot Overview](https://documentation.moveris.com/meeting-liveness-bot/overview/): Real-time liveness detection for video calls — architecture and capabilities
- [Meeting Liveness Bot How It Works](https://documentation.moveris.com/meeting-liveness-bot/how-it-works/): Pipeline, auth paths, persistence, and notification channels
- [Meeting Liveness Bot Quick Start](https://documentation.moveris.com/meeting-liveness-bot/quick-start/): Prerequisites and your first bot session
- [Meeting Liveness Bot Integration Guide](https://documentation.moveris.com/meeting-liveness-bot/integration-guide/): Full backend integration — sessions, webhooks, interviewer view
- [Meeting Liveness Bot Session Lifecycle](https://documentation.moveris.com/meeting-liveness-bot/session-lifecycle/): Bot states, participant analysis, and result correlation
- [Meeting Liveness Bot API Reference](https://documentation.moveris.com/meeting-liveness-bot/api-reference/): REST endpoints for the Meeting Liveness Bot service

### Optional

- [Postman Collection](https://documentation.moveris.com/api-reference/moveris-api-v2.postman_collection.json): Importable Postman collection for health, fast-check, fast-check-stream, fast-check-crops, and tenant video/detect endpoints
- [Postman — Fast Check Stream runner](https://documentation.moveris.com/api-reference/moveris-stream-test.postman_collection.json): Collection focused on sequential stream frames and Collection Runner assertions
- [CLAUDE.md Download](https://documentation.moveris.com/assets/downloads/CLAUDE.md.txt): Downloadable CLAUDE.md rules file for AI-assisted development