Skip to main content
The Digital Certificate Confirmation API allows institutions to integrate directly with the Digital Certificate platform. You can confirm the authenticity of WAEC certificates in bulk, retrieve digital previews of confirmed certificates, and query the full history of confirmations on your account — all over HTTPS using JSON and an API Secret key.

​
What you can do

  • Confirm certificates — Submit one or more certificates by candidate number, country, and exam year. The platform looks up each record and returns the candidate and result details.
  • Preview confirmed certificates — Fetch a digital copy of any confirmed certificate by its confirmation ID.
  • View confirmation history — Retrieve a paginated, filterable log of every confirmation made on your Institution account.

​
Who this is for

The API is designed for institutions — schools, employers, universities, and any organisation that needs to programmatically confirm the authenticity of WAEC certificates at scale.
To use this API you must have created an Institution account on the Digital Certificate platform and generated an API Secret key from your profile.

​
Get started

Quick start

Make your first confirmation request in minutes — get your API key and confirm a certificate with a working example.

Authentication

Learn how to generate and use your API Secret key.

Certificates

Understand how certificate confirmation records are structured and what data is returned.

API reference

Explore every endpoint with full request parameters, response schemas, and examples.

​
Key features

​
Bulk certificate confirmation

Submit up to many certificates in a single request. Each entry in the response is independent — a not-found result for one candidate does not affect the others. Check each entry’s result field individually.
A 200 OK response is always returned for the request as a whole. Per-entry outcomes are indicated by the result field — null means no match was found for that candidate.

​
Full candidate and result data

A confirmed certificate returns the candidate’s full name, date of birth, gender, examination centre, certificate number, and a complete list of subjects and grades — ready to use directly in your application.

​
Confirmation history with filtering

Query your account’s full confirmation history and filter by examination year, candidate number, or date range. Results are paginated and include candidate details and timestamps for every confirmation made.