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

# List credential schemas

`GET /v1/credential-schemas`

List credential schemas for your tenant. Each schema defines a VCT (Verifiable Credential Type), credential format, attributes, revocability, status, and version lineage. Use this before you create templates or issue credentials.

## Response `200`

Array of credential schemas. Each array element contains these fields.

- object[]
  - `attributes` object[] — Claim attributes that make up the credential.
    - `name` string — Human-readable schema name.
    - `sd` boolean — Whether the claim supports selective disclosure.
  - `branding` object — Wallet branding object returned with the schema. The captured examples are empty objects.
  - `created_at` string, date-time — Timestamp when the schema was created.
  - `format` string — Credential format. The captured value is `sd_jwt_vc`, the SD-JWT VC (Selective-Disclosure JWT Verifiable Credential) format.
  - `name` string — Human-readable schema name.
  - `revocable` boolean — Whether issued credentials from this schema can be revoked.
  - `status` string — Lifecycle status of this schema version.
  - `supersedes` string, uuid, nullable — Schema UUID that this version supersedes. Null means this is the first version.
  - `uuid` string, uuid — Unique identifier of the credential schema. You use it to fetch the schema or create templates.
  - `vct` string — VCT (Verifiable Credential Type) value embedded in credentials issued from this schema.
  - `version` string — Schema version string.

---

[API](https://skmtc.net/didit-protocol/apis/didit-credentials-api.md) · [All operations](https://skmtc.net/didit-protocol/apis/didit-credentials-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/didit-protocol/didit-credentials-api/versions/e4eddba66557/schema)