#List Credentials

Endpoint: GET /wallet-api/wallet/{walletId}/credentials | API Reference

#Example Request

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

[
  {
    "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.