---
title: "Get Permission Map By Role"
method: GET
path: "/api/v1/admin/openbb/entities/{entity_uuid}/permission-map/{role}"
tags: ["Admin APIs", "openbb-entities"]
---

# Get Permission Map By Role

`GET /api/v1/admin/openbb/entities/{entity_uuid}/permission-map/{role}`

Get permission map for an entity by role name.

Args:
    entity_uuid: UUID of the entity.
    role: Role name ('admin' or 'user', case-insensitive).

Returns:
    Permission map with UUID, name, and entity UUID.

## Path parameters

- `entity_uuid` string, required
- `role` string, required

## Response `200`

Successful Response

- OpenBBPermissionMapRead — Schema for reading a permission map.
  - `uuid` string, required — Permission map UUID
  - `name` string, required — Role name (e.g., 'Admin' or 'User')
  - `entity_uuid` string, required — Entity UUID this permission map belongs to

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/carbonarc/apis/carbon-arc-client-admin-api.md) · [All operations](https://skmtc.net/carbonarc/apis/carbon-arc-client-admin-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/carbonarc/carbon-arc-client-admin-api/revisions/a8ca30023371/schema)