# 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} |
TYPE | GET |
**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 |
**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 |
**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 |
**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 |
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 |
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 | [](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 |
**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 |
**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 |
**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. |
**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 |
**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. |
**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 |