Verification Insufficiency Resolve

The following documentation explains how to integrate with the Verification Insufficiency resolve API. This API is used to full fill Insufficiency for a verification in transaction.

API Endpoint

Endpoint URL: GET https://api.trential.dev/verification/api/1.0/bgv/insufficiency

Try it out

Request

To resolve verification insufficiency, send a POST request to the above endpoint with the required body.

{
  "dataToUpload": {
    "dataToUpload": {
      "insufficiencyDataList": [
        {
          "insufficiencyId": "1747656349037:1",
          "value": "INSUFFICIENCY RESOLVED"
        }
      ],
      "documents": [
        {
          "documentType": "Other",
          "fileType": "Url",
          "fileName": "PAN Card.pdf",
          "document": {
            "url": "https://storage.googleapis.com/indisi-images-dev/682b06f1fcc20619139b4d36/1747656349037:1::FILE::1/f4a7ec3e-ad56-490c-b032-34b9904369e7",
            "label": "1747656349037:1::FILE::1"
          }
        }
      ]
    }
  },
  "orgId": "66693b23d07c67ed14xxxxxxx",
  "transactionId": "664758ec4c1572faxxxxxa0",
  "subType": "xxxxxx"
}

🔧 Parameters

Parameter	Type	Description	Required
subType	string	ID of a specific verification in the transaction. Retrieve this using the Transaction Verification Info API.	✅ Yes
transactionId	string	Unique identifier of the transaction. You get this from the add candidate API response.	✅ Yes
orgId	string	Organization ID assigned to you by Trential.	✅ Yes
dataToUpload.insufficiencyDataList	array	List of insufficiencies to resolve. Each object should contain: • insufficiencyId: Retrieved from insufficiencyData in the verification info response. • value: Reason or message for resolution (e.g., "INSUFFICIENCY RESOLVED").	✅ Yes
dataToUpload.documents	array	List of documents used to resolve the insufficiency. Each document should include: • documentType: Type of document (e.g., "Other"). • fileType: "Url". • fileName: Name of the file. • document: An object with:   • url: URL of the document.   • label: File label string.	✅ Yes

Response

If the data is valid, the response will be as follows:

{
  "code": 0,
  "message": "Success"
}