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

# List credential schemas

`GET /v1/credential-schemas`

List every credential schema defined for the authenticated tenant, newest first. A credential schema declares the verifiable-credential type (vct), the wire format, the claim attributes (with their selective-disclosure flags), whether issued credentials can be revoked, and optional wallet branding. Use it to discover the schemas available before creating a template or issuing a credential. Scoped to the tenant derived from the API key, so schemas belonging to other tenants are never returned. Requires Authorization: Bearer <tenant API key>.

## Response `200`

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

- object
  - `items` object[] — The credential schemas owned by this tenant. Each item is a full schema object.
    - `uuid` string, uuid — Unique identifier of the credential schema. Reference this when creating a credential template.
    - `name` string — Human-readable name of the schema. Unique per tenant together with version.
    - `version` string — Schema version string. Unique per tenant together with name. Defaults to "1.0".
    - `vct` string — Verifiable Credential Type identifier embedded in every issued credential of this schema. Wallets and verifiers match on this value to recognise the credential.
    - `format` 'sd_jwt_vc' | 'mdoc' | 'w3c' — Credential wire format. `sd_jwt_vc` is the IETF SD-JWT VC format (the default); `mdoc` is ISO/IEC 18013-5 mdoc; `w3c` is W3C Verifiable Credentials 2.0.
    - `attributes` object[] — Ordered list of the claim attributes that make up this credential. Each attribute declares its claim name, value type, and whether it is selectively disclosable.
      - `name` string — Claim name as it appears in the issued credential payload.
      - `type` string — Logical data type of the claim value (e.g. string, number, boolean, date).
      - `sd` boolean — Selective-disclosure flag. When true the claim is individually disclosable by the holder (hidden behind a salted digest in the SD-JWT) so the holder can choose whether to reveal it at presentation time. When false the claim is always disclosed. Defaults to true.
    - `revocable` boolean — Whether credentials issued under this schema can be revoked or suspended via a status list. Immutable after the schema is created.
    - `branding` object — Optional free-form wallet branding object (e.g. background color, text color, logo URI) used by holder wallets to render the credential. Defaults to an empty object.
    - `created_at` string, date-time — ISO 8601 timestamp when the schema 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-schemas/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)