Certifylize API

Automate certificate issuance and integrate Certifylize via a REST API. Ideal for ERP, MES, and QA systems that want to create, reference, and link certificates directly from existing workflows.

Note

This page is a technical overview. Endpoints, fields, and responses may vary by plan/setup. Certificate content and validity claims remain the issuer’s responsibility.

Authentication

The external API is secured via an API key. Send it in the x-api-key header and treat it like a password (never ship it to the client), rotate when needed, and grant only the required permissions.

Example header

x-api-key: YOUR_API_KEY_HERE

Issue a certificate via API

This endpoint creates a certificate. The response returns the certificate ID, a public verify URL, and a SHA-256 checksum as a technical reference for later consistency checks (depending on setup).

🔍 Request: Issue certificate

POST /api/external/certificates/issue
Content-Type: application/json
x-api-key: YOUR_API_KEY_HERE

{
  "typeId": 1,
  "productId": "PART-12345",
  "serialNumber": "SN-2025-0001",
  "holderEmail": "customer@example.com",
  "validUntil": "2027-12-31",
  "metadata": {
    "batch": "B-2025-01",
    "plant": "Plant 1",
    "line": "Line A",
    "orderNo": "PO-998877"
  }
}

✅ Response: Certificate created

HTTP/1.1 201 Created
Content-Type: application/json

{
  "ok": true,
  "id": "cmicbyl6q0007rz5q6rxuofyq",
  "verifyUrl": "https://certifylize.com/en/verify/cmicbyl6q0007rz5q6rxuofyq",
  "dataHash": "7d9c6f0b0e1c4d..."
}

🌐 Base URL of the public API

https://certifylize.com