> ## Documentation Index
> Fetch the complete documentation index at: https://docs.didx.co.za/llms.txt
> Use this file to discover all available pages before exploring further.

# Browse credential presets

> Find the credential preset that matches what you want to issue.

## List credential presets

Every preset published on the platform is available to you, with no setup and no permissions to request. Listing returns the current catalogue; pick the one that matches what you want to issue.

The API exposes a separate listing per credential format. Use the one for the format you're after, or the generic listing if you want everything in one call:

* `GET /presets/credentials/sd-jwt` — SD-JWT presets only
* `GET /presets/credentials/mdoc` — mDoc presets only
* `GET /presets/credentials` — both formats together

```bash theme={null}
curl -X GET "https://test.didxtech.com/me-creds/api/v1/presets/credentials/sd-jwt" \
  -H "Authorization: Bearer <access_token>"
```

A trimmed example entry:

```json theme={null}
{
  "credentialFormat": "sd-jwt",
  "id": "didx:basic-identity",
  "author": "didx",
  "code": "basic-identity",
  "templateName": "Basic Identity Credential",
  "templateType": "https://didx.co.za/vct/didx/basic-identity",
  "templateDescription": "Standard basic identity credential",
  "templateAttributes": {
    "firstName": {
      "type": "string",
      "name": "First Name",
      "required": true,
      "alwaysDisclosed": false
    },
    "lastName": {
      "type": "string",
      "name": "Last Name",
      "required": true,
      "alwaysDisclosed": false
    }
  },
  "issuerConfig": { "signer": "did:web" }
}
```

## What to look at

| Field                                  | What it tells you                                                                 |
| -------------------------------------- | --------------------------------------------------------------------------------- |
| `id`                                   | Pass this as `presetId` when issuing                                              |
| `author`                               | The publisher's tenant alias (e.g. `didx`)                                        |
| `templateName`, `templateDescription`  | Human-readable summary                                                            |
| `credentialFormat`                     | `sd-jwt` or `mdoc`. Determines which wallets and verifiers can use the credential |
| `templateAttributes`                   | The keys you supply under `attributes` when issuing                               |
| `templateAttributes.*.required`        | Whether you must supply that key                                                  |
| `templateAttributes.*.alwaysDisclosed` | If `true`, the value is shared whenever the credential is presented               |

## Inspect a single preset

When you've found a candidate, fetch it directly. The same format-split applies — `GET /presets/credentials/sd-jwt/:id` for SD-JWT, `GET /presets/credentials/mdoc/:id` for mDoc, or `GET /presets/credentials/:id` for the generic lookup:

```bash theme={null}
curl -X GET "https://test.didxtech.com/me-creds/api/v1/presets/credentials/sd-jwt/didx:basic-identity" \
  -H "Authorization: Bearer <access_token>"
```

## What if nothing fits?

* Publish your own: [Create an SD-JWT credential preset](/products/didx-me/guides/issuers/create-sd-jwt-credential-preset) or [Create an mDoc credential preset](/products/didx-me/guides/issuers/create-mdoc-credential-preset).
* Or define a one-off: [Custom credential template](/products/didx-me/guides/issuers/create-credential-template).