File Upload

Before initiating a verification check that requires documents (education, employment, address, etc.), upload the file using this API to get a fileUrl. Pass that URL as the document parameter in the corresponding verification API.

API Endpoint

Endpoint URL: POST https://api.trential.dev/utility/api/1.0/files

Try it out →

Request

Send a multipart/form-data POST request with the file and the fileCategory query parameter set to the verification type the document belongs to.

curl -X POST 'https://api.trential.dev/utility/api/1.0/files?fileCategory=bgv-twelfth' \
  -H 'x-api-key: API_KEY_VALUE' \
  -F 'file=@/path/to/marksheet.pdf'

fileCategory Values

Value	Used for
bgv-tenth	10th marksheet
bgv-twelfth	12th marksheet
bgv-degree	Degree certificate or marksheet
bgv-employment	Salary slip, appointment letter, or experience letter
bgv-criminal	Court record verification
bgv-police-verification	Police verification
bgv-police-clearance-certificate	Police Clearance Certificate
bgv-cibil	PAN card for credit check
bgv-local-address-digital	Local address document (digital)
bgv-local-address-postal	Local address document (postal)
bgv-permanent-address-digital	Permanent address document (digital)
bgv-permanent-address-postal	Permanent address document (postal)

Response

{
  "code": 0,
  "message": "Success",
  "data": {
    "fileUrl": "https://storage.googleapis.com/trential-images-dev/65940bdd9b271d7e123a90d2/bgv-twelfth/ff88720aefc6a461bbb60f9eee94d27afa4e4eac1c52a971481a41b5b06f7a66"
  }
}

Use the returned fileUrl as the document URL when calling verification APIs such as 12th Verification, Degree Verification, or Employment Verification.