Gov APIibass.jamb.gov.ng ↗
Access JAMB's IBASS database: search ~1600 Nigerian institutions, retrieve UTME subject combinations, O'level requirements, and course details via 4 endpoints.
What is the Gov API?
The JAMB IBASS API exposes 4 endpoints covering Nigeria's Integrated Brochure and Syllabus System, giving programmatic access to roughly 1,600 institutions and their admission requirements. Use search_institutions to filter by institution type, category, or name keyword, and get_institution_courses to retrieve per-course UTME subject combinations, O'level prerequisites, direct entry requirements, and official remarks — all drawn from the JAMB brochure.
No input parameters required.
curl -X GET 'https://api.parse.bot/scraper/ef153e5c-4464-4a87-802d-623cc602c762/list_institution_types' \ -H 'X-API-Key: $PARSE_API_KEY'
Returns all available institution types (NCE, ND, DEGREE AWARDING INSTITUTIONS). Each type carries a regulator_type and a numeric id usable as a filter in search_institutions. The list is small and stable — cache client-side.
No input parameters required.
{
"type": "object",
"fields": {
"institution_types": "array of institution type objects, each with id, title, and regulator_type"
},
"sample": {
"data": {
"institution_types": [
{
"id": 1,
"title": "NCE",
"regulator_type": "NCCE"
},
{
"id": 2,
"title": "ND",
"regulator_type": "NBTE"
},
{
"id": 4,
"title": "DEGREE AWARDING INSTITUTIONS",
"regulator_type": "NUC"
}
]
},
"status": "success"
}
}About the Gov API
Institution Discovery
The list_institution_types endpoint returns a short, stable list of institution categories — such as NCE, ND, and DEGREE AWARDING INSTITUTIONS — each with a numeric id, a title, and a regulator_type. Those IDs feed directly into the type_id filter on search_institutions and get_all_institutions. The search_institutions endpoint returns paginated results (20 per page) with fields including title, state, ownership, abbreviation, caps_code, accreditation, inst_type, and inst_category. You can narrow results by query (name keyword), type_id, or category_id.
Bulk Institution Retrieval
get_all_institutions iterates through all pages internally and returns a flat list of every institution in the JAMB database. The response includes a total count, a pages_fetched integer, and an is_complete boolean so callers can detect partial fetches. Supplying type_id reduces the result set — useful when you only need, say, degree-awarding institutions rather than all ~1,600 entries.
Course and Programme Requirements
get_institution_courses accepts a required institution_id (from search results) plus an optional query to filter course names within that institution. Each course object in the response carries title, code, department, status, subjects (UTME subject combination), utme_requirements (O'level requirements as HTML), de_requirements (direct entry criteria), remarks, and caps_code. This is the primary endpoint for admission-requirement lookups — each field maps directly to what JAMB publishes in the official brochure.
The Gov API is a managed, monitored endpoint for ibass.jamb.gov.ng — not a raw scraper you maintain. Every endpoint is automatically health-checked on a schedule, and when ibass.jamb.gov.ng changes and a check fails, the API is automatically queued for repair and re-verified. It is built to keep working as the site underneath it changes.
This isn't an official ibass.jamb.gov.ng API — it's an independent, maintained REST wrapper over public data. Where the source has no official API (or only a limited one), Parse gives you a stable contract over a source that never promised one, and keeps it current. Need a new endpoint or field? You can revise it yourself in plain English and the agent rebuilds it against the live site in minutes — contributing the change back to the shared API is free.
Will this API break when the source site changes?+
Is this an official API from the source site?+
Can I fix or extend this API myself if I need a new endpoint or field?+
What happens if I call an endpoint that has an issue?+
- Build a course-finder app that shows Nigerian students valid UTME subject combinations for any programme at any JAMB-listed institution
- Aggregate O'level requirements across institutions to compare admission criteria for the same course at multiple universities
- Populate a searchable directory of all ~1,600 JAMB institutions with state, ownership type, and accreditation status
- Filter institutions by type (NCE, ND, degree-awarding) to generate type-specific prospectus data
- Cross-reference
caps_codevalues from IBASS with JAMB registration data in downstream systems - Alert students when direct entry requirements (
de_requirements) differ from UTME requirements for their chosen course - Generate institution-level summaries showing total available programmes by department or faculty
| Tier | Price | Credits/month | Rate limit |
|---|---|---|---|
| Free | $0/mo | 200 | 5 req/min |
| Hobby | $30/mo | 1,000 | 20 req/min |
| Developer | $100/mo | 5,000 | 100 req/min |
| Team | $300/mo | 20,000 | 300 req/min |
| Company | $1,000/mo | 100,000 | 500 req/min |
Each endpoint has a fixed posted price per successful call — most fall between 1 and 10 credits — shown on this API's page before you run it. Exceeding the rate limit returns a 429 response. Authenticate with the X-API-Key header.
Does JAMB provide an official public developer API for IBASS?+
What does get_institution_courses actually return for each course?+
title, code, department, status, caps_code, subjects (the required UTME subject combination), utme_requirements (O'level requirements in HTML), de_requirements (direct entry criteria), and remarks. You can filter results within an institution using the query parameter, and paginate with the page parameter — results are 20 per page.How does pagination work, and what happens if get_all_institutions can't fetch every page?+
total, per_page, last_page, and current_page in the response. get_all_institutions handles pagination internally and signals partial results via the is_complete boolean — if it is false, pages_fetched tells you how many pages were retrieved before the fetch stopped.Does the API expose syllabus content — topics and subject outlines — in addition to admission requirements?+
Can I filter courses across all institutions at once, rather than querying one institution at a time?+
get_institution_courses endpoint requires an institution_id, so course queries are scoped to a single institution per call. Cross-institution course search is not exposed. You can fork this API on Parse and revise it to add a global course search endpoint.