Skip to main content
The Digital Certificate Confirmation API allows institutions to integrate directly with the Digital Certificate platform to confirm WAEC certificates and retrieve confirmation records. All requests and responses use JSON.

​
Environments

The API has two environments. Use the sandbox for development and testing — it is fully isolated from production data.
EnvironmentBase URL
Productionhttps://api.waec.org/api/v1/external
Sandboxhttps://api.sandbox.smartdocument.org/api/v1/external
Each environment requires its own API Secret key. See Environments for details on switching between them.

​
Authentication

Every endpoint requires your Institution API Secret key passed in the X-DigiCert-Secret request header: 
X-DigiCert-Secret: <your_api_secret_key>
You can generate an API Secret key from your Institution account profile on the platform.

​
Request Format

For POST requests, set Content-Type: application/json and include a JSON body. GET requests pass all parameters as query string arguments or path segments.

​
Response Format

Every response is a JSON object with a consistent envelope structure. Successful response: 
{
  "success": true,
  "data": {}
}
Error response: 
{
  "success": false,
  "error": {
    "code": "UNAUTHORIZED",
    "message": "Invalid or missing API secret key."
  }
}
The data field contains the primary payload. On errors, the error.code field contains a machine-readable string for programmatic error handling. See Errors for the full list of error codes.

​
Available Endpoints

MethodEndpointDescription
POST/certificate/confirmConfirm one or more certificates
GET/certificate/confirmation/preview/{id}Preview a confirmed certificate
GET/certificate/confirmation-historyView confirmation history