Five endpoints
Create, retrieve, list, update, and revoke certificates. That's the entire API surface. No complexity, no bloat.
TRUE's REST API makes certificate automation simple. Five endpoints. Clear documentation. Blockchain verification built in. Integrate with your existing systems and start issuing in days, not months.
TRUE's Certificate API is designed for developers who need to automate credential issuance without wrestling with complexity.
Create, retrieve, list, update, and revoke certificates. That's the entire API surface. No complexity, no bloat.
Standard HTTP methods, JSON payloads, predictable responses. If you've integrated any modern API, you know how to use TRUE.
Every certificate is automatically secured on blockchain. No additional config. No separate calls. Verification in every response.
Issue your first certificate with a single API call.
curl -X POST https://api.trueoriginal.com/v1/certificates \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"template_id": "tmpl_abc123",
"recipient": {
"name": "Maria Andersson",
"email": "maria@example.com"
},
"fields": {
"course_name": "Advanced Project Management",
"completion_date": "2026-03-03",
"credential_id": "PM-2026-0042"
}
}'The certificate is created, blockchain-secured, and sent via email. All from one API call.
API keys are generated in your TRUE dashboard. Create separate keys for development, staging, and production.
Every response includes blockchain verification data. The certificate is immediately verifiable. No waiting, no separate verification calls.
Verification URLs use your custom domain, keeping your brand front and center.
{
"id": "cert_xyz789",
"status": "issued",
"recipient": {
"name": "Maria Andersson",
"email": "maria@example.com"
},
"verification_url": "https://verify.yourorg.com/cert_xyz789",
"blockchain": {
"network": "polygon",
"transaction_hash": "0x1234...abcd",
"confirmed": true
},
"created_at": "2026-03-03T09:15:00Z"
}Everything you need to automate certificate issuance.
| Method | Endpoint | Description |
|---|---|---|
| POST | /v1/certificates |
Create and issue a new certificate |
| GET | /v1/certificates/{id} |
Retrieve certificate data and verification status |
| GET | /v1/certificates |
List all issued certificates with filters |
| PUT | /v1/certificates/{id} |
Update certificate status or metadata |
| DELETE | /v1/certificates/{id} |
Revoke a certificate (blockchain record updated) |
TRUE connects to the platforms your organization already uses.
Trigger issuance when opportunities close or certifications are earned
Issue certificates automatically on course completion
Automate credentials based on quiz scores or completion
Connect completion events to seamless credentialing
Issuing hundreds or thousands of certificates? Use the batch endpoint for efficient bulk issuance.
Upload recipient arrays, get a batch job ID, and track progress. For teams without dev resources, CSV upload in the dashboard works too.
curl -X POST .../v1/certificates/batch \
-H "Authorization: Bearer YOUR_API_KEY" \
-d '{
"template_id": "tmpl_abc123",
"recipients": [
{"name": "Anna", "email": "anna@..."},
{"name": "Erik", "email": "erik@..."},
...
]
}'{
"event": "certificate.verified",
"certificate_id": "cert_xyz789",
"timestamp": "2026-03-03T10:30:00Z",
"data": {
"viewer_location": "Stockholm, SE",
"referrer": "linkedin.com"
}
}Get notified when certificates are issued, viewed, shared, or verified. Configure multiple endpoints filtered by event type.
Events: certificate.issued, certificate.viewed, certificate.shared, certificate.verified, certificate.revoked
Student system marks graduates → webhook triggers issuance → graduates receive blockchain diplomas instantly. Share on LinkedIn the same day.
LMS completion triggers certificate with expiration date. HR receives webhook confirmation. Analytics track auditor verifications.
Platform detects completion → API issues credential → learner shares → every share drives enrollments back to your platform.
| Standard | 60 req/min, batch 100 |
| Professional | 300 req/min, batch 500 |
| Enterprise | Custom limits |
| Encryption | TLS 1.3 required |
| Auth | API keys, scoped by env |
| Enterprise | IP allowlisting available |
| Audit | Full activity logging |
| SLA | 99.9% uptime (enterprise) |
| Webhooks | Automatic retry on failure |
| Status | status.trueoriginal.com |
| 200, 201 | Success / Created |
| 400 | Validation error |
| 401 | Invalid API key |
| 429 | Rate limit exceeded |
Five endpoints. Blockchain included. Integration in days. Get your API keys and start building.
Learn more about certificate workflows and automation.