Skip to main content

Non-Interactive

Facia’s Non-Interactive KYC solution is tailored for backend verification scenarios where direct user interaction is not required. This mode allows clients to submit pre-collected identity data such as facial images, identity document and AML check for automated processing and verification. Leveraging the same robust technology as the interactive flow, including liveness analysis, document validation, and facial matching, this approach is ideal for high-volume use cases, legacy system integrations, or situations where user-facing verification is not feasible.

  1. Quick Liveness detection
  2. Document OCR
  3. Face Match
  4. Document Verification
  5. Anti Money Laundering (AML)

These components work together within a unified framework to deliver accurate results while reducing manual review and user friction.

Initiate KYC Transaction

This endpoint initiates a transaction request for the kyc. The endpoint accepts some fields in the request payload, as mentioned in the request parameters.

Endpoint

POSThttps://api.facia.ai/kyc

Authorization:

Token Type: Bearer
Description:

This API utilizes Access token or Client-Secret key in header for authentication.

You can use your client_id and client_secret key when using the "/request-access-token" endpoint to obtain a Bearer token for authorization while connecting to this API. For additional details on Authorization, click Here

Request Body Samples:

//POST /kyc  HTTP/1.1
//Host: api.facia.ai
//Content-Type: application/json
//Authorization: Bearer <access-token-here>

{
"services": [
"quick_liveness",
"document_ocr",
"document_verification",
"face_match",
"aml",
],
"quick_liveness": {
"file": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQABAAD..."
},
"document": {
"file": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQABAAD...",
"additional_file": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQEAYABgAAD...",
"supported_types": ["id_card", "passport", "driving_license"],
"dob": "",
"age": ,
"document_number": "",
"issue_date": "",
"expiry_date": "",
"gender": "",
"fetch_enhanced_data": "1",
"name": {
"first_name": "",
"last_name": "",
},
"verification_instructions": {
"allow_paper_based": "1"
},
"full_address": ""
},
"aml": {
"search_name": "John Doe",
"search_countries": ["US", "GB"],
"search_categories": ["Sanctions"],
"birth_incorporation_date": "00-00-1980",
"entity_unique_id": "JDOE1980",
"alias_search": true,
"rca_search": false,
"search_entity_type": ["Person", "Company"],
"match_score": 85,
"exact_search": false,
},
"client_reference": "TXN123456789",
"callback_url": "https://www.example.com/status-update"
}

Request Parameter

ParameterDescription
servicesRequired: Yes
Type: Array of Strings
Allowed values: quick_liveness, document_ocr, document_verification, face_match, aml
At least one service must be selected. Only selected services will be performed.
quick_liveness.fileRequired: Yes (if quick_liveness or face_match in services)
Type: string (base64)
Quick Liveness verification image file (Base64).
document.fileRequired: Yes (if document_ocr, document_verification, or face_match in services)
Type: File
Primary document image for OCR, verification or face match.
document.additional_fileRequired: No
Type: File
Secondary document image (e.g. back side of ID).
document.supported_typesRequired: No
Type: Array
Example 1: ["driving_license"]
Example 2: ["id_card", "credit_or_debit_card", "passport"]
document.dobRequired: No
Type: String
Format: yyyy-mm-dd
Provide a valid date.
Example: 1990-12-31
document.ageRequired: No
Type: Integer/Array
Allowed values are integers or an array. The Age parameter allows the client to set a minimum and maximum limit for acceptance of a user. The minimum age is defined as min and the maximum is defined as max within this object.
Example: 18
document.document_numberRequired: No
Type: String
Maximum: 100 characters
Allowed Characters are numbers, alphabets, dots, dashes, spaces, underscores and commas.
Examples: 35201-0000000-0, ABC1234XYZ098
document.issue_dateRequired: No
Type: String
Format: yyyy-mm-dd
Provide a valid date.
Example: 2015-12-31
document.expiry_dateRequired: No
Type: String
Format: yyyy-mm-dd
Provide a valid date.
Example: 2025-12-31
document.genderRequired: No
Type: String
Accepted Values: M, F, O, m, f, o
Provide the gender which is given in the document.
F: Female, M: Male, O: Others
Example: M
document.fetch_enhanced_dataRequired: No
Type: String
Value Accepted: 1
Provide 1 for enabling enhanced data extraction for the document. Enhanced data extraction provides more than 100 data points from official ID documents supporting 150 languages (additional charges apply). Extracted data will be returned in additional_data object.
document.nameRequired: No
Type: Object
In the name object used in document service, first_name is required if you don't want to perform OCR of the name parameter. Other fields are optional.
Example 1: { "first_name" : "John", "last_name" : "Doe" }
Example 2: { "first_name" : "John", "last_name" : "Doe", "fuzzy_match" : "1"}
document.verification_instructionsRequired: No
Type: Object
Allows clients to provide additional instructions for the service, such as allowing paper-based, photocopied or laminated documents for verification.
Example: {"allow_paper_based" : "1"}
document.full_addressRequired: No
Type: String
Minimum: 6 characters
Maximum: 250 characters
Allowed Characters are numbers, alphabets, dots, dashes, spaces, underscores, hashes and commas.
aml.search_nameRequired: Yes (if aml in services and neither document_ocr nor document_verification is selected)
Type: String
Min: 2 characters
Max: 100 characters
Note: AML screening will be performed on the name provided in aml.search_name. If aml.search_name is not provided, the name will be extracted from the document for screening.
aml.search_countriesRequired: No
Type: Array of Strings
Country codes for filtering search.
Example: ["US", "GB"]
Note: ISO 3166-1 alpha-2 country codes are supported.
See supported countries
aml.search_categoriesRequired: Yes (if aml in services)
Type: Array
Array of categories based on which you want to filters reports.
Example: ["SIP"]
See categories list
aml.birth_incorporation_dateRequired: No
Type: String (Format: DD-MM-YYYY)
Accepts partial dates like 00-00-1980, 10-03-0000.
aml.entity_unique_idRequired: No
Type: String
Unique identifier can be used to filter the search records.
Min: 2 character
Max: 50 characters
Constraint: Unique identifier should not consist entirely of special characters.
Note: It can be any key within the data object like Passport No, National ID number.
Example: TR12345677.
aml.alias_searchRequired: No
Type: Boolean
Alias search is used to specify whether user want to perform search within aliases or not.
Default : True.
Example : False.
aml.rca_searchRequired: No
Type: Boolean
RCA search is used to specify whether user want to perform search within rca or not.
RCA (Relatives and Close Associates) - Immediate family members or close social or professional contacts of a government or political official, or senior executive – meaning spouses, parents, siblings, children, and spouses’ parents and siblings.
Default : True.
Example: False.
aml.search_entity_typeRequired: No
Type: Array
Entity Type: AML screening serves the purpose of identifying individuals or entities listed in various AML databases. Facia provides screening services of five types of entities i.e. Person, Company, Organization, Crypto_Wallet, Vessel and Aircraft.
Example: ["Person"].
aml.match_scoreRequired: No
Type: Integer
The match score determines the level of similarity required between the search term and the matched terms. A value of 0 allows for the loosest match, while 100 represents the closest match.
Note: It ranges from 0-100.When the selected Category is "Adverse Media," the match score is not applicable, as Adverse Media results are always returned with a match score of 100.
Default: 80.
Example: 65
aml.exact_searchRequired: No
Type: Boolean
Sets the match score to 100, disables all preprocessing (including prefixes, autocorrection, and translation), and performs the search based solely on the exact input parameters.
Default: False.
client_referenceRequired: No
Type: String
Min: 5
Max: 255
Custom transaction identifier.
callback_urlRequired: No
Type: String
Example: callback_url=https://www.example.exc.com/
Multiple server-to-server calls are initiated to communicate updates on verification status to Facia’s clients.

Response Sample


{
"status": true,
"message": "Success",
"result": {
"data": {
"reference_id": "D4107871AC5FXXX",
}
}
}


Response Parameter

ParameterDescription
statusType: Boolean
Example: true or false
Indicates whether the request was successful (true) or not (false).
messageType: String
Descriptive message corresponding to the request status.
errorsType: Object (present only if status is false)
contains errors explaining why the request failed.
result.data.reference_idType: String
Example: "D4107871AC5FXXX"
Unique transaction identifier generated by the system.

Transaction Status:

You can use the reference_id in the status endpoint to see the status of transaction. For additional details on Status endpoint, click Here

AML Categories

Facia offers an extensive range of screening categories designed to support comprehensive background checks. With the help of the key aml.search_categories listed below, our platform ensures businesses meet regulatory compliance requirements while effectively identifying and mitigating potential risks. This thorough approach helps organizations safeguard against financial crime and reputational damage.

CategoryDescription
Fitness and ProbityEvaluating an individual's or entity's competence, skills, integrity, and ethical conduct in the financial services industry.
Warnings and Regulatory EnforcementWarnings alert individuals or entities to rule violations, while regulatory enforcement involves imposing penalties or legal actions for non-compliance with laws and regulations.
SanctionsPenalties or restrictions imposed by authorities on individuals, organizations, or countries for violating laws or international norms.
PEP Level 1High-risk PEPs - State and government executives, military/judicial/law enforcement leaders, parliament officials, prominent political party figures.
PEP Level 2Medium-high Risk PEPs - Senior state/military/law enforcement officials, high-rank civil servants, religious/state agency leaders, ambassadors/diplomats/commissioners.
PEP Level 3Medium-risk PEPs - Senior management in government-owned businesses, state organization board members.
PEP Level 4Low Risk PEPs - Senior officials/employees in international bodies, state/district assembly members.
SIPSIP (Special Interest Person) - Individuals that present a heightened level of risk due to their suspected or confirmed involvement in criminal activity.
SIESIE (Special Interest Entity) - Companies or organizations that present a heightened level of risk due to their suspected or confirmed involvement in criminal activity.
InsolvencyCompanies and organisations that are unable to pay their debts or have been declared bankrupt by judicial process.

AML Supported Countries

Facia encompasses a wide array of countries for comprehensive screening solutions. This international coverage enables organizations to conduct thorough due diligence and maintain compliance with regulatory standards across various regions.

No.Country NameCode
1AfghanistanAF
2AlbaniaAL
3AlgeriaDZ
4Aland IslandsAX
5American SamoaAS
6AndorraAD
7AngolaAO
8AnguillaAI
9Antigua and BarbudaAG
10ArgentinaAR
11ArmeniaAM
12ArubaAW
13AustraliaAU
14AustriaAT
15AzerbaijanAZ
16BahrainBH
17BangladeshBD
18BarbadosBB
19BelarusBY
20BelgiumBE
21BelizeBZ
22BeninBJ
23BermudaBM
24BhutanBT
25BoliviaBO
26Bosnia and HerzegovinaBA
27BotswanaBW
28BrazilBR
29British Virgin IslandsVG
30BruneiBN
31BulgariaBG
32Burkina FasoBF
33BurundiBI
34CambodiaKH
35CameroonCM
36CanadaCA
37Cape VerdeCV
38Caribbean NetherlandsBQ
39Cayman IslandsKY
40Central African RepublicCF
41ChadTD
42Channel IslandsJE
43ChileCL
44ChinaCN
45Cocos (Keeling) IslandsCC
46ColombiaCO
47ComorosKM
48CongoCG
49Cook IslandsCK
50Costa RicaCR
51Cote D'Ivoire (Ivory Coast)CI
52CroatiaHR
53CubaCU
54CuracaoCW
55CyprusCY
56Czech RepublicCZ
57Democratic Republic of the CongoCD
58DenmarkDK
59DjiboutiDJ
60DominicaDM
61Dominican RepublicDO
62East TimorTL
63EcuadorEC
64EgyptEG
65El SalvadorSV
66Equatorial GuineaGQ
67EritreaER
68EstoniaEE
69EswatiniSZ
70EthiopiaET
71Falkland Islands (Islas Malvinas)FK
72Faroe IslandsFO
73FijiFJ
74FinlandFI
75FranceFR
76French GuianaGF
77French PolynesiaPF
78GabonGA
79GeorgiaGE
80GermanyDE
81GhanaGH
82GibraltarGI
83GreeceGR
84GreenlandGL
85GrenadaGD
86GuadeloupeGP
87GuamGU
88GuatemalaGT
89GuineaGN
90Guinea-BissauGW
91GuyanaGY
92HaitiHT
93Holy SeeVA
94HondurasHN
95Hong KongHK
96HungaryHU
97IcelandIS
98IndiaIN
99IndonesiaID
100IranIR
101IraqIQ
102IrelandIE
103Isle of ManIM
104IsraelIL
105ItalyIT
106JamaicaJM
107JapanJP
108JordanJO
109KazakhstanKZ
110KenyaKE
111KiribatiKI
112KosovoXK
113KuwaitKW
114KyrgyzstanKG
115LaosLA
116LatviaLV
117LebanonLB
118LesothoLS
119LiberiaLR
120LibyaLY
121LiechtensteinLI
122LithuaniaLT
123LuxembourgLU
124MacauMO
125MacedoniaMK
126MadagascarMG
127MalawiMW
128MalaysiaMY
129MaldivesMV
130MaliML
131MaltaMT
132Marshall IslandsMH
133MartiniqueMQ
134MauritaniaMR
135MauritiusMU
136MayotteYT
137MexicoMX
138MicronesiaFM
139MoldovaMD
140MonacoMC
141MongoliaMN
142MontenegroME
143MontserratMS
144MoroccoMA
145MozambiqueMZ
146Myanmar (Burma)MM
147NamibiaNA
148NauruNR
149NepalNP
150NetherlandsNL
151New CaledoniaNC
152New ZealandNZ
153NicaraguaNI
154NigerNE
155NigeriaNG
156NiueNU
157North KoreaKP
158Northern Mariana IslandsMP
159NorwayNO
160OmanOM
161PakistanPK
162PalauPW
163State of PalestinePS
164PanamaPA
165Papua New GuineaPG
166ParaguayPY
167PeruPE
168PhilippinesPH
169Pitcairn IslandsPN
170PolandPL
171PortugalPT
172Puerto RicoPR
173QatarQA
174ReunionRE
175RomaniaRO
176RussiaRU
177RwandaRW
178Saint BarthelemyBL
179Saint HelenaSH
180Saint Kitts and NevisKN
181Saint LuciaLC
182Sint MaartenSX
183Saint MartinMF
184Saint Pierre and MiquelonPM
185Saint Vincent and the GrenadinesVC
186SamoaWS
187San MarinoSM
188Sao Tome and PrincipeST
189Saudi ArabiaSA
190SenegalSN
191SerbiaRS
192SeychellesSC
193Sierra LeoneSL
194SingaporeSG
195SlovakiaSK
196SloveniaSI
197Solomon IslandsSB
198SomaliaSO
199South AfricaZA
200South KoreaKR
201South SudanSS
202SpainES
203Sri LankaLK
204SudanSD
205SurinameSR
206SwedenSE
207SwitzerlandCH
208SyriaSY
209TaiwanTW
210TajikistanTJ
211TanzaniaTZ
212ThailandTH
213The BahamasBS
214The GambiaGM
215TogoTG
216TokelauTK
217TongaTO
218Trinidad and TobagoTT
219TunisiaTN
220TurkiyeTR
221TurkmenistanTM
222Turks and Caicos IslandsTC
223TuvaluTV
224UgandaUG
225UkraineUA
226United Arab EmiratesAE
227United KingdomGB
228United StatesUS
229UruguayUY
230U.S. Virgin IslandsVI
231UzbekistanUZ
232VanuatuVU
233Vatican CityVA
234VenezuelaVE
235VietnamVN
236Wallis and FutunaWF
237Western SaharaEH
238YemenYE
239ZambiaZM
240ZimbabweZW