Veriff API Reference Index

This page provides a comprehensive index of all Veriff REST API endpoints and reference documentation, organized for easy navigation and LLM consumption.

API guides and overview

• Veriff Public API guides: Complete API overview, authentication, flow explanation, and backwards compatibility - https://devdocs.veriff.com/apidocs/veriff-public-api-guides

• API FAQ: Frequently asked questions about API usage, endpoint differences, and troubleshooting - https://devdocs.veriff.com/apidocs/api-faq

Session management endpoints

Session creation and management

• POST /sessions: Create a new verification session with end-user data and get session ID and URL - https://devdocs.veriff.com/apidocs/v1sessions

• PATCH /sessions/{sessionId}: Update session status to "submitted" to begin verification process - https://devdocs.veriff.com/apidocs/v1sessionsid-2

• DELETE /sessions/{sessionId}: Delete a verification session (useful for testing, not available by default) - https://devdocs.veriff.com/apidocs/v1sessionsid-3

Person’s validation

• POST /sessions/validate-registry: Create session and validate person’s national ID number (SSN) with provided data - https://devdocs.veriff.com/apidocs/v1validate-registry

• POST sync-api.veriff.me/v1/validate-registry: Create session via synchronous API and validate person’s national ID number (SSN) with provided data, returning results in API response - https://devdocs.veriff.com/apidocs/validate-registry

Data upload endpoints

Media and additional data

• POST /sessions/{sessionId}/media: Upload images (document, selfie) and PDFs for verification session - https://devdocs.veriff.com/apidocs/v1sessionsidmedia-3

• POST /sessions/{sessionId}/collected-data: Upload additional end-user data for improved fraud detection - https://devdocs.veriff.com/apidocs/v1sessionsidcollected-data-1

• POST /v1/sessions/{id}/consents - upload end-user’s consent for INE database verification - https://devdocs.veriff.com/apidocs/v1sessionsidconsents

Data retrieval endpoints

Session results and decisions

• GET /sessions/{sessionId}/decision: Retrieve verification session decision data and extracted information - https://devdocs.veriff.com/apidocs/v1sessionsiddecision-1

• GET /sessions/{sessionId}/person: Get data about the person verified in the session - https://devdocs.veriff.com/apidocs/v1sessionsidperson-1

• GET /sessions/{sessionId}/watchlist-screening: Retrieve PEP and sanctions screening results - https://devdocs.veriff.com/apidocs/v1sessionsidwatchlist-screening-1

Media and attempts

• GET /sessions/{sessionId}/media: Query information about all media uploaded during session - https://devdocs.veriff.com/apidocs/v1sessionsidmedia-2

• GET /sessions/{sessionId}/attempts: Get IDs of different verification attempts within one session - https://devdocs.veriff.com/apidocs/v1sessionsidattempts-1

• GET /attempts/{attemptId}/media: Query media information for a specific verification attempt - https://devdocs.veriff.com/apidocs/v1attemptsidmedia-1

• GET /media/{mediaId}: Retrieve specific media file using media ID - https://devdocs.veriff.com/apidocs/v1mediaid-1

Registry-specific endpoints

Mexican registry verification

• GET /sessions/{sessionId}/decision/ine-registry: Query verification data from Mexican Electoral Registry (INE) - https://devdocs.veriff.com/apidocs/v1sessionsiddecisionine-registry-1

• GET /sessions/{sessionId}/decision/curp-registry: Query verification data from Mexican Population Registry (CURP) - https://devdocs.veriff.com/apidocs/v1sessionsiddecisioncurp-registry-1

• GET /sessions/{sessionId}/decision/combined-ine-curp-registry: Query data from combined Mexican registries verification - https://devdocs.veriff.com/apidocs/v1sessionsiddecisioncombined-ine-curp-registry-1

Aadhaar database verification

Multi-Factor Authentication Endpoints

• POST /sessions/{sessionId}/mfa/generate: Generate or retrigger one-time password for Aadhaar verification - https://devdocs.veriff.com/apidocs/v1sessionsidmfagenerate

• POST /sessions/{sessionId}/mfa/verify: Submit one-time password (OTP) for Aadhaar database verification - https://devdocs.veriff.com/apidocs/v1sessionsidmfaverify

Submit feedback about session

• POST /v1/feedback/fraud-reports: Submit one or more fraud reports about sessions for evaluation and processing - https://devdocs.veriff.com/apidocs/submit-fraud-report

• GET /v1/feedback/fraud-categories: Get a list of available fraud categories that can be reported - https://devdocs.veriff.com/apidocs/get-fraud-categories

Other indexes

Veriff Documentation Index - Index of all Veriff documentation, organized by category for easy navigation and AI consumption - https://devdocs.veriff.com/docs/veriff-documentation-index

Changelog