REST API Documentation

Base URL: https://caprounds.mahaedunow.com/api/v1 | Rate limit: 120 requests/minute

All endpoints return JSON. No authentication required for public endpoints. Rate limit: 120 requests per minute per IP.

GET /api/v1/datasets List all datasets

Returns all datasets (CAP rounds) with their status and stats.

Parameters: None

GET https://caprounds.mahaedunow.com/api/v1/datasets

Response:
[
  {
    "id": 1,
    "round_name": "FE2026 CAP Round III",
    "academic_year": "2026-27",
    "published_date": "2026-08-19",
    "status": "published",
    "total_institutes": 376,
    "total_courses": 2247,
    "total_vacancy_rows": 4012
  }
]

GET /api/v1/search Search vacancies

Search courses and vacancies in the latest published dataset.

Parameter	Type	Description
`q`	string	Search by course name or institute name
`district`	string	Filter by district (e.g. `Pune`)
`city`	string	Filter by city
`has_vacancy`	boolean (1/0)	Only return courses with > 0 CAP vacancies
`limit`	integer (max 500)	Results per page (default: 100)

GET https://caprounds.mahaedunow.com/api/v1/search?q=Computer&district=Pune&has_vacancy=1

Response:
{
  "dataset": {"id": 1, "round_name": "FE2026 CAP Round III"},
  "data": [
    {
      "id": 145,
      "choice_code": "1100163110",
      "course_name": "Computer Engineering",
      "total_cap_vacancies": 12,
      "institute": {
        "inst_code": "11001",
        "inst_name": "Government College of Engineering Pune",
        "district": "Pune"
      }
    },
    ...
  ]
}

GET /api/v1/institutes List all institutes

Returns all institutes in the latest published dataset.

GET https://caprounds.mahaedunow.com/api/v1/institutes

Response:
{
  "data": [
    {
      "id": 1,
      "inst_code": "11001",
      "inst_name": "Government College of Engineering Pune",
      "inst_type": "Government Autonomous",
      "district": "Pune",
      "city": "Pune",
      "is_government": true,
      "is_autonomous": true,
      "is_minority": false
    },
    ...
  ]
}

GET /api/v1/course/{choice_code} Course detail with all vacancies

Returns full vacancy breakdown for a specific course by choice code (10 digits).

GET https://caprounds.mahaedunow.com/api/v1/course/1100163110

Response:
{
  "id": 145,
  "choice_code": "1100163110",
  "course_name": "Computer Engineering",
  "total_cap_vacancies": 12,
  "ews_seats": 2,
  "tfw_seats": 0,
  "institute": { ... },
  "vacancies": [
    {
      "seat_level": "state_level",
      "open_g": 4, "open_l": 1,
      "sc_g": 1, "sc_l": 0,
      "obc_g": 2, "obc_l": 1,
      "sebc_g": 1, "sebc_l": 0,
      "total_g_l": 12
    }
  ],
  "special_vacancy": {
    "pwd_total": 1,
    "def_total": 0
  }
}

Error Responses

HTTP Code	Meaning
`404`	Resource not found (course code doesn't exist)
`429`	Too Many Requests — you've exceeded 120 requests/minute
`500`	Server error — contact admin

Data sourced from Maharashtra State CET Cell. For reference only. — Back to Search