---
title: "eKYC Reference"
url: "https://developer.incode.com/general-reference/ekyc-reference/"
section: "general-reference"
group: "eKYC Reference"
version: "v1.1"
status: "live"
---
# eKYC Reference

This section provides API-level reference material for Incode's eKYC (electronic Know Your Customer) product. Use these pages to understand response semantics, look up per-country source details, interpret reason codes, and retrieve eKYC data for a completed onboarding session.

For an overview of how to configure eKYC in your Dashboard, see [eKYC Dashboard configuration](/dashboard-platform-administration/ekyc-dashboard/) and [eKYC field requirements by source](/dashboard-platform-administration/ekyc-field-requirements-by-source/). 

## What's in this section

- [**eKYC API Reference**](/general-reference/ekyc-api-reference/) explains the response semantics for the External Verification (eKYC) endpoint: how to interpret match fields, status values, risk levels, metadata fields, reason codes, and Risk Add-ons. Start here if you are new to integrating with the eKYC API.
  - [**Fetch eKYC Data**](/general-reference/fetch-ekyc-input/) documents the endpoint for retrieving the original form input and risk data for a completed onboarding session.
- [**eKYC Reason Codes**](/general-reference/ekyc-reason-codes/) provides the full list of reason codes returned by the eKYC API, organized by category (Phone, Email, Tax ID, Address).
- [**eKYC Coverage**](/general-reference/ekyc-coverage/) lists all countries and data sources Incode supports for eKYC verification, including field requirements for each source. Individual country pages nested under Coverage provide API-level detail for the sources currently available in the Dashboard, including request parameters, response schemas, and `overallLevel` calculations.

## How the pieces fit together

A typical eKYC integration flow uses these pages together:

1. Choose a country and source from **eKYC Coverage** based on your customer base and use case.
2. Review the country page for that source to understand its request parameters, response schema, and risk-level calculations.
3. Refer to **eKYC API Reference** for shared response concepts (match field patterns, status values, risk levels) that apply across sources.
4. Retrieve original form input and risk data for any session using **Fetch eKYC Data**.
5. Interpret returned reason codes using **eKYC Reason Codes**.

<br />