Public API · No auth required
Certificate Verification API
Verify any CertPath certificate from your own platform, application, or website. Every certificate issued through CertPath is instantly queryable — no signup, no API key.
Endpoint
GET
https://certpath-gold.vercel.app/api/verifyQuery parameters
Supply one of the two parameters below — you don't need both.
| Parameter | Type | Required | Description |
|---|---|---|---|
code | string | One of | The validation code printed on the certificate (e.g. CERTPATH-A1B2-C3D4) |
url | string | One of | The full certificate profile URL (e.g. https://certpath-gold.vercel.app/certificate/course/name?code=…). The code is extracted automatically. |
Response fields
| Field | Type | Description |
|---|---|---|
valid | boolean | true if the certificate exists and has not been revoked |
code | string | The normalised certificate code |
recipientName | string | Full name on the certificate (only when valid) |
courseTitle | string | Course the certificate was issued for (only when valid) |
courseSlug | string | URL-friendly course identifier (only when valid) |
issuedAt | ISO 8601 | When the certificate was originally issued (only when valid) |
verifiedAt | ISO 8601 | Timestamp of this verification request (only when valid) |
profileUrl | string | Canonical public URL for the certificate page (only when valid) |
error | string | Human-readable reason (only when valid is false) |
Example responses
✓ Valid certificate
{
"valid": true,
"code": "CERTPATH-A1B2-C3D4",
"recipientName": "Jane Doe",
"courseTitle": "Medical Transcriptionist",
"courseSlug": "medical-transcriptionist",
"issuedAt": "2026-07-19T10:30:00.000Z",
"verifiedAt": "2026-07-19T14:05:22.000Z",
"profileUrl": "https://certpath-gold.vercel.app/certificate/medical-transcriptionist/jane-doe?code=CERTPATH-A1B2-C3D4"
}✗ Invalid certificate
{
"valid": false,
"code": "CERTPATH-XXXX-XXXX",
"error": "No certificate found with that code."
}Code examples
# Option 1 — by certificate code
curl "https://certpath-gold.vercel.app/api/verify?code=CERTPATH-A1B2-C3D4"
# Option 2 — by certificate profile URL
curl "https://certpath-gold.vercel.app/api/verify?url=https%3A%2F%2Fcertpath-gold.vercel.app%2Fcertificate%2Fmedical-transcriptionist%2Fjane-doe%3Fcode%3DCERTPATH-A1B2-C3D4" Notes
- CORS: All origins are allowed — call this endpoint directly from browser JavaScript.
- Authentication: None required. The API is intentionally public — certificates are designed to be shareable credentials.
- Rate limiting: Please keep requests reasonable. Batch lookups aren't supported; query one certificate code per request.
- Two ways to verify: pass
?code=CERTPATH-XXXXor the full?url=https://certpath-gold.vercel.app/certificate/…— the code is extracted from the URL automatically. - Codes are case-insensitive:
certpath-a1b2-c3d4andCERTPATH-A1B2-C3D4both work.