---
title: "List Credentials"
description: "Retrieve all credentials stored in a specific wallet. The response includes the full credential document, parsed content, and metadata such as format and date added."
stack: "Community Stack (open source) — version 0.21.0"
stack_version: "0.21.0"
stack_comparison: https://docs.walt.id/community-vs-enterprise.md
canonical_url: https://docs.walt.id/community-stack/wallet/credential-management/list-credentials
generated: 2026-07-20
---
# List Credentials

Retrieve all credentials stored in a specific wallet. The response includes the full credential document,
parsed content, and metadata such as format and date added.

## List Credentials

**Option: CURL**

**Endpoint:** `GET /wallet-api/wallet/{walletId}/credentials` | [API Reference](https://wallet.demo.walt.id/swagger/index.html#/WalletCredentials/get_wallet_api_wallet__wallet__credentials)

##### Example Request

```bash
curl -X 'GET' \
  'http://0.0.0.0:7001/wallet-api/wallet/{walletId}/credentials' \
  -H 'accept: application/json' \
  -H 'Authorization: Bearer {token}'
```

**Path Parameters**

- `walletId`: _String_ - The ID of the wallet to list credentials from. See [Accounts & Wallets](https://docs.walt.id/community-stack/wallet/accounts-wallets.md#retrieve-wallet-id) for how to retrieve it.

**Query Parameters**

- `showDeleted`: _Boolean (optional)_ - Controls which credentials are returned based on deletion status. `true` returns only soft-deleted credentials. `false` returns only active (non-deleted) credentials. If omitted, all credentials are returned regardless of deletion status.
- `showPending`: _Boolean (optional)_ - Controls which credentials are returned based on pending status. `true` returns only pending credentials. `false` returns only non-pending credentials. If omitted, all credentials are returned regardless of pending status.
- `category`: _String (optional, repeatable)_ - Filter by category name. Repeat the parameter to match multiple categories (e.g. `?category=work&category=education`). Passing an empty value (`?category=`) returns credentials that have **no category assigned**. If omitted entirely, credentials from all categories are returned.
- `descending`: _Boolean (optional)_ - Set to `true` to sort in descending order. Defaults to `false`.

**Header Parameters**

- `Authorization`: _String_ - Bearer token obtained from the [login endpoint](https://docs.walt.id/community-stack/wallet/authentication/email-password-auth.md#login). Format: `Bearer {token}`.

---

##### Example Response

The API returns a list of credential objects stored in the wallet. Each object includes the raw credential document,
the parsed credential, and metadata.

```json
[
  {
    "wallet": "6006b6f4-e651-46db-b6ae-e7bd6e9c40f2",
    "id": "urn:uuid:c2f7e988-a4cb-48c2-bbf6-ed97f6010abe",
    "document": "eyJraWQiOiJkaWQ6...",
    "disclosures": "",
    "addedOn": "2026-04-16T15:08:01.604768543Z",
    "pending": false,
    "format": "jwt_vc_json",
    "parsedDocument": {
      "@context": [
        "https://www.w3.org/2018/credentials/v1"
      ],
      "id": "urn:uuid:c2f7e988-a4cb-48c2-bbf6-ed97f6010abe",
      "type": ["VerifiableCredential", "UniversityDegree"],
      "issuer": {
        "id": "did:jwk:eyJrdH..."
      },
      "issuanceDate": "2026-04-16T15:08:01.573384105Z",
      "credentialSubject": {
        "degree": {
          "type": "BachelorDegree",
          "name": "Bachelor of Science and Arts"
        }
      }
    }
  }
]
```

The `id` field of each object (e.g. `urn:uuid:c2f7e988-a4cb-48c2-bbf6-ed97f6010abe`) is the credential ID
used in other operations such as [deleting a credential](https://docs.walt.id/community-stack/wallet/credential-management/delete-credential.md).