---
title: "Get credential design templates"
method: GET
path: "/v1/credentials/{id}/designs"
tags: ["Credentials"]
---

# Get credential design templates

`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.

  <Callout title="Important considerations" type="warn">
  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

  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.
  </Callout>

## Path parameters

- `id` string, required — The unique ID of the credential

## Headers

- `Certifier-Version` string, required — API version header. Required for all requests.

## Response `200`

List of design templates associated with the credential

- CredentialDesign[]
  - `id` string, required — Unique identifier for the design template
  - `name` string, required — Name of the design template
  - `previews` CredentialDesignPreview[], required — Available preview formats and URLs for the design template
    - `format` 'png' | 'pdf', required — The format of the preview
    - `url` string, uri, required — The direct URL to the preview

## Other responses

- `400` — Bad Request - Missing version, invalid version, invalid JSON, or validation error
- `401` — Unauthorized - Invalid or missing authentication token
- `404` — Not Found - Resource does not exist
- `429` — Rate Limited - Too many requests
- `500` — Internal Server Error - Problem on Certifier's end

---

[API](https://skmtc.dev/certifier/apis/certifier-api.md) · [All operations](https://skmtc.dev/certifier/apis/certifier-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/certifier/certifier-api/revisions/a84fb47b7f6f/schema)