# credential.list()

[[Source]](https://github.com/ripple/simpleXRPL/blob/95b977b15f8950c5bc076b25165217869c0b06d3/src/verticals/credential.ts#L54)

List credentials an account holds (default) or issued.

## Signature


```ts
credential.list(
  params?: CredentialListParams,
): Promise<CredentialListResult>
```

## Parameters

| Parameter | Type | Required | Description |
|  --- | --- | --- | --- |
| `role` | `'holder' | 'issuer'` | No | Query as `holder` (default) or `issuer`. |
| `account` | `string` | No | The account whose credentials to list. Defaults to the primary signer's account. |


## Returns

Resolves to a `CredentialListResult`, where `credentials[i]` corresponds to `data[i]`:

| Field | Type | Description |
|  --- | --- | --- |
| `credentials` | `readonly CredentialRef[]` | The identifier of each credential (`credType`, `issuer`, `holder`). |
| `data` | `readonly CredentialData[]` | The shaped credentials. See [credential.retrieve](/docs/simplexrpl/references/verticals/credential/retrieve#credentialdata) for `CredentialData`. |


## Underlying XRPL request

Read-only — no signer is required and nothing is submitted. Queries the ledger with [account_objects](https://xrpl.org/docs/references/http-websocket-apis/public-api-methods/account-methods/account_objects).

## Example


```ts
const { data } = await client.credential.list({ role: 'holder' })

for (const cred of data) {
  console.log(cred.credType, cred.accepted)
}
```