Exam API

Generate result checker PINs for WAEC, NECO, NABTEB, and JAMB.

List Available Exams

Retrieve a catalog of supported exams and result checkers.

GET https://suruleredatacom.com.ng/api/get-exam

curl -X GET "https://suruleredatacom.com.ng/api/get-exam" \
      -H "Authorization: Token YOUR_API_KEY" \
      -H "Content-Type: application/json"

<?php
    $url = 'https://suruleredatacom.com.ng/api/get-exam';
    $ch = curl_init($url);
    curl_setopt_array($ch, [
        CURLOPT_RETURNTRANSFER => true,
        CURLOPT_HTTPHEADER => [
            'Authorization: Token YOUR_API_KEY',
            'Content-Type: application/json',
        ]
    ]);
    $response = curl_exec($ch);
    curl_close($ch);
    print_r(json_decode($response, true));
    ?>

const response = await fetch('https://suruleredatacom.com.ng/api/get-exam', {
      headers: {
        'Authorization': 'Bearer YOUR_API_KEY',
        'Content-Type': 'application/json'
      }
    });
    const data = await response.json();
    console.log(data);

import requests

    url = "https://suruleredatacom.com.ng/api/get-exam"
    headers = {
        "Authorization": "Bearer YOUR_API_KEY",
        "Content-Type": "application/json"
    }
    response = requests.get(url, headers=headers)
    print(response.json())

Response

✓ 200 OK

{
[
  { "id": "1", "name": "WAEC",   "price": "3500" },
  { "id": "2", "name": "NECO",   "price": "2250" },
  { "id": "3", "name": "NABTEB", "price": "1000" },
  { "id": "4", "name": "JAMB",   "price": "1050" }
]
    }

Purchase Exam PIN

Buy an exam result checker PIN or registration e-PIN.

POST https://suruleredatacom.com.ng/api/exam

Request Body

Parameter	Type	Required	Description
exam	Integer	Yes	ID of the exam from the `/exams` endpoint.
quantity	Integer	Optional	Number of PINs to purchase. Defaults to `1`.
request-id	String	Optional	Idempotency key.

curl -X POST "https://suruleredatacom.com.ng/api/exam" \
      -H "Authorization: Token YOUR_API_KEY" \
      -H "Content-Type: application/json" \
      -d '{
        "exam": 1,
        "quantity": 1,
        "request-id": "exam_123"
      }'

<?php
    $url = 'https://suruleredatacom.com.ng/api/exam';
    $payload = [
        'exam' => 1,
        'quantity' => 1,
        'request-id' => 'API_' . uniqid()
    ];
    $ch = curl_init($url);
    curl_setopt_array($ch, [
        CURLOPT_RETURNTRANSFER => true,
        CURLOPT_POST => true,
        CURLOPT_POSTFIELDS => json_encode($payload),
        CURLOPT_HTTPHEADER => [
            'Authorization: Token YOUR_API_KEY',
            'Content-Type: application/json',
        ]
    ]);
    $response = curl_exec($ch);
    curl_close($ch);
    print_r(json_decode($response, true));
    ?>

const response = await fetch('https://suruleredatacom.com.ng/api/exam', {
      method: 'POST',
      headers: {
        'Authorization': 'Bearer YOUR_API_KEY',
        'Content-Type': 'application/json'
      },
      body: JSON.stringify({
        exam: 1,
        quantity: 1,
        'request-id': 'exam_123'
      })
    });
    const data = await response.json();
    console.log(data);

import requests

    url = "https://suruleredatacom.com.ng/api/exam"
    headers = {
        "Authorization": "Bearer YOUR_API_KEY",
        "Content-Type": "application/json"
    }
    payload = {
        "exam": 1,
        "quantity": 1,
        "request-id": "exam_123"
    }
    response = requests.post(url, json=payload, headers=headers)
    print(response.json())

Responses

✓ 200 OK

{
      "status": "success",
      "Status": "successful",
      "message": "Exam PIN Purchase Successful.",
      "response": "WAEC Result Checker PIN Generated",
      "api_response": "WAEC Result Checker PIN Generated",
      "request-id": "API_66bbd45c67b7b",
      "service": "exam",
      "amount": "3500",
      "old_balance": 5000,
      "new_balance": 1500,
      "token": "246813579012",
      "pins": [
        {
          "pin": "246813579012",
          "serial": "W12345678"
        }
      ]
    }

← Previous

Electricity API

Webhooks