# role_lookup

> Get full details about a specific user role by its key.

<!-- Source: https://docs.actuallycare.com/tools/verticals/role_lookup -->

Get full details about a specific user role by its key. Returns the role's vertical mapping, scope level, description, and whether it allows login. Use this to understand what a specific role key means and what vertical/authorization tier it belongs to. Works for both active and legacy (deprecated) roles.

## Parameters

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `role_key` | string | Yes | The role key to look up (e.g., "broker", "plumber", "home_inspector", "transaction_coordinator") |

## Example prompts

- "What exactly does the transaction coordinator role allow, and what scope level is it?"
- "Is the plumber role loginable, and what vertical is it mapped to?"

## Safety

**Read-only.** This tool never changes your data — it only looks things up. Safe to run anytime.