# Read a role

Returns one role: its name, its code, what it is allowed to do, and any limits on
the records it may act on.
`object.permissions` is narrowed to what the account itself has available, so the
same role read from two accounts can come back with different keys. The example
below shows a handful of them rather than the whole set.

Endpoint: GET /api/v2/account/role/{id}
Version: 2.0.0
Security: default

## Path parameters:

  - `id` (integer, required)
    The ID of the role.

## Header parameters:

  - `Rosterfy-Platform` (string)

## Response 200 fields (application/json):

  - `object` (object)

  - `object.id` (integer)

  - `object.name` (string)

  - `object.code` (string)

  - `object.permissions` (object)

  - `object.permissions.account` (boolean)

  - `object.permissions.account:read` (boolean)

  - `object.permissions.account:update` (boolean)

  - `object.permissions.event` (boolean)

  - `object.permissions.event:read` (boolean)

  - `object.permissions.event:create` (boolean)

  - `object.permissions.event:update` (boolean)

  - `object.permissions.user` (boolean)

  - `object.permissions.user:read` (boolean)

  - `object.permissions.user:update` (boolean)

  - `object.permissions.report` (boolean)

  - `object.permissions.report:read` (boolean)

  - `object.horizontal` (string | null)

  - `object.prefill` (string | null)

  - `object.is_system` (integer)

  - `object.is_lite_admin` (integer)

  - `object.is_simple_attribute_selection` (integer)

  - `object.is_restricted` (integer)

  - `object.is_inheritable` (integer)

  - `object.access_required_modules` (string | null)

  - `object.options` (string | null)

  - `object.created_at` (string)

  - `object.updated_at` (string)

  - `object.user_dashboard_id` (string | null)

  - `nice` (object)

  - `nice.rrn` (string)

  - `relations` (array)

  - `permissions` (object)

  - `permissions.read` (boolean)

  - `permissions.update` (boolean)

  - `permissions.delete` (boolean)

  - `permissions.update_message` (string)

  - `permissions.copy` (boolean)