RestAPI for SGPA-Calcluator

This has been specifically built to suppliment the mobile application that I have developed. Feel free to use this irrespective of the mobile-app, with which you can integrate into your own applications/projects to get the data. This RestAPI provides the results for all regulations, and of all types ( regular and supplementary ).

Documentation

An official documentation website for the API is available at SGPA RestAPI Docs. Please check it out for more information.

Endpoints


  /                  - This is where you are right now.
  /result            - A query parameter specific endpoint.
  /calculate         - Fetch the SGPA along with other details.
  /new/all           - Fetch all results links (Supplementary and Regular).
  /new/all/regular   - Fetch all regular results links.
  /new/all/supply    - Fetch all regular supplementary links.
  /api               - A Query parameter endpoint to get result of an exam given hallticket, date of birth, degree, examCode, eType, type and result.
  /api/calculate     - A Query parameter endpoint to get result of an exam given hallticket, date of birth, degree, examCode, eType, type and result with sgpa.
  /api/bulk/calculate - A Query parameter endpoint to get results of multiple halltickets given other parameters such as degree, examCode, eType, type, result and grade along with SGPA.
  /new/              - Returns all results links in unordered fashion
  /notifications     - Returns all the latest released notifications

Refer to the official documentation for detailed API Reference. Please click here

Response Schema

Below is a response object containing a 4 tuple schema.

  [
      {
        "subject_code": "15105",
        "subject_name": "ENGINEERING WORKSHOP",
        "grade_earned": "A+",
        "subject_credits": "2.5"
      }
]

And, this is a response object containing an 8 tuple schema.

[
    {
      "subject_code": "15408",
      "subject_name": "DATABASE MANAGEMENT SYSTEMS LAB",
      "grade_earned": "O",
      "subject_credits": "1.5",
      "internal_marks": "25",
      "external_marks": "73",
      "total_marks": "98"
    }
]

Note that depending on the servers, the number of tuples are determined.

Example

The endpoint below will only fetch results of regular exams of R18 students. To learn more about other endpoints with which you can get other results, please head over official documentation website

You could use Postman or any other service as you wish to test the RestAPI. Copy and paste this url in a new tab:

https://results-restapi.up.railway.app/185U1A0565/2001-04-03/1,1

and it shall trigger the endpoint with the below response.

[
  {
    "HTNO": "Hallticket Number",
    "NAME": "Student Name",
    "FATHER NAME": "Student's Father Name",
    "COLLEGE CODE": "Code"
  },
  [
    {
      "subject_code": "15105",
      "subject_name": "ENGINEERING WORKSHOP",
      "grade_earned": "A+",
      "subject_credits": "2.5"
    },
    {
      "subject_code": "15106",
      "subject_name": "ENGINEERING CHEMISTRY LAB",
      "grade_earned": "A+",
      "subject_credits": "1.5"
    },
    {
      "subject_code": "15107",
      "subject_name": "ENGLISH LANGUAGE AND COMMUNICATION SKILLS LAB",
      "grade_earned": "O",
      "subject_credits": "1"
    },
    {
      "subject_code": "15108",
      "subject_name": "BASIC ELECTRICAL ENGINEERING LAB",
      "grade_earned": "O",
      "subject_credits": "1"
    },
    {
      "subject_code": "151AA",
      "subject_name": "MATHEMATICS  I",
      "grade_earned": "B+",
      "subject_credits": "4"
    },
    {
      "subject_code": "151AF",
      "subject_name": "CHEMISTRY",
      "grade_earned": "C",
      "subject_credits": "4"
    },
    {
      "subject_code": "151AG",
      "subject_name": "BASIC ELECTRICAL ENGINEERING",
      "grade_earned": "A",
      "subject_credits": "3"
    },
    {
      "subject_code": "151AH",
      "subject_name": "ENGLISH",
      "grade_earned": "A",
      "subject_credits": "2"
    }
  ]
]

Notice
This project has been solely developed by me without any external influence by a person or an organization or university whatsoever, and if in the case of any upcoming contributions, they are also equally regarded as developers of this project. Contributions are always welcome! Feel free to pick up tasks from the project section and raise a PR. Please raise an issue regarding the task that you would like to pick up and link the PRs for the same.

I started this for you, only for you. Now, it serves for a greater purpose - for so many students ahead. You shall be remembered forever, in the reminiscence of this project.
For Precious, with Patience

Made with ❤️ by Hemanth.