# GET SERVICES ### VALIDATION GET web service that allows querying a transaction by specifying its unique identifier.
**Name****Validation**
URL{URL\_Base}/api/{ProjectName}/Validation/{id}
TYPEGET
**PARAMETERS**
**Name****Data Type****Parameter Type****Required****Description**
ProjectNameStringPathYesThe assigned project name
apiKeyStringHeaderYesThe key assigned to the project
idIntpathYesThe unique identifier of the transaction to be queried
returnImagesBooleanqueryYesDetermines whether images are returned in the query
returnDocumentsbooleanheaderYesParameter that determines whether signed documents are returned or not.
returnVideoLivenessbooleanheaderYesParameter that determines whether the Liveness video will be returned in Base64 format.
AuthorizationstringheaderNoAccess token
**RESPONSES**
**Code****Response****Description**
401client 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.
404The 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.
The Images field displays ImageTypeId, which are described in 'RESPONSE DICTIONARY IMAGES'; in the same array, the Liveness video is returned. ### FINDBYNUMBERID GET web service that returns the last case for the specified client.
**Name****FindByNumberId**
URL{URL\_Base}/api/{ProjectName}/FindByNumberId
TYPEGET
**PARAMETERS**
**Name****Data Type****Parameter Type****Required****Description**
ProjectNameStringPathYesThe assigned project name
apiKeyStringHeaderYesThe key assigned to the project
identificationStringqueryYesThe customer's identification number
docTypeStringqueryYesDocument type to be queried
returnImagesBooleanqueryYesDetermines whether the images of the transaction will be returned.
AuthorizationstringheaderNoAccess token
**RESPONSES**
**Code****Response****Description**
401ApiKey or Project or DocType not validThe ApiKey, ProjectName, or DocType parameter is incorrect.
404Client 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.
The Images field displays ImageTypeId and ImageTypeName, which are described in 'RESPONSE DICTIONARY IMAGES'. ### FINDBYNUMBERIDSUCCESS Endpoint that returns the most recent case with a rating of 'Satisfactory Process', which corresponds to code 2, for the queried document.
NameFindByNumberIdSuccess
URL{URL\_Base}/api/{ProjectName}/FindByNumberIdSuccess
TYPEGET
**PARAMETERS**
NameData TypeParameter TypeRequiredDescription
ProjectNameStringPathYesThe assigned project name
apiKeyStringHeaderYesThe key assigned to the project
identificationStringqueryYesThe client's identification number
doctypeInteger ($int32)queryYesThe type of document to be queried
returnImagesBooleanqueryYesIndicates whether the transaction images will be returned
AuthorizationstringheaderNoAccess token
EnrolBooleanqueryNoThis parameter indicates whether the process will be queried with enrollment or not; this depends on the site configuration and whether enrollment is enabled
**RESPONSES**
CodeResponseDescription
400Error description message: The type of document is not validThere is an error in the submitted model or the document type provided is not found
401The api key value is required Authorization is required to use this methodThe 'apiKey' parameter is missing or the 'projectName-apiKey' combination is not valid
404The specified project was not foundThe 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
The 'Images' field displays 'ImageTypeId' and 'ImageTypeName', which are described in the 'Images Response Dictionary' ### IDENTIFICATIONTYPES GET web service that returns all identification types defined in the application
**Name****FindByNumberId**
URL{URL\_Base}/api/{ProjectName}/IdentificationTypes
TYPEGET
**PARAMETERS**
**Name****Data Type****Parameter Type****Required****Description**
ProjectNameStringPathYesThe assigned project name
apiKeyStringHeaderYesThe key assigned to the project
AuthorizationstringHeaderNoAccess 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.
The document type ID can be found in 'DOCUMENT DICTIONARY'. ## TEMPLATES GET web service that returns the templates by enrolled identification in the application.
NameTemplates
URL{URL\_Base}/api/{ProjectName}/Templates
TYPEGET
**PARAMETERS**
**Name****Data Type****Parameter Type****Required****Description**
ProjectNameStringPathYesThe assigned project name
apiKeyStringHeaderYesThe key assigned to the project
DocumentTypeIntegerQueryYesNumber of the registered document type in the platform.
IdentificationNumberStringQueryYesIdentification number
AuthorizationstringHeaderNoAccess 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.
401ApiKey or Project or Authorization not validThe ApiKey, ProjectName, or Authorization field is incorrect.
404Customer not FoundIdentification number not enrolled in the platform.
The TemplateType field has two options: 'FaceTemplate,' which corresponds to the enrolled face template, and 'FingerTemplate,' which corresponds to the fingerprint template that is enrolled when fingerprint reading applies. ## RISKCLASIFICATION GET web service that returns the risk levels per configured transaction.
**Name****Templates**
URL{URL\_Base}/api/Integration/GetRiskClassification
TYPEGET
**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.
This would be an example of how risk levels could be configured in the platform. Intervals cannot overlap; each new ID must respect the value of X+1.
**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