Fill in the details, pick a template and format, then download your certificate.
/api/certificate.
Use GET to list templates, and POST to generate a certificate.
The POST endpoint streams the file back directly — no polling needed.
Filename is auto-set to Certificate_<Name>_<Template>-Ahm7xMakki.pdf.
Returns the full list of available certificate templates with their IDs.
{
"success": true,
"count": 8,
"templates": [
{ "id": 1, "name": "Modern" },
{ "id": 2, "name": "Dark Background" },
...
]
}
Generates a certificate and streams back the file binary directly. Takes 3–8 seconds.
| Field | Type | Status | Description |
|---|---|---|---|
| name | string | required | Recipient's full name |
| date | string | required | Date shown on the certificate |
| signature | string | required | Signing authority name |
| details | string | required | Body text / reason for the certificate |
| templateId | number | required | Template number 1–8 (from /api/certificate?action=templates) |
| format | string | optional | "pdf" (default), "jpg", or "png" |
| returnUrl | boolean | optional | If true, returns JSON with the render URL instead of the file stream |
Content-Type: application/pdf Content-Disposition: attachment; filename="Certificate_Muhammad_Makki_Modern-Ahm7xMakki.pdf" Content-Length: <bytes> X-Template-Name: Modern X-File-Name: Certificate_Muhammad_Makki_Modern-Ahm7xMakki.pdf
{
"success": true,
"renderUrl": "https://...",
"template": "Modern",
"format": "pdf",
"fields": { "name": "Muhammad Makki", "date": "01/01/2025", "signature": "Dr. Smith" }
}
| ID | Name |
|---|
/api/certificatejsonList all certificate templates with IDs and previews.
| Param | Type | Description | |
|---|---|---|---|
| action | string | required | "templates" |
/api/certificatejsonGenerate a finished certificate (PDF or PNG).
| Param | Type | Description | |
|---|---|---|---|
| name | string | required | Recipient full name. |
| templateId | string | required | ID from the templates list. |
| date | string | optional | Date to print. |
| signature | string | optional | Signatory name. |
| details | string | optional | Course/sub-title. |
| format | string | optional | "pdf" (default) or "png". |
| returnUrl | boolean | optional | true → JSON with hosted link. |
curl -X POST {ORIGIN}/api/certificate \
-H "Content-Type: application/json" \
-d '{"name":"Jane Doe","templateId":"1","details":"Web Dev","format":"pdf"}' \
--output cert.pdffetch() in code.