API DOCS
TKAWEN Sovereign API
Welcome to the official API reference for the Algeria Certification Portal. Our RESTful API enables accredited institutions to programmatically issue, sign, and verify digital credentials directly from their ERP systems (PROGRES, Moodle, etc.).
Base URL:
https://api.takawen.dz/v1/
BASH
# Check API Status curl https://api.takawen.dz/v1/status \ -H "Authorization: Bearer sk_live_..."
Issue a Certificate
Generates a new secure certificate. The response includes the unique uuid and the generated QR code URL.
| Parameter | Type | Description |
|---|---|---|
| student_name | string | Full legal name of the beneficiary. |
| course_id | string | Internal University course code. |
| metadata | object | JSON object for DOB, POB, Honors. |
JSON RESPONSE
{
"id": "crt_8923409823",
"uuid": "2026/DZ/UNIV-ANNABA/X9Y2",
"status": "active",
"qr_url": "https://takawen.dz/doc/...",
"created_at": 1767465000
}