---
editLink: false
lastUpdated: false
---

[@salesforce/b2c-tooling-sdk](../../../modules.md) / [operations/bm-roles](../index.md) / getBmRole

# Function: getBmRole()

> **getBmRole**(`instance`, `roleId`, `options`): `Promise`\<\{ \}\>

Defined in: [packages/b2c-tooling-sdk/src/operations/bm-roles/roles.ts:91](https://github.com/SalesforceCommerceCloud/b2c-developer-tooling/blob/e7c16f1ae423da0aa47b3e10be88f9770b53619b/packages/b2c-tooling-sdk/src/operations/bm-roles/roles.ts#L91)

Gets details of a specific access role.

## Parameters

### instance

[`B2CInstance`](../../../instance/classes/B2CInstance.md)

B2C instance to query

### roleId

`string`

Role ID (e.g. "Administrator")

### options

[`GetBmRoleOptions`](../interfaces/GetBmRoleOptions.md) = `{}`

Expand options

## Returns

`Promise`\<\{ \}\>

Role details

## Example

```typescript
const role = await getBmRole(instance, 'Administrator', { expand: ['users'] });
console.log(role.id, role.user_count);
```