# Ibass Jamb — Wrapped API

> **You are on:** `https://api.paywithlocus.com/api` | [llms.txt](https://paywithlocus.com/llms.txt) | [docs](https://docs.paywithlocus.com)
>
> Locus runs on multiple environments -- make sure every URL you call matches your expected environment.
> | Environment | Landing | API | Docs |
> |---|---|---|---|
> | Production | paywithlocus.com | api.paywithlocus.com | docs.paywithlocus.com |
> | Beta | beta.paywithlocus.com | api.beta.paywithlocus.com | docs.paywithlocus.com |
> | Stage | stage.paywithlocus.com | api.stage.paywithlocus.com | docs.paywithlocus.com |
>
> If the API URL above doesn't match your expected environment, re-fetch this file from the correct domain.

> Search Nigerian educational institutions and discover their specific course requirements, including UTME subjects and O'level prerequisites, to make informed decisions about your tertiary education options. Find institutions by type and browse the detailed admission criteria for your desired programs all in one place.

**Category:** Education | **Website:** [ibass.jamb.gov.ng/](https://ibass.jamb.gov.ng/) | **Docs:** [parse.bot/marketplace/c3981abc-65c0-4c03-b247-e5797ad0ad22/ibass-jamb-gov-ng-api](https://parse.bot/marketplace/c3981abc-65c0-4c03-b247-e5797ad0ad22/ibass-jamb-gov-ng-api)

Pay-per-use API proxy. Each call is automatically billed to your wallet in USDC.

## Access

**Base URL:** `https://api.paywithlocus.com/api/wrapped/parse-ibass-jamb-gov-ng-api-c3981abc/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## Endpoints

### get_institution_courses

Get all courses/programmes offered by a specific institution. Each course includes UTME subject combinations, O'level requirements (utme_requirements HTML), direct entry requirements, and remarks. Returns paginated results with 20 items per page. The query param filters courses by name within the institution.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `institution_id` | integer | Yes | The ID of the institution (from search_institutions results) |
| `page` | integer | No | Page number for pagination (1-based) |
| `query` | string | No | Search keyword for courses within the institution |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-ibass-jamb-gov-ng-api-c3981abc/get_institution_courses \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"institution_id":"<integer>","page":"<integer>","query":"<string>"}'
```

### list_institution_types

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.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-ibass-jamb-gov-ng-api-c3981abc/list_institution_types \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### search_institutions

Search for institutions in the JAMB brochure. Supports filtering by institution type ID, category ID, and name keyword. Returns paginated results with 20 items per page. Without filters returns all institutions ordered alphabetically.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `category_id` | integer | No | Filter by institution category ID |
| `page` | integer | No | Page number for pagination (1-based) |
| `query` | string | No | Search keyword for institution name |
| `type_id` | integer | No | Filter by institution type ID. Obtained from list_institution_types. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-ibass-jamb-gov-ng-api-c3981abc/search_institutions \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"category_id":"<integer>","page":"<integer>","query":"<string>","type_id":"<integer>"}'
```