---
title: "List credential templates"
method: GET
path: "/v1/credential-templates"
tags: ["Credentials"]
---

# List credential templates

`GET /v1/credential-templates`

List every credential template defined for the authenticated tenant, newest first. A credential template binds a credential schema to a reusable issuance profile: a name and a validity window. Issuing a credential references a template by its uuid. Scoped to the tenant derived from the API key. Requires Authorization: Bearer <tenant API key>.

## Response `200`

Array of the tenant's credential templates, ordered by creation time descending.

- object
  - `items` object[] — The credential templates owned by this tenant. Each item is a full template object.
    - `uuid` string, uuid — Unique identifier of the credential template. Pass this as `template_id` when issuing a credential.
    - `schema` string, uuid — UUID of the credential schema this template is bound to. The schema determines the vct, format, and claim attributes of issued credentials.
    - `name` string — Human-readable name of the template.
    - `validity_seconds` integer — Lifetime, in seconds, applied to credentials issued from this template; it sets each credential's expires_at to issuance time plus this many seconds. Defaults to 31536000 (365 days).
    - `created_at` string, date-time — ISO 8601 timestamp when the template was created.

## Changes

- **2026-06-30** `1ee4908e9af4` — 1 info
  - added the media type `application/json` for the response with the status `200`

[Change history](https://skmtc.dev/didit-protocol/apis/didit-credentials-api/changes/v1/credential-templates/get.md)

---

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