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)
  6. Know Your Business (KYB)

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",
"kyb"
],
"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_options": {
"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,
},
"kyb": {
"business_name": "Acme Corporation",
"registration_number": "",
"countries": ["GB"],
"search_filter": "contains",
"ttl": 120
},
"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_optionsRequired: 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.
kyb.business_nameRequired: Yes (if kyb.registration_number is not given)
Type: String (3–128 characters)
Company name to search.
kyb.registration_numberRequired: Yes (if kyb.business_name is not given)
Type: String (1–255 characters)
Company registration number.
kyb.countriesRequired: Yes
Type: Array of Strings
Size: Exactly 1
Country/state code for KYB query.
kyb.search_filterRequired: No
Type: String
Allowed values: contains, start_with, fuzzy
KYB search strategy.
kyb.ttlRequired: No
Type: Integer
Min: 60 seconds
KYB cache time-to-live.
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
240ZimbabweZW

KYB Supported Countries

Facia's KYB (Know Your Business) functionality provides comprehensive business verification across multiple countries, enabling secure and compliant business transactions while managing financial risks effectively. This service adheres to regulatory standards to enhance the credibility of global business operations.

For optimal results, always specify the target country using the appropriate country code. For instance, when searching for a company in the United Kingdom, set the country code to ['GB'] to ensure accurate and region-specific results. This targeted approach delivers the most relevant information for your business verification needs.

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

KYB Supported States

For US registry access, it is essential to specify not just the country but also the specific state. For example, when performing a Company Search for Texas, the country name field should be set to ['united_states.texas'] to ensure accurate and state-specific results.

No.State NameState Code
1AlabamaAL
2AlaskaAK
3ArizonaAZ
4ArkansasAR
5CaliforniaCA
6ColoradoCO
7ConnecticutCT
8DelawareDE
9District of ColumbiaDC
10FloridaFL
11GeorgiaGA
12HawaiiHI
13IdahoID
14IndianaIN
15IowaIA
16KansasKS
17KentuckyKY
18LouisianaLA
19MarylandMD
20MassachusettsMA
21MichiganMI
22MinnesotaMN
23MississippiMS
24MontanaMT
25NebraskaNE
26New HampshireNH
27New JerseyNJ
28New MexicoNM
29New YorkNY
30North CarolinaNC
31North DakotaND
32OhioOH
33OklahomaOK
34OregonOR
35Rhode IslandRI
36South CarolinaSC
37South DakotaSD
38TennesseeTN
39TexasTX
40VermontVT
41VirginiaVA
42WashingtonWA
43West VirginiaWV
44WisconsinWI
45WyomingWY
46PennsylvaniaPA
47IllinoisIL
48MaineME
49NevadaNV
50UtahUT
51MissouriMO