= group()
:description: Returns the attributes of a single group as an ECMGroup object (mng.GetGroupAttributes). Contains internal name, display name, and description.
:keywords: group, mng.GetGroupAttributes, ECMGroup, internal name, display name
:page-tags: api, security

Returns the attributes of a single group by name.

== Signature

[tabs]
====
Sync::
+
[source,python]
----
ecm.security.group(name: str) -> ECMGroup | None
----

Async::
+
[source,python]
----
await ecm.security.group(name: str) -> ECMGroup | None
----
====

== Parameters

[cols="1,1,3"]
|===
|Parameter |Default |Description

|`name`
|—
|Name of the group.
|===

== Return value

`ECMGroup` instance, or `None` if the group does not exist.

For `ECMGroup` fields — see xref:api/security/groups.adoc[groups()].

== Examples

=== Load a single group

[tabs]
====
Sync::
+
[source,python]
----
group = ecm.security.group("Administrators")
if group:
    print(group.guid, group.description)
else:
    print("Group not found")
----

Async::
+
[source,python]
----
group = await ecm.security.group("Administrators")
if group:
    print(group.guid, group.description)
----
====

== See also

* xref:api/security/groups.adoc[groups()] — Retrieve all groups
* xref:api/security/group_members.adoc[group_members()] — Members of a group
