boslive.icai.org APIboslive.icai.org ↗
Access ICAI Board of Studies announcements, LVC/LVRC schedules, and study materials via 9 structured endpoints. Retrieve PDFs, paper lists, and exam updates.
No input parameters required.
curl -X GET 'https://api.parse.bot/scraper/a203862a-1b8c-437e-a538-efcb4c4fb249/get_bos_announcements' \ -H 'X-API-Key: $PARSE_API_KEY'
Get the list of Board of Studies announcements from the ICAI knowledge portal. Returns announcement titles, dates, URLs, and IDs.
No input parameters required.
{
"type": "object",
"fields": {
"announcements": "array of announcement objects each containing id, title, date, and url"
},
"sample": {
"data": {
"announcements": [
{
"id": "583",
"url": "https://boslive.icai.org/announcement_details.php?id=583",
"date": "21 April, 2026, Tuesday",
"title": "BOS STUDY MATERIAL APPLICABLE FOR FOUNDATION AND INTERMEDIATE COURSE, SEPTEMBER 2026 EXAMINATION"
}
]
},
"status": "success"
}
}About the boslive.icai.org API
This API exposes 9 endpoints covering the ICAI Board of Studies Knowledge Portal at boslive.icai.org, returning structured data for announcements, examination updates, Live Virtual Class schedules, and study materials. The get_lvc_schedule endpoint, for example, returns a full class timetable with paper names, faculty, topics, and session times for Foundation, Intermediate, and Final courses. All major content sections of the portal are represented.
Announcements and Examination Updates
Two listing endpoints — get_bos_announcements and get_examination_announcements — return arrays of announcement objects, each carrying an id, title, date, and url. To fetch the body of any specific announcement, pass its ann_id to get_announcement_details, which returns the publication date, full title, and a pdf_url field pointing to the embedded PDF document (or null if none is present). For pages that carry multiple documents, get_all_pdfs accepts a relative page_url (e.g. announcement_details.php?id=583) and returns every PDF link and iframe-embedded document found on that page, with title and URL for each.
LVC and LVRC Schedules
get_lvc_schedule and get_lvrc_schedule both accept an optional course parameter — foundation, intermediate, or final. Each returns a schedule array whose entries include Date, Name of the Paper, Name of the Topic, Name of the Faculty, Session, and associated links. Omitting the course parameter returns the default view from the portal. LVRC entries follow the same structure but cover revisionary class sessions rather than standard lectures.
Study Materials
Study material access is a three-step chain. get_study_material_courses returns all available courses with title, course_code, and url. Passing a course_code to get_study_material_languages yields the language options (typically English and Hindi) for that course. Finally, get_study_material_papers takes both a language and course_code and returns an array of paper objects, each with title, course, language, year, and url — giving direct access to individual study material documents.
- Monitor new ICAI BOS announcements and push alerts when
get_bos_announcementsreturns previously unseen IDs. - Build a class reminder tool that reads
get_lvc_scheduleand notifies students of upcoming sessions by faculty and topic. - Aggregate examination announcements from
get_examination_announcementsinto an exam-prep dashboard. - Extract all PDFs from a specific announcement page using
get_all_pdfsfor offline archival or indexing. - List available CA Foundation, Intermediate, and Final study material papers by year using
get_study_material_papers. - Provide Hindi-language study material discovery by filtering
get_study_material_languagesresults and fetching relevant papers. - Track LVRC revisionary class schedules per course and compare faculty assignments across sessions.
| Tier | Price | Credits/month | Rate limit |
|---|---|---|---|
| Free | $0/mo | 100 | 5 req/min |
| Hobby | $30/mo | 1,000 | 20 req/min |
| Developer | $100/mo | 5,000 | 250 req/min |
One credit = one API call regardless of which marketplace API you call. Exceeding the rate limit returns a 429 response. Authenticate with the X-API-Key header.
Does ICAI provide an official developer API for the BOS Knowledge Portal?+
What does `get_announcement_details` return, and how is it different from the listing endpoints?+
get_announcement_details takes a single ann_id and returns the full record for that announcement: id, date, title, and pdf_url. The listing endpoints (get_bos_announcements, get_examination_announcements) return arrays of lightweight objects with those same fields but do not guarantee pdf_url — that field is only resolved in the detail call. If the announcement has no embedded PDF, pdf_url is null.Does the API cover archived or past LVC/LVRC schedules, or only the current schedule?+
get_lvc_schedule and get_lvrc_schedule endpoints return the schedule currently published on the portal, which reflects the active or upcoming timetable. Historical archived schedules are not separately exposed. You can fork this API on Parse and revise it to add an endpoint targeting any archived schedule pages the portal makes available.Can I retrieve study material content beyond paper listings — such as chapter-level PDFs or module breakdowns?+
get_study_material_papers endpoint returns paper-level records with title, course, language, year, and url. Chapter or module breakdowns within a paper are not currently returned. You can pass a paper's URL to get_all_pdfs to extract embedded documents from that page, or fork the API on Parse and revise it to add deeper navigation into individual paper pages.Are LVC and LVRC schedules available for all three course levels?+
get_lvc_schedule and get_lvrc_schedule accept foundation, intermediate, or final as the course parameter. If no course is specified, the endpoint returns the portal's default view, which may not include all three levels in a single response. Querying each course code separately gives the complete picture.