Certifier API
Credentials

Get credential design templates

Don't see what you need?

This API is still growing. If an endpoint, parameter, or filter you need isn't here yet — or you just have a question — tell us. We read every message and regularly add new capabilities based on real use cases from customers like you.

GET
/v1/credentials/{id}/designs

Use this endpoint to list the ordered design templates used by a credential and their available previews. Preview URLs are immutable and versioned by a digest (hash) derived from the design template's last update timestamp and the resolved values of all rendered credential attributes.

  • the design template’s last update timestamp, and
  • the resolved values of all rendered credential attributes

If you modify the design template (layout, fonts, colors, etc.) or any attribute value that appears in the design template, the digest changes and previous preview URLs will not automatically point to the new design template.

To get the newest preview after any change, fetch Get credential design templates again and use the newly returned preview URL.

The digest-versioned URL (…/.png or .pdf) is permanent for that exact version and is cache-friendly, making it safe to store or share.

Authorization

BearerAuth
AuthorizationBearer <token>

Provide your access token in the Authorization header with Bearer auth-scheme. You can view and manage your access tokens in the Certifier Dashboard.

In: header

Path Parameters

id*string

The unique ID of the credential

Header Parameters

Certifier-Version*string

API version header. Required for all requests.

Default"2022-10-26"

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

curl -X GET "https://example.com/v1/credentials/string/designs" \  -H "Certifier-Version: 2022-10-26"
[  {    "id": "string",    "name": "string",    "previews": [      {        "format": "png",        "url": "http://example.com"      }    ]  }]