# Retrieve an entity definition by name

Retrieves an entity definition using its name, with options to include conditional members, load permissions, and exclude light entity definitions.

Endpoint: GET /api/entitydefinitions/{name}
Version: v1.0
Security: OAuth2.0

## Security:

  - `OAuth2.0` (unknown)
    oauth2

## Path parameters:

  - `name` (string, required)
    The definition name (string), for example, `M.Asset`.

## Query parameters:

  - `includeConditionalMembers` (boolean)
    Whether to include conditional members, for example, `true` or `false`.

  - `loadPermissions` (boolean)
    Whether to load permissions, for example, `true` or `false`.

  - `excludeLightDefinitions` (string)
    Whether to exclude light entity definitions, for example, `true` or `false`.

## Header parameters:

  - `If-Modified-Since` (string)
    The date and time after which to check for modifications, for example, `2023-01-01T00:00:00Z`.

## Response 200:

  - `200` (unknown)
    Successful operation

## Response 200 fields (application/json):

  - `id` (integer)

  - `name` (string)

  - `modified_on` (string)

  - `created_on` (string)

  - `display_template` (string)

  - `is_taxonomy_item_definition` (boolean)

  - `is_path_enabled_definition` (boolean)

  - `is_manual_sorting_allowed` (boolean)

  - `is_system_owned` (boolean)

  - `is_built_in` (boolean)

  - `is_light` (boolean)
    Gets a value indicating whether the entity definition is a light definition.

  - `labels` (object)

  - `member_groups` (array)

  - `member_groups.name` (string)

  - `member_groups.content_group` (string)

  - `member_groups.labels` (object)

  - `member_groups.members` (array)

  - `member_groups.members.name` (string)

  - `member_groups.members.labels` (object)

  - `member_groups.members.helptext` (object)

  - `member_groups.members.is_conditional` (boolean)

  - `member_groups.members.conditions` (array)

  - `member_groups.members.conditions.member` (string)

  - `member_groups.members.can_trigger_conditional_members` (boolean)

  - `member_groups.members.is_system_owned` (boolean)

  - `member_groups.members.is_secured` (boolean)

  - `member_groups.members.can_write` (boolean)

  - `member_groups.members.allow_updates` (boolean)

  - `member_groups.is_system_owned` (boolean)

  - `member_groups.is_conditional` (boolean)

  - `member_groups.conditions` (array)

  - `member_groups.is_secured` (boolean)

  - `member_groups.can_write` (boolean)

  - `entities` (object)
    Represents a link to a resource.

  - `entities.href` (string)
    Gets or sets the URI that points to the resource this link refers to.

  - `entities.filename_properties` (array)
    Gets or sets the URI that points to the resource this link refers to.

  - `entities.title` (string)
    Gets or sets the title that describes this link.

  - `entities.templated` (boolean)
    Gets or sets a value indicating whether the contained URI is a template.

  - `permissions` (array)
    All available permissions for the entity definition

## Response 400:

  - `400` (unknown)
    Request is not valid (for example, invalid parameters)

## Response 401:

  - `401` (unknown)
    Unauthorized request or invalid access token

## Response 404:

  - `404` (unknown)
    Entity definition not found or user not authorized