Credentials

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

get/v1/credential-schemas

Response

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

Example response

{
  "items": [
    {
      "uuid": "3a1f9c20-8d4e-4b1a-9f2c-7e6d5a4b3c2d",
      "name": "Loyalty Membership",
      "version": "1.0",
      "vct": "https://acme-air.didit.me/credentials/loyalty-membership",
      "format": "sd_jwt_vc",
      "attributes": [
        {
          "name": "given_name",
          "type": "string",
          "sd": true
        }
      ],
      "revocable": true,
      "branding": {
        "background_color": "#2567FF",
        "text_color": "#FFFFFF",
        "logo_uri": "https://acme-air.didit.me/logo.png"
      },
      "created_at": "2026-06-30T12:00:00+00:00"
    }
  ]
}

Changes