Skip to main content

Degree Verification

The following documentation explains how to integrate with the Education Verification API. This API is used to perform education verification for candidates.

API Endpoint​

Endpoint URL: POST https://api.trential.dev/verification/api/1.0/bgv/diy

Try it out →

Request​

To perform education verification, send a POST request to the above endpoint with the following JSON payload:

{
  "data": {
    "level": "DIPLOMA",
    "nameAsPerDocument": "Shaiwal Shekhar Mishra",
    "nameOfInstitute": "A M A L College",
    "nameOfProgram": "B.Tech",
    "registrationNumber": "13232",
    "issueDate": "2024-05-03",
    "degreeStatus": "COMPLETED",
    "yearOfPassing": "2024",
    "documentList": [
      {
        "label": "Degree",
        "url": "https://storage.googleapis.com/trential-images-dev/65940bdd9b271d7e123a90d2/bgv-degree/90c5aadbcc80a708b2196731bc470075e0b54bdd0749a038a8f98ef19ba8cbf3"
      },
      {
        "label": "Marksheet",
        "url": "https://storage.googleapis.com/trential-images-dev/65940bdd9b271d7e123a90d2/bgv-degree/eed5c7782a4013518f708f78a0fa1578b9dba0410e27abeb3775e749ec656df7"
      }
    ]
  },
  "verificationName": "bgv-degree",
  "transactionId": "664758ec4c1572facafdafa0"
}

cURL​

curl -X POST 'https://api.trential.dev/verification/api/1.0/bgv/diy' \
  -H 'x-api-key: YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  --data-raw '{
    "data": {
      "level": "GRADUATE",
      "nameAsPerDocument": "Candidate Name",
      "nameOfInstitute": "University Name",
      "nameOfProgram": "B.Tech",
      "registrationNumber": "13232",
      "yearOfPassing": "2016",
      "degreeStatus": "COMPLETED",
      "documentList": [
        { "label": "Degree", "url": "FILE_URL" },
        { "label": "Marksheet", "url": "FILE_URL" }
      ]
    },
    "verificationName": "bgv-degree",
    "transactionId": "YOUR_TRANSACTION_ID"
  }'

Parameters​

  • level (string): Candidate's education level. Accepted values are:- (Required)
    1. DIPLOMA
    2. GRADUATE
    3. MASTERS
    4. PHD
    5. POST_DOC
    6. POST_GRADUATE_DIPLOMA
    7. PROFESSIONAL_COURSE
    8. OTHER
  • nameAsPerDocument (string): The candidate's name as per the document(Required)
  • nameOfInstitute (string): The candidate's institute name(university/college)(Required)
  • registrationNumber (string): The candidate's registration/roll number(Required)
  • issueDate (string): Document issue date. (Conditionally Required) - Required if yearOfPassing is not provided and degreeStatus is COMPLETED, DEGREE_ONLY_NO_MARKSHEET, or LATERAL_ENTRY.
  • nameOfProgram (string): Candidate's program/course name (e.g. B.Tech, B.Sc, MBA)(Optional)
  • degreeStatus (string): Candidate's degree status. Accepted values are:- (Optional)
    1. COMPLETED
    2. CURRENTLY_PURSUING
    3. INCOMPLETE
    4. LATERAL_ENTRY
    5. DEGREE_ONLY_NO_MARKSHEET
  • yearOfPassing (string): Candidate's passing year. (Conditionally Required) - Required if issueDate is not provided and degreeStatus is COMPLETED, DEGREE_ONLY_NO_MARKSHEET, or LATERAL_ENTRY.
  • documentList (string): List of all the document with label like:- (Required)
    1. Degree
    2. Marksheet
  • verificationName (string): Name of verification Accepted value:- (Required)
    1. bgv-degree
  • transactionId (string): Id you get in the add candidate api response (Required)

Response​

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

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