POST
/api/v1/education
The Education API enables instant candidate profile validation (JAMB) and immediate generation of exam registration ePins and result checker tokens for JAMB (UTME & DE), WAEC Direct, NECO Token, and NABTEB.
🎓 Instant PIN & Serial Delivery
Structured PIN Payload: The cleartext exam PIN and optional Serial Number are returned directly in the JSON response under
data.pin and data.serial for immediate display or printouts.
POST
/api/v1/education-verify
Validate JAMB 10-digit candidate Profile Code before generating UTME or Direct Entry ePINs.
Request Parameters (JSON Body)
| Parameter | Type | Required | Description |
|---|---|---|---|
serviceID |
string | Required | Must be jamb. |
billersCode |
string | Required | 10-digit JAMB candidate Profile Code (e.g., 5091829401). |
type |
string | Required | utme (Unified Tertiary Matriculation Examination) or direct-entry. |
Sample Verification Response
{
"status": "success",
"message": "Profile ID verified successfully",
"data": {
"Customer_Name": "CHUKWUEMEKA GODSWILL NNAMDI",
"Profile_ID": "5091829401",
"Exam_Type": "UTME",
"Status": "Eligible"
}
}
GET
/api/v1/education-variations
Fetch current examination boards and PIN variations pricing.
Query Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
service_id |
string | Optional | waec, jamb, neco, nabteb. |
Purchase Education PIN Endpoint (POST)
| Parameter | Type | Required | Description & Example |
|---|---|---|---|
serviceID |
string | Required | Exam board: waec, jamb, neco, nabteb. |
amount |
numeric | Required | Amount in Naira (e.g. 3800). |
phone |
string | Required | Recipient's 11-digit mobile number for PIN delivery. |
billersCode |
string | Optional | Candidate Profile ID (for JAMB) or omitted (handled internally). |
variation_code |
string | Optional | ePin plan code: resolved automatically by default (waecdirect, neco, etc.). |
request_id |
string | Optional | Unique merchant client tracking reference. |
Integration Code Examples
curl -X POST "https://tente.com.ng/api/v1/education" \
-H "Authorization: Bearer YOUR_API_TOKEN" \
-H "Content-Type: application/json" \
-H "Accept: application/json" \
-d '{
"serviceID": "waec",
"amount": 3800,
"phone": "08031234567",
"request_id": "REQ_EDU_99120"
}'
Sample 200 OK Success Response (With PIN & Serial)
{
"status": "success",
"message": "WAEC PIN purchase successful.",
"data": {
"transaction_ref": "EDU2026083114300188AB",
"request_id": "REQ_EDU_99120",
"service_id": "waec",
"provider_name": "WAEC Result Checker PIN",
"pin": "098765432112",
"serial": "WRN123456790",
"cards": [
{
"Serial": "WRN123456790",
"Pin": "098765432112"
}
],
"tokens": [],
"purchased_code": "Serial No:WRN123456790, pin: 098765432112",
"variation_code": "waecdirect",
"amount": 3800.00,
"phone": "08031234567",
"type": "Education PIN Purchase",
"bonus_earned": 50.00,
"new_balance": 33451.50,
"status": "completed",
"created_at": "2026-08-31T14:30:01+01:00"
}
}
Error Responses
422 Invalid Profile ID
{
"status": "error",
"message": "Unable to verify candidate profile ID."
}
402 Insufficient Balance
{
"status": "error",
"message": "Insufficient wallet balance."
}