---
title: "API: listCredentialsCounts"
slug: "api-listcredentialscounts"
updated: 2025-09-22T20:22:36Z
published: 2025-09-22T20:22:36Z
canonical: "support.smarteru.com/api-listcredentialscounts"
---

> ## Documentation Index
> Fetch the complete documentation index at: https://support.smarteru.com/llms.txt
> Use this file to discover all available pages before exploring further.

# API: listCredentialsCounts

## Description

The listCredentialsCounts method retrieves the count of users who are assigned the action, and the count of users who are assigned the action by status.

## Who Has Access

The following users have access to the listCredentialsCounts method:

- Users with the [Group Manager](/v1/docs/group-permission-group-manager-gm) or [View Learner Results](/v1/docs/group-permission-view-learner-results-vlr) group permission.
- [Supervisors](/v1/docs/adding-and-removing-supervisors), if the account's [**Supervisor Access** setting's](https://support.smarteru.com/docs/supervisor-access#report-on-supervisees) *Report on Supervisees* option is checked.
- [Administrators and owners](https://support.smarteru.com/v1/docs/user-profile-information#access-level).

## API Call XML Package

```markup
<SmarterU>
   <AccountAPI><![CDATA[]]></AccountAPI>
   <UserAPI><![CDATA[]]></UserAPI>
   <Method>listCredentialsCounts</Method>
   <Parameters>
      <Credential>
         <Filters>
            <Credentials>
               <CredentialIdentifier>
                  <Name></Name>
                     - OR -
                  <ID></ID>
               </CredentialIdentifier>
            </Credentials>
         </Filters>
      </Credential>
   </Parameters>
</SmarterU>
```

## Credential Tag Group

The Credential tag group is a container for the action filters.

```markup
<Credential>
   <Filters>
      <Credentials>
         <CredentialIdentifier>
            <Name></Name>
               - OR -
            <ID></ID>
         </CredentialIdentifier>
      </Credentials>
   </Filters>
</Credential>
```

The Credential tag includes the following.

### Filters

A container for the action filters. Refer to [Filters Tag Group](/v1/docs/api-listcredentialcounts#filters-tag-group).

## Filters Tag Group

The Filters tag group is a container for the action filters.

```markup
<Filters>
   <Credentials>
      <CredentialIdentifier>
         <Name></Name>
            - OR -
         <ID></ID>
      </CredentialIdentifier>
   </Credentials>
</Filters>
```

The Filters tag contains the following.

### Credentials

A container for the actions to include. Each action is contained in a CredentialIdentifier tag and contains the following.

| Tag | Description |
| --- | --- |
| **Name** | The [action's name](https://support.smarteru.com/docs/action-main#name). This tag is mutually exclusive with the ID tag. This is the ID returned by the [listCredentials](/v1/docs/api-listcredentials) method. |
| **ID** | The action's system-generated identifier. This tag is mutually exclusive with the Name tag. |

## API Response XML Package

The [API response XML package](/v1/docs/api-response-xml-package) will always include a Result, Info, and [Errors](/v1/docs/api-listcredentialcounts#error-codes) tag.

```markup
<SmarterU>
   <Result>Success</Result>
   <Info>
      <Credentials>
         <Credential>
            <Name><![CDATA[]]></Name>
            <CredentialID></CredentialID>
            <Actions>
               <Learners></Learners>
               <Accepted></Accepted>
               <Review></Review>
               <Pending></Pending>
            </Actions>
         </Credential>
      </Credentials>
   </Info>

   <Errors>
      <ErrorID></ErrorID>
      <ErrorMessage></ErrorMessage>
   </Errors>
</SmarterU>
```

The Credentials tag is a container for the actions returned by the listCredentialsCounts method. Each action is contained in a Credential tag and may contain the following.

### Name

The [action's name](https://support.smarteru.com/docs/action-main#name).

### CredentialID

The action's system-generated identifier.

### Actions

A container for the action's counts. The tag contains the following.

| Tag | Description |
| --- | --- |
| **Learners** | The number of users who are assigned the action. |
| **Accepted** | The number of users who are assigned the action and have had the action confirmed |
| **Review** | The number of users assigned the action who are awaiting activity from another user. |
| **Pending** | The number of users assigned the action that requires activity from the user. |

### Example API Response XML Package

Below is an example of an API response XML package.

```markup
<SmarterU>
   <Result>Success</Result>
   <Info>
      <Credentials>
         <Credential>
            <Name><![CDATA[Driver's license]]></Name>
            <CredentialID>6682</CredentialID>
            <Actions>
               <Learners>36</Learners>
               <Accepted>20</Accepted>
               <Review>10</Review>
               <Pending>6</Pending>
            </Actions>
         </Credential>
      </Credentials>
   </Info>

   <Errors>
   </Errors>
</SmarterU>
```

## Error Codes

| Error Code | Message |
| --- | --- |
| LCC:01 | The filters provided is invalid. |
| LCC:02 | The credentials provided is invalid. |
| LCC:03 | The name provided is invalid. |
| LCC:04 | The ID provided is invalid. |
| LCC:05 | The required permissions are not met to call the listCredentialsCounts method. |

## Related

- [Actions](/actions.md)
- [API: createCredential](/api-createcredential.md)
- [API: getCredential](/api-getcredential.md)
- [API: listCredentials](/api-listcredentials.md)
- [API: listUsersCounts](/api-listuserscounts.md)
- [API: updateCredential](/api-updatecredential.md)