VerifycateDeveloper Docs

Get a public certificate

GET/api/v1/certificates/{publicID}

Fetch a publicly verifiable issued certificate by public id

Returns the public view of an issued certificate. No authentication. Pending issues are not visible (404).

Also available: the signed Open Badge / Verifiable Credential document at GET /api/v1/certificates/{publicID}/credential.json (Content-Type: application/vc+ld+json).

Authorization

None. Do not send an API key.

Path parameters

publicID*string

Public id of the issued certificate

Example: vc_pub_ada01

Query parameters

workspace?string

Optional. When set, returns 404 unless the certificate belongs to this workspace slug

Example: acme

Response schema

public_id*string
Public verification id
status*string
`active` or `expired`
recipient_name*string
Recipient display name
issued_at?datetime
Issued timestamp
expires_at?datetime
Expiry timestamp when set
attributes*object
Recipient attribute values
attribute_definitions*object[]
Attribute defs (`key`, `label`)
template*object
Rendered template canvas payload
png_url?string
Signed PNG download URL when available
pdf_url?string
Signed PDF download URL when available
template_version?integer
Template version baked into this credential
correction_form_url?string
Public correction form URL when corrections are enabled
*CertificateRef
Public certificate metadata
id*UUID
Certificate id
name*string
Certificate name
description?string
Certificate description
certificate_type?string
Certificate type
level?string
Level
duration?string
Duration
learn_more_url?string
Learn-more URL
earning_criteria?string[]
Earning criteria
skills?object[]
Linked skills (`id`, `name`)
*Workspace
Issuer branding
slug*string
Workspace slug
name*string
Workspace display name
logo_url?string
Logo URL
avatar_url?string
Avatar URL
website?string
Website URL
brand_accent_color?string
Accent color
brand_text_color?string
Text color
brand_background_color?string
Background color
hide_verifycate_branding*boolean
Whether Verifycate branding is hidden on the portal
portal_origin?string
Portal origin when customized