VERSIÓN	FECHA EMISIÓN	DESCRIPCIÓN DE CAMBIOS
3.2	6 de octubre de 2022	Versionamiento del documento
3.3	14 de octubre de 2022	La validación del SDKVersion sale por el código 400 en el DocumentBackSide y la validación del producto solo sale por código 404 en el CustomerVerification

Name	Validation
URL	{URL\_Base}/api/{ProjectName}/Validation/{id}
TYPE	GET

**PARAMETERS**
Name	Data Type	Parameter Type	Required	Description
ProjectName	String	Path	Yes	The assigned project name
apiKey	String	Header	Yes	The key assigned to the project
id	Int	path	Yes	The unique identifier of the transaction to be queried
returnImages	Boolean	query	Yes	Determines whether images are returned in the query
returnDocuments	boolean	header	Yes	Parameter that determines whether signed documents are returned or not.
returnVideoLiveness	boolean	header	Yes	Parameter that determines whether the Liveness video will be returned in Base64 format.
Authorization	string	header	No	Access token

**RESPONSES**
Code	Response	Description
401	client not authorized to make requests The api key value is required Authorization is required to use this method	The ApiKey, ProjectName, or DocType parameter is incorrect.
404	The specified project was not found Transaction not found	There are no records for the pair of document type and number, and the condition of a successful process.
200	[Response Object Description](https://adocolumbia.ado-tech.com/documentation/ServiciosRest.html#line2_6)	JSON-formatted object containing the information of the queried transaction.
500		An error has occurred, please check the error and try again.

Name	FindByNumberId
URL	{URL\_Base}/api/{ProjectName}/FindByNumberId
TYPE	GET

**PARAMETERS**
Name	Data Type	Parameter Type	Required	Description
ProjectName	String	Path	Yes	The assigned project name
apiKey	String	Header	Yes	The key assigned to the project
identification	String	query	Yes	The customer's identification number
docType	String	query	Yes	Document type to be queried
returnImages	Boolean	query	Yes	Determines whether the images of the transaction will be returned.
Authorization	string	header	No	Access token

**RESPONSES**
Code	Response	Description
401	ApiKey or Project or DocType not valid	The ApiKey, ProjectName, or DocType parameter is incorrect.
404	Client not found.	There are no records for the pair of document type and number.
200	{ "Uid": "string", "StartingDate": "string", "CreationDate": "string", "CreationIP": "string", "DocumentType": 0, "IdNumber": "string", "FirstName": "string", "SecondName": "string", "FirstSurname": "string", "SecondSurname": "string", "Gender": "string", "BirthDate": "string", "Street": "string", "CedulateCondition": "string", "Spouse": "string", "Home": "string", "MaritalStatus": "string", "DateOfIdentification": "string", "DateOfDeath": "string", "MarriageDate": "string", "Instruction": "string", "PlaceBirth": "string", "Nationality": "string", "MotherName": "string", "FatherName": "string", "HouseNumber": "string", "Profession": "string", "TransactionType": 0, "TransactionTypeName": "string", "IssueDate": "string", "BarcodeText": "string", "OcrTextSideOne": "string", "OcrTextSideTwo": "string", "SideOneWrongAttempts": 0, "SideTwoWrongAttempts": 0, "FoundOnAdoAlert": false, "AdoProjectId": "string", "TransactionId": "string", "ProductId": "string", "ComparationFacesSuccesful": false, "FaceFound": false, "FaceDocumentFrontFound": false, "BarcodeFound": false, "ResultComparationFaces": 0, "ComparationFacesAproved": false, "Extras":{ "IdState": "string", "StateName": "string" }, "NumberPhone": "string", "CodFingerprint": "string", "ResultQRCode": "string", "DactilarCode": "string", "ResponseControlList": "string", "Images":\[ { "Id": int, "ImageTypeId": "String", "ImageTypeName: "String", "Image": "Imagen base 64", } \], "SignedDocuments": \["String"\], "Scores":\[ { "Id": 0, "StateName": "string", "StartingDate": "string", "Observation": "string" } \], "Parameters": "String", "StateSignatureDocument":"String" }	JSON-formatted object containing the information of the queried transaction.

Name	FindByNumberIdSuccess
URL	{URL\_Base}/api/{ProjectName}/FindByNumberIdSuccess
TYPE	GET

**PARAMETERS**
Name	Data Type	Parameter Type	Required	Description
ProjectName	String	Path	Yes	The assigned project name
apiKey	String	Header	Yes	The key assigned to the project
identification	String	query	Yes	The client's identification number
doctype	Integer ($int32)	query	Yes	The type of document to be queried
returnImages	Boolean	query	Yes	Indicates whether the transaction images will be returned
Authorization	string	header	No	Access token
Enrol	Boolean	query	No	This parameter indicates whether the process will be queried with enrollment or not; this depends on the site configuration and whether enrollment is enabled

**RESPONSES**
Code	Response	Description
400	Error description message: The type of document is not valid	There is an error in the submitted model or the document type provided is not found
401	The api key value is required Authorization is required to use this method	The 'apiKey' parameter is missing or the 'projectName-apiKey' combination is not valid
404	The specified project was not found	The submitted 'projectName' was not found, or no transaction was found with the provided data
200	[![Screenshot 2025-06-12 at 15-55-53 ADO TECNOLOGIES Manuales Tecnicos.png](https://docs.ado-tech.com/uploads/images/gallery/2025-06/scaled-1680-/y7kBGXMS3SyD2kU0-screenshot-2025-06-12-at-15-55-53-ado-tecnologies-manuales-tecnicos.png)](https://docs.ado-tech.com/uploads/images/gallery/2025-06/y7kBGXMS3SyD2kU0-screenshot-2025-06-12-at-15-55-53-ado-tecnologies-manuales-tecnicos.png)	A JSON-formatted object containing the information of the queried transaction

Name	FindByNumberId
URL	{URL\_Base}/api/{ProjectName}/IdentificationTypes
TYPE	GET

**PARAMETERS**
Name	Data Type	Parameter Type	Required	Description
ProjectName	String	Path	Yes	The assigned project name
apiKey	String	Header	Yes	The key assigned to the project
Authorization	string	Header	No	Access token

**RESPONSES**
Code	Response	Description
200	{ "Id": int, "IdentitificationName": "String", "Active": boolean, "Locked": boolean, "ActiveDescription": "String", "LockedDescription": "String" }	JSON-formatted object containing the information of the queried transaction.

Name	Templates
URL	{URL\_Base}/api/{ProjectName}/Templates
TYPE	GET

**PARAMETERS**
Name	Data Type	Parameter Type	Required	Description
ProjectName	String	Path	Yes	The assigned project name
apiKey	String	Header	Yes	The key assigned to the project
DocumentType	Integer	Query	Yes	Number of the registered document type in the platform.
IdentificationNumber	String	Query	Yes	Identification number
Authorization	string	Header	No	Access token.

**RESPONSES**
Code	Response	Description
200	{ IdentificationTypeId: Integer, IdentificationType: "String", IdentificationNumber: "String", FirstName: "String", SecondName: "String", FirstSurname: "String", SecondSurname: "String", Gender: "String", Templates: \[ TemplateType: "String", Template: "String", \] }	JSON-formatted object containing the information of the queried transaction.
401	ApiKey or Project or Authorization not valid	The ApiKey, ProjectName, or Authorization field is incorrect.
404	Customer not Found	Identification number not enrolled in the platform.

Name	Templates
URL	{URL\_Base}/api/Integration/GetRiskClassification
TYPE	GET

**RESPONSES**
Code	Response	Description
200	{ Id: Int, From: Int, To: Int }	"JSON-formatted object containing the information of the configured risk levels. Each risk level includes the following three parameters.

**Risk Levels**
Id	From	To
1	$0	$1.000.000
2	$1.000.001	$15.000.000
3	$15.000.001	$50.000.000
4	$50.000.001	$100.000.000

**PARAMETERS**
PARAMETER	TYPE	MEDIUM	DESCRIPTION
grant\_type	String	FormData	Type of Authorization
username	String	FormData	Username assigned by Ado for the token query.
password	String	FormData	Password corresponding to the assigned user for the token query, must be in SHA-1 hash format.

**RESPONSES**
Code	Description
200	JSON object containing the token and other fields described in the RESPONSE FIELDS table
400	unsupported\_grant\_type The user name or password is incorrect.

**RESPONSE FIELDS:**
Field Name	TYPE	DESCRIPTION
access\_token	String	El token emitido.
token\_type	String	Tipo de token generado.
expires\_in	Int	Tiempo de vigencia del token en minutos.
issued	String	Fecha y hora de emisión de emisión del token.
expires	String	Fecha y hora de vencimiento del token.

Name	New
Url	{URL\_Base}/api/integration/{projectName}/Validation/New
TYPE	POST

**PARAMETERS**
Name	Data Type	Parameter Type	Required	Description
ProjectName	String	Query	Yes	The name of the associated project.
Apikey	String	Header	Yes	The key assigned to the project.
Authorization	String	Header	No	Access token.
transactionInfo	Json	Body	Yes	The data of the new transaction.

Name	Type	Required	Description
ProductId	Int	Yes	Product number for the verified customer transaction.
CustomerPhoto	String	Yes	Base64-encoded selfie image
DocumentType	String	No	Document type ID, obtained by consuming the IDENTIFICATIONTYPES service. If it is not provided in the request, the default value assigned is Cédula de ciudadanía (ID 1).
Longitude	String	No	Longitude of the location where the process takes place.
Latitude	String	No	Latitude of the location where the process takes place.
IdAssociated	String	No	Co-signer’s identification number
ClientRole	String	No	Assigned role number for the platform
KeyProcessLiveness	String	No	Liveness process key received during the selfie capture process
UIdDevice	String	No	Character string that defines and identifies the device from which the request is made
IdUser	String	No	ID registered on the ADO platform for the user making the service request
SourceDevice	Integer	No	Number that identifies the type of device: 1 for Web, 2 for Android, and 3 for iOS.
SdkVersion	string	No	Build or SDK version number being used, which can be found in the repository's ChangeLog.
OS	string	No	Type of operating system from which the service is being consumed
BrowserVersion	string	No	If the OS field is set to Web, the browser version used is sent.
IMEI	string	No	IMEI of the mobile device consuming the service
RiskId	string	No	Risk classification ID
Uid	String	No	Transaction identification number. If this is the first service call, the service will return a UID that must be sent in all subsequent service requests until the Close service is executed. If a UID already exists, it must be included to associate the uploaded images with the same transaction.

**RESPONSES**
Code	Description
200	The transaction has been successfully initiated. An object is returned containing information associated with it.
201	The face being validated is already enrolled. An object is returned containing information about the created transaction, including the unique transaction number.
400	The type of document not is valid The risk ID is not valid The risk ID is not valid The risk ID must be an integer Document type is not active
401	The api key value is required Api Key not valid Can't found User with specified credentials Can't found specified Source Device
404	The specified project was not found
406	The facial photograph does not meet the expected criteria. This may be due to the face in the image having glasses, an open mouth, or a blink.. Base64 not valid. Image not valid.
500	An error has occurred. Please check the error and try again.

Name	DocumentBackSide
Url	{URL\_Base}api/integration/{projectName}/ Validation/Images/DocumentBackSide
TYPE	POST

**PARAMETERS**
Name	Data Type	Parameter Type	Required	Description
ProjectName	String	Query	Yes	The name of the associated project
Apikey	String	Header	Yes	The key assigned to the project
Authorization	String	Header	No	Access token
sideTwoInfo	Json	Body	Yes	The data of the new transaction

Name	Type	Required	Description
Image	String	Yes	Image of the back side of the document in Base64 format
DocumentType	String	No	Document type ID, obtained by consuming the `IDENTIFICATIONTYPES` service. If this field is not provided, the system will default to assigning “Cédula de ciudadanía” (ID 1) as the document type.
UIdDevice	String	No	String that defines and identifies the device from which the request is made.
SourceDevice	Integer	No	Number that identifies the device type, with values of 1 for Web, 2 for Android, and 3 for iOS.
SdkVersion	string	No	Build or SDK version number being used, which can be found in the repository's ChangeLog.
OS	string	No	Type of operating system from which the service is being consumed
BrowserVersion	string	No	If the OS field is set to Web, the browser version used is sent.
TransactionType	string	No	Transaction type ID
ProductId	string	No	Product number for the transaction
Uid	String	No	Transaction identification number. If this is the first time the service is consumed, it will return a UID that must be sent in all subsequent service calls until the Close service is executed. If a UID already exists, it must be included to associate the uploaded images with the same transaction.
RiskId	String	No	Risk classification ID

**RESPONSES**
Code	Description
200	The transaction has been successfully initiated. An object containing information associated with it is returned. RESPONSE OBJECT DESCRIPTION
201	The client was previously registered. An object is returned containing information about the created transaction, including the unique transaction number.
400	The type of document not is valid The specified transaction type was not found Transaction type Id must be a valid integer Document type is not active Sdk Versión is not valid
401	The api key value is required Api Key not valid Can't found User with specified credentials Can't found specified Source Device
404	The specified project was not found
406	Base64 not valid. Image not valid.
500	An error has occurred. Please validate the error and try again.

Name	Fingerprint
Url	{URL\_Base}api/integration/{projectName}/ Validation/Images/Fingerprint
TYPE	POST

**PARAMETERS**
Name	Data Type	Parameter Type	Required	Description
ProjectName	String	Query	Yes	The name of the associated project
Apikey	String	Header	Yes	The key assigned to the project
Authorization	String	Header	No	Access token
fingerInfo	Json	Body	Yes	The image encoded in Base64

Name	Type	Required	Description
Image	String	Yes	Image of the front of the document in Base64 format
DocumentType	String	Yes	Document Type Number: 1. Citizenship ID (Cédula de Ciudadanía) 2. PEP with passport only 3. Foreigner ID (Cédula de Extranjería) 4. Identity Card (Tarjeta de Identidad)
FingerType	int	Yes	Fingerprint enumerator, possible values: (1, 2)
Uid	String	Yes	Transaction identification number. If this is the first time the service is consumed, it will return a UID that must be sent in all subsequent service calls until the Close service is executed. If a UID already exists, it must be included to link the uploaded images to the same transaction.
RiskId	String	No	Risk identifier

**RESPONSES**
Code	Description
200	The fingerprint has been successfully uploaded and the transaction information has been updated.
400	The provided data does not match the expected criteria
401	The authorization process was not successful. Please validate the project code and/or the API Key.
403	The fingerprint photograph is not valid for biometric extraction.
404	The project code and/or the specified UID does not exist.
500	An error has occurred. Please validate the provided ID number to obtain more details.

Name	Close
Url	{URL\_Base}/api/Integration/{projectName}/Validation/Close
TYPE	POST

**PARAMETERS**
Name	Data Type	Parameter Type	Required	Description
ProjectName	String	Query	Yes	The name of the associated project
Apikey	String	Header	Yes	The key assigned to the project
Authorization	String	Header	No	Access token
info	Json	Body	Yes	The information required to close the transaction

Name	Type	Required	Description
Uid	String	Yes	Transaction UID
RiskId	String	No	Risk classification ID

**RESPONSES**
Code	Description
200	The transaction has been successfully created. An object containing information associated with it is returned — RESPONSE OBJECT DESCRIPTION
400	The risk ID is not valid The risk ID must be an integer.
401	The api key value is required Api Key not valid
404	The specified project was not found<404>
500	An error has occurred. Please check the error and try again.

Name	CheckHealt
URL	{URL\_Base}/api/Integration/CheckHealt
TYPE	POST

**PARAMETERS**
Name	Data Type	Parameter Type	Required	Description
ProjectName	String	query	Yes	The name of the associated project
apiKey	String	header	Yes	The key assigned to the project
authorization	String	header	Yes	Access token

**RESPONSES**
Code	Response	Description
200	{ "Code": "String", "Message": "String" }	JSON-formatted object containing information related to the platform status

Name	Type	Description
{
Uid	String	Transaction identification number
StartingDate	String	Date and time when the first required image for the validation process began transmitting to the server.
CreationDate	String	Date and time when the full set of images required for the validation process finished transmitting to the server.
CreationIP	String	IP address from which the identity validation process was performed
DocumentType	Int	Document Type Number: 1. Citizenship ID 2. PEP with passport only 3. Foreigner ID 4. Identity Card
IdNumber	int	Identification number of the validated client
FirstName	String	First name of the verified client
SecondName	String	Second name of the verified client
FirstSurname	String	First surname of the verified client
SecondSurname	String	Second surname of the verified client
Gender	String	Gender of the verified client
BirthDate	String	Date of birth of the verified client in YYYY-MM-DD format, ignoring the time
Street	String	Address of the verified client
CedulateCondition	String
Spouse	String
Home	String
MaritalStatus	String	Marital status of the verified client
DateOfIdentification	String	Expiration date of the national ID card in routines that query Ecuador’s civil registry, only when the service is active to retrieve this information. This field uses the YYYY-MM-DD format, ignoring the time.
DateOfDeath	String	DateOfDeath.
MarriageDate	String	MarriageDate.
Instruction	String
PlaceBirth	String	Place of birth of the verified client
Nationality	String	Nationality of the verified client
MotherName	String	Mother's name of the verified client
FatherName	String	Father's name of the verified client
HouseNumber	String
Profession	String	Occupation of the verified client
ExpeditionCity	String	ExpeditionCity.
ExpeditionDepartment	String	ExpeditionDepartment.
BirthCity	String	BirthCity.
BirthDepartment	String	BirthDepartment.
TransactionType	int	Type of transaction performed
TransactionTypeName	String	Name of the type of transaction performed
IssueDate	String	Issuance date of the document presented by the verified client in YYYY-MM-DD format, ignoring the time
BarcodeText	String
OcrTextSideOne	String	Text extracted from the document capture by OCR (front side of the document)
OcrTextSideTwo	String	Text extracted from the document capture by OCR (back side of the document)
SideOneWrongAttempts	int	Number of failed attempts capturing the front side of the document
SideTwoWrongAttempts	int	Number of failed attempts capturing the back side of the document
FoundOnAdoAlert	String	Returns a boolean indicating whether alerts occurred on the ADO platform
AdoProjectId	String	Project number in the ADO platform
TransactionId	String	Transaction number for the client's certification
ProductId	String	Product number for the verified client’s transaction
ComparationFacesSuccesful	boolean	Returns a boolean indicating whether the face comparison was successful
FaceFound	boolean	Returns a boolean indicating whether a face was detected during the transaction
FaceDocumentFrontFound	boolean	Returns a boolean indicating whether a face was found in the document during the transaction
BarcodeFound	boolean	Returns a boolean indicating whether a barcode was detected during the transaction
ResultComparationFaces	int	Face comparison result
ResultCompareDocumentFaces	int	Face comparison result between document images
ComparationFacesAproved	boolean	Returns a boolean indicating whether the face comparison was approved
ThresholdCompareDocumentFaces	int	Returns an integer representing the configured comparison threshold
CompareFacesDocumentResult	string	CompareFacesDocumentResult.
"extras”: {
IdState	String	Rating number for the transaction
StateName	String	Transaction rating
}
NumberPhone	String	Phone number of the verified client
CodFingerprint	String
ResultQRCode	String
DactilarCode	String
ResponseControlList	String
Latitude	String	Latitude
Longitude	String	Longitude
"Images" : \[{
Id	String	Image identifier number
ImageTypeId	String	Image type ID
ImageTypeName	String	Image type name
Image	String	Base64 image
DownloadCode	String	Image download code
}\],
SignedDocuments	String Array	Array containing the list of digitally signed documents. These documents are returned in Base64 format and must be converted to PDF for viewing.
"Scores" : \[{
Id	int	Rating ID
UserName	String
StateName	String	Rating name
StartingDate	String	Date and time when transmission to the server began for the first image required in the validation process
Observation	String	Comments or observations about the transaction
}\]
"Response\_ANI": {
Niup	String	Identification number of the client consulted in the ANI
FirstSurname	String	First surname of the client consulted in the ANI
Particula	String
SecondSurname	String	Second surname from the document consulted in the ANI
FirstName	String	First name of the document consulted in ANI.
SecondName	String	Middle name of the document consulted in ANI.
ExpeditionMunicipality	String	Municipality of issuance of the document consulted in ANI.
ExpeditionDepartment	String	Department of issuance of the document consulted in ANI.
ExpeditionDate	String	Date of issuance of the document consulted in ANI.
CedulaState	String
}
Parameters	String	Parameters sent by the client associated with the transaction (JSON format).
StateSignatureDocument	String	Indicate whether the documents associated with the transaction have been digitally signed.
}

Name	GetFacialFeatures
URL	{URL\_Base}/api/GetFacialFeatures
TYPE	POST

**PARAMETERS**
Name	Data Type	Parameter Type	Required	Description
ProjectName	String	Query	Yes	The name of the associated project.
Apikey	String	Header	Yes	The key assigned to the project.
request	Json	Body	Yes	JSON format of the information required to consume the service.

Field Name	Data Type	Required	Description
Image	String	Yes	Facial image in Base64 format
GetFeatures	Boolean	Yes	Specifies whether to retrieve the features of the submitted image
GetTemplete	Boolean	Yes	Specifies whether to retrieve the template of the submitted face

**SERVICE RESPONSES**
Code	Description
200	Process executed successfully:The request was received by the server. The response, in JSON format, is described below.
400	Data error, check the request data: los dos valores de los campos GetFeatures y GetTemplete son False.
500	Internal server error: Internal server error.

**JSON Response Object**
Code	Response
200	{ "Status": "SUCCESS", "Message": "string", "Response": { "lstResults":\[ { "BoundingRect\_X": 0, "BoundingRect\_Y": 0, "BoundingRect\_Width": 0, "BoundingRect\_Height": 0, "FeaturePoints": \[ { "Point\_X": 0, "Point\_Y": 0, "Confidence": 0, "Code": 0, "Name": "string" } \], "Age": 0, "Gender": "string", "GenderConfidence": 0, "Expression": "string", "ExpressionConfidence": 0, "Blink": true, "BlinkConfidence": 0, "MouthOpen": true, "MouthOpenConfidence": 0, "Glasses": true, "GlassesConfidence": 0, "DarkGlasses": true, "DarkGlassesConfidence": 0, "EmotionAngerConfidence": 0, "EmotionContemptConfidence": 0, "EmotionDisgustConfidence": 0, "EmotionFearConfidence": 0, "EmotionHappinessConfidence": 0, "EmotionNeutralConfidence": 0, "EmotionSadnessConfidence": 0, "EmotionSurpriseConfidence": 0, "EthnicityAsianConfidence": 0, "EthnicityBlackConfidence": 0, "EthnicityHispanicConfidence": 0, "EthnicityIndianConfidence": 0, "EthnicityWhiteConfidence": 0, "Template": "string" } \] }, "data": {} }

`{`

` ``"datetime"``: ``"2021-04-14 09:23:37"``,`

` ``"id_bitacora"``: 783286,`

` ``"results"``: [`

` ``{`

` ``"item_no"``: 2,`

` ``"nombre"``: ``"rodriguez orejuela"``,`

` ``"doc_id"``: ``"6068015"``,`

` ``"block"``: ``true``,`

` ``"datos_pro"``: ``null``,`

` ``"datos_ramajudicial"``: ``null``,`

` ``"datos_amlnews"``: [],`

` ``"datos_tsti"``: [`

` ``{`

` ``"lista"``: [`

` ``"2776"`

` ``],`

` ``"estado"``: ``null``,`

` ``"categoria"``: [`

` ``"SDNT"`

` ``],`

` ``"nombre_apellido"``: [`

` ``"RODRIGUEZ OREJUELA, Gilberto Jose"`

` ``],`

` ``"pasaporte2"``: [`

` ``"10545599, 77588, 6067015, T321642"`

` ``],`

` ``"url"``: ``"http://bit.ly/1MLgpye ,http://bit.ly/1I7ipyR"``,`

` ``"detalle"``: [`

` ``"Specially Designated Nationals (SDN) - Treasury Department"`

` ``],`

` ``"pasaporte"``: [`

` ``"10545599, 77588, 6067015, T321642"`

` ``],`

` ``"n_identificacion2"``: [`

` ``"6067015, 6068015"`

` ``],`

` ``"ciudadania"``: [`

` ``""`

` ``],`

` ``"alias"``: [`

` ``"THE CHESS PLAYER, LUCAS"`

` ``],`

` ``"id"``: ``"1733370"``,`

` ``"n_identificacion"``: [`

` ``"6067015, 6068015"`

` ``],`

` ``"nombre_relacion_lista"``: [`

` ``"BIS"`

` ``],`

` ``"id_relacion_lista"``: [`

` ``"352"`

` ``],`

` ``"_version_"``: 1696964922198458368,`

` ``"estado1"``: ``null``,`

` ``"estado2"``: ``null``,`

` ``"estado3"``: ``null``,`

` ``"relacionado"``: ``"[]"`

` ``},`

` ``{`

` ``"lista"``: [`

` ``"3765"`

` ``],`

` ``"estado"``: ``null``,`

` ``"categoria"``: [`

` ``"SDNT"`

` ``],`

` ``"nombre_apellido"``: [`

` ``"Gilberto Jose RODRIGUEZ OREJUELA"`

` ``],`

` ``"pasaporte2"``: [`

` ``"Passport 10545599 Venezuela, Passport 77588 Argentina, Passport 6067015 Comoros, Passport T321642 Colombia"`

` ``],`

` ``"pais"``: [`

` ``"Colombia"`

` ``],`

` ``"detalle"``: [`

` ``"Individual"`

` ``],`

` ``"pasaporte"``: [`

` ``"Passport 10545599 Venezuela, Passport 77588 Argentina, Passport 6067015 Comoros, Passport T321642 Colombia"`

` ``],`

` ``"n_identificacion2"``: [`

` ``"Cedula No. 6067015 Colombia, Cedula No. 6068015 Colombia"`

` ``],`

` ``"alias"``: [`

` ``" THE CHESS PLAYER, LUCAS"`

` ``],`

` ``"id"``: ``"1757445"``,`

` ``"n_identificacion"``: [`

` ``"Cedula No. 6067015 Colombia, Cedula No. 6068015 Colombia"`

` ``],`

` ``"nombre_relacion_lista"``: [`

` ``"OFAC List"`

` ``],`

` ``"id_relacion_lista"``: [`

` ``"180"`

` ``],`

` ``"_version_"``: 1696965283939352576,`

` ``"estado1"``: ``null``,`

` ``"estado2"``: ``null``,`

` ``"estado3"``: ``null``,`

` ``"relacionado"``: ``"[]"`

` ``},`

` ``{`

` ``"lista"``: [`

` ``"3765"`

` ``],`

` ``"estado"``: ``null``,`

` ``"categoria"``: [`

` ``"SDNT"`

` ``],`

` ``"nombre_apellido"``: [`

` ``"Miguel Angel RODRIGUEZ OREJUELA"`

` ``],`

` ``"pais"``: [`

` ``"Colombia"`

` ``],`

` ``"detalle"``: [`

` ``"Individual"`

` ``],`

` ``"n_identificacion2"``: [`

` ``"Cedula No. 6095803 Colombia"`

` ``],`

` ``"alias"``: [`

` ``" EL SENOR, PATRICIA, PATRICIO, PATTY, PAT, MANUEL, MANOLO, MIKE, MAURO, DOCTOR M.R.O."`

` ``],`

` ``"id"``: ``"1757446"``,`

` ``"n_identificacion"``: [`

` ``"Cedula No. 6095803 Colombia"`

` ``],`

` ``"nombre_relacion_lista"``: [`

` ``"OFAC List"`

` ``],`

` ``"id_relacion_lista"``: [`

` ``"180"`

` ``],`

` ``"_version_"``: 1696965283939352577,`

` ``"estado1"``: ``null``,`

` ``"estado2"``: ``null``,`

` ``"estado3"``: ``null``,`

` ``"relacionado"``: ``"[]"`

` ``}`

` ``],`

` ``"datos_twitter"``: []`

` ``}`

` ``],`

` ``"elapsed_time"``: 2.3528490066528`

`}`

Manual	Código TE-MT-002	Versión: 3.3
Fecha emisión 06/10/2022	Titulo Integración servicios REST
Elaborado por: Camilo García	Revisado por: Ingrid Mercado	Aprobado por: Oscar castañeda

Name	Type	Yes	Description
DocumentType	String	No	Document type ID.
IdentificationNumber	String	Yes	Identification number.
Face	String	Yes	Base64-encoded image to be verified.
FingerPrint	String	No	Base64-encoded fingerprint image to be verified.
longitude	String	No	Location coordinate.
Latitude	String	No	Location coordinate.
ProductId	Integer	No	Product ID corresponding to the verification process.
KeyProcessLiveness	String	No	Liveness process key returned after capturing the selfie.
SourceDevice	Integer	No	ID of the device from which the process is being carried out.
SdkVersion	String	No	Version of the SDK being used.
OS	String	No	Operating system version.
BrowserVersion	String	No	Browser version being used.
UIdDevice	String	No	Character string that defines and identifies the device from which the request is made.
IdUser	String	No	ID registered in the ADO platform of the user making the service request.
IMEI	string	No	IMEI of the mobile device consuming the service.
RiskId	string	No	Configured risk ID in the platform.

Code	Description
200	The transaction has been successfully created.
400	All fields are required. Face not valid. The type of document not is valid. The risk ID is not valid. The risk ID must be an integer.
401	The api key value is required Authorization is required to use this method Can't found specified Source Device Can't found User with specified credentials
404	The specified project was not found The specified product was not found Customer not Found
406	The facial photograph does not meet the expected criteria; this may be due to the person wearing glasses, having an open mouth, or blinking.

Name	Data Type	Parameter Type	Required	Description
Model	Json	Body	Yes	The information required to close the transaction.
projectName	String	Path	Yes	Project name.
apiKey	String	Header	Yes	Project API key.
Authorization	String	Header	No	Access token.

Name	Data Type	Required	Description
IdentificationType	String	Yes	Identification type.
IdentificationNumber	String	Yes	Identification number.
FirstName	String	Yes	First name.
SecondName	String	No	Middle name.
FirstSurname	String	Yes	First surname.
SecondSurname	String	No	Second surname.
Documents	String Array	Yes	Array of PDF documents converted to Base64.

Name	Data Type	Required	Description
ProductId	Int	Yes	Product type.
CustomerPhoto	String Base64	Yes	Person’s facial image in Base64 format.
DocumentType	Int	Yes	Document Type

CODE	RESPONSE	DESCRIPTION
200	"Uid": "string", "StartingDate": "string", "CreationDate": "string", "CreationIP": "string", "DocumentType": "string", "IdNumber": "string", "FirstName": "string", "SecondName": "string", "FirstSurname": "string", "SecondSurname": "string", "Gender": "string", "BirthDate": "string", "Street": "string", "CedulateCondition": "string", "Spouse": "string", "Home": "string", "MaritalStatus": "string", "DateOfIdentification": "string", "DateOfDeath": "string", "MarriageDate": "string", "Instruction": "string", "PlaceBirth": "string", "Nationality": "string", "MotherName": "string", "FatherName": "string", "HouseNumber": "string", "Profession": "string", "ExpeditionCity": "string", "ExpeditionDepartment": "string", "BirthCity": "string", "BirthDepartment": "string", "TransactionType": 0, "TransactionTypeName": "string", "IssueDate": "string", "BarcodeText": "string", "OcrTextSideOne": "string", "OcrTextSideTwo": "string", "SideOneWrongAttempts": 0, "SideTwoWrongAttempts": 0, "FoundOnAdoAlert": false, "AdoProjectId": "string", "TransactionId": "int", "ProductId": "string", "ComparationFacesSuccesful": false, "FaceFound": false, "FaceDocumentFrontFound": false, "BarcodeFound": false, "ResultComparationFaces": 0, "ComparationFacesAproved": false, "Extras":{ "IdState": "string", "StateName": "Pendiente" }, "NumberPhone": "string", "CodFingerprint": "string", "ResultQRCode": "string", "DactilarCode": "string", "ResponseControlList": "string", "Images":\[ { "Id": int, "ImageTypeId": "String", "ImageTypeName": "String", "Image": "Imagen base 64", } \], "SignedDocuments": \["String"\], "Scores":\[ { "Id": 0, "StateName": "string", "StartingDate": "string", "Observation": "string" } \], "Parameters": "String", "StateSignatureDocument":"String" }	“JSON-formatted object containing the transaction information. For more information, see the section RESPONSE OBJECT DESCRIPTION.
404	Enroll not found	No prior enrollment has been found for this face.

NAME	TYPE	DESCRIPTION
IdState	String	Indicates in number the result of the transaction based on the dictionary shown below.
State	String	Indicates in text the outcome of the transaction based on the dictionary above below.

NAME	TYPE	DESCRIPTION
Niup	String	Unique personal identification number. Cedula of Citizenship of persons with Colombian nationality.
FirstSurname	String	First surname of the document consulted, it returns empty if it does not contain any data.
Particle	String
SecondSurname	String	Second surname of the document consulted, it returns empty if it does not contain any data.
First	String	First Name of the document consulted, it returns empty if it does not contain any data.
Second	String	Second Name of the document consulted, it returns empty if it does not contain any data.
ExpeditionMunicipality	String	Municipality where the document was issued, it returns empty if it does not contain any data.
ExpeditionDepartment	String	Department where the document was issued, it returns empty if it does not contain any information.
ExpeditionDate	String	Date on which the document was issued, it returns empty if it does not contain any data.
Cedula State	String	Status in which the ballot is located (review code tables for more information).

Code	Name
9963	Supersociety Restructuring Agreements
1381	AFRICAN BANK
5349	National Mining Agency RUCOM.
5666	Aml.News Argentina
1313	Aml.News Chile
3875	Aml.News Colombia
8458	Aml.News Costa Rica
4573	Aml-News Dominica
5899	Aml.News Ecuador
7661	Aml.News El Salvador
4491	Aml.News Spain
8561	Aml.News United States
6844	Aml.News Guatemala
9515	Aml.News Honduras
9194	Aml.News Mexico
9726	Aml-News Nicaragua
4297	Aml.News Panama
1189	Aml-News Paraguay
9534	Aml.News Peru
2889	Aml-News R. Dominica
3356	Aml-News Venezuela
4144	ASIAN BANK Anti-corruption and Integrity
4454	AUSTRALIAN FOREING AFFAIRS
2955	Bahamas leaks
9745	Inter-American Development Bank (IDB)
2375	World Bank
8391	Banks sanctioned Panama
5362	Newsletter Spanish Civil Guard
6242	DEA tickets
2487	Boletines Colombia Attorney's Office
2776	Bureau of Industry and Security BIS
6967	Concordets Supersocieties
8315	Comptroller of Peru
5694	Contractors 2015 and 2016 Mayor of Bogotá
9851	Construction contractors Mayor of Bogotá
3754	Contractors sanctioned Panama
5228	Liquidated or in Voluntary Liquidation Superhealth
1871	Illegal financial exercise Superfinanciera financial activity
4936	Companies in Supersolidary Voluntary Liquidation
1627	Entities in SuperHealth Restructuring Agreement
1976	Entities in Measure Cautellar Special Surveillance Superhealth
8573	Liquidated Superhealth Entities
2637	European Bank for Reconstruction and Development
8454	European List
3766	Europol
5622	FBI Fugitives
8616	Chief Mayor of Bogotá
3241	Officials and Contractors Comptroller
3417	GREATER VICTORIA CRIME STOPPERS
8923	HM Treasury
4193	Immigration and Customs Eforcement ICE
7264	Interpol International Criminal Police Organization
7127	Adverse Interventions Administrative Superhealth
3889	Central Board of Accountants
3861	Judicial Liquidation Supersocieties
5778	Liquidated, Administrative Forzosa Superhealth
1692	Public Ministry Colombia
7594	Public Prosecutor's Office of Honduras
8495	Public ministry Peru
3765	OFAC List
4298	Offshore leakst
6622	Terrorist organizations designated by the United States
3113	OSFI
9279	Panama Papers
5668	Paradise Papers
5318	PEPS Antigua and Barbuda
5488	PPEPS Argentina
2489	PPEPS Bahamas
5747	PPEPS Barbados
2138	PPEPS Belize
6356	PPEPS Brazil
4259	PPEPS Canada
3192	PPEPS Chile
4223	PPEPS Colombia
7714	PPEPS Costa Rica
3523	PPEPS Ecuador
4366	PPEPS United States
6135	PPEPS Mexico
5929	PPEPS Nicaragua
3126	PPEPS Panama
1914	PPEPS Paraguay
6729	PPEPS Peru
8277	PPEPS Puerto Rico
1636	PPEPS Dominican Republic
2651	PPEPS Saint Lucia
6255	PPEPS Trinidad and Tobago
4671	PPEPS Uruguay
9861	PPEPS Venezuela
8971	Argentine police
8998	Puerto Rico National Police
6482	Postulates Law 975 Justice and Peace. Attorney General's Office
7416	Presidency of the Peruvian Council of Ministers
8737	Suppliers Fictitious DIAN Colombia
4734	Fiscal Managers Comptroller's Office
7828	Punishments COPNIA
1422	Penalties in Colombia's Financial Superintendency
8456	Sentences for unfair competition SIC
3982	Companies in Compulsory Liquidation
7978	THE UK POLICE