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

GEThttps://certpath-gold.vercel.app/api/verify

Query parameters

Supply one of the two parameters below — you don't need both.

ParameterTypeRequiredDescription
codestringOne ofThe validation code printed on the certificate (e.g. CERTPATH-A1B2-C3D4)
urlstringOne ofThe full certificate profile URL (e.g. https://certpath-gold.vercel.app/certificate/course/name?code=…). The code is extracted automatically.

Response fields

FieldTypeDescription
validbooleantrue if the certificate exists and has not been revoked
codestringThe normalised certificate code
recipientNamestringFull name on the certificate (only when valid)
courseTitlestringCourse the certificate was issued for (only when valid)
courseSlugstringURL-friendly course identifier (only when valid)
issuedAtISO 8601When the certificate was originally issued (only when valid)
verifiedAtISO 8601Timestamp of this verification request (only when valid)
profileUrlstringCanonical public URL for the certificate page (only when valid)
errorstringHuman-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-XXXX or the full ?url=https://certpath-gold.vercel.app/certificate/… — the code is extracted from the URL automatically.
  • Codes are case-insensitive: certpath-a1b2-c3d4 and CERTPATH-A1B2-C3D4 both work.